⚙️ REST API аркылуу туташтыруу
API коннектор WazzaBee'ни сиздин каалаган системаңыз менен интеграциялоого мүмкүндүк берет: CRM, ERP, сайт, бот же мобилдик тиркеме. REST API аркылуу билдирүүлөрдү жөнөтүп жана кабыл алып, байланыштарды башкарып, вебхуктар аркылуу билдирмелерди ала аласыз.
🔌 Кантип туташтыруу керек
- «Коннекторлор» бөлүмүнө өтүңүз
- «API» карточкасын басыңыз
- «Туташтыруу» баскычын басыңыз
- Бир нече секунд күтө туруңуз: система интеграцияны автоматтык түрдө түзүп, API ачкычын жаратат
- ✅ «Интеграция туташтырылды» деген жазуу чыгат
- «Жөндөөлөргө өтүү» баскычын басыңыз
Кошумча эч кандай маалымат киргизүүнүн кереги жок: баары автоматтык түрдө түзүлөт!
🔑 API ачкычы
Туташкандан кийин сизге API ачкычы жеткиликтүү болот: суроо-талаптарды авторизациялоо үчүн уникалдуу токен.
Ачкычты кантип алуу керек
- API коннекторунун жөндөөлөрүнөн «API ачкычы» карточкасын табыңыз
- Ачкычты көрсөтүү үчүн 👁️ (көз) белгисин басыңыз
- «Көчүрүү» баскычын басыңыз, ачкыч алмашуу буферине көчүрүлөт
Маанилүү: API ачкычын эч кимге бербеңиз! Эгер ачкыч бөтөн колго түшүп калса, жаңысын түзүү үчүн «Жаңылоо» баскычын басыңыз. Эски ачкыч иштебей калат.
📡 Байланыш линияларын байлоо
API аркылуу кайсы мессенджерлер жеткиликтүү болорун тандаңыз:
- Жөндөөлөрдөн «Байланыш линиялары» карточкасын табыңыз
- Туташтырылган мессенджерлериңиздин тизмесин көрөсүз
- Ар биринде которгуч бар (күйгүзүү/өчүрүү)
- API аркылуу колдонгуңуз келген линияларды күйгүзүңүз
📚 API'ни кантип колдонуу керек
Бардык суроо-талаптар баш бөлүгүндө Bearer токенин колдонот:
Authorization: Bearer ВАШ_API_КЛЮЧЖеткиликтүү методдор
| Метод | URL | Сүрөттөмө |
|---|---|---|
| GET | /v1/account | Аккаунт тууралуу маалымат |
| GET | /v1/channels | Байланган линиялардын тизмеси |
| GET | /v1/contacts | Байланыштардын тизмеси |
| GET | /v1/conversations | Диалогдордун тизмеси |
| POST | /v1/messages/send | Билдирүү жөнөтүү |
| PATCH | /v1/webhooks | Вебхукту каттоо |
| DELETE | /v1/webhooks | Вебхукту өчүрүү |
Толук документация: API документациясы →
🔔 Вебхуктар: окуяларды алуу
Жаңы билдирүүлөр тууралуу билдирмелерди реалдуу убакытта алуу үчүн вебхуктарды жөндөңүз:
| Жазылуу | Эмне келет |
|---|---|
messages_incoming | Кардарлардан келген билдирүүлөр |
messages_outgoing | Чыгуучу билдирүүлөр (сиз жөнөткөн) |
contactsAndDealsCreation | Жаңы байланыштардын жана диалогдордун түзүлүшү |
⚠️ Башкаруу
- «Өчүрүү»: API ачкычы иштебей калат, бирок жөндөөлөр сакталат
- «Жок кылуу»: толугу менен жок кылуу (адегенде өчүрүү керек)
- «Ачкычты жаңылоо»: жаңы ачкыч түзүү (эскиси иштебей калат)
Интеграция боюнча жардам керекпи? Колдоо кызматына жазыңыз, жөндөп берүүгө жардам беребиз!