Билдирүүлөрдү жөнөтүү

POST /v1/messages/send

Туташтырылган канал (байланыш линиясы) аркылуу тексттик же медиа билдирүү жөнөтүү.

URL

POST https://api.wazzabee.com/api-gateway/v1/messages/send

Аталыштар (headers)

Authorization: Bearer СИЗДИН_API_АЧКЫЧЫҢЫЗ
Content-Type: application/json

Суроо-талаптын денесинин параметрлери

* text же mediaUrl, экөөнүн жок дегенде бирин көрсөтүү керек.

Билдирүүнү ким жөнөттү

Демейки боюнча API аркылуу жөнөтүлгөн билдирүү чатта кыскача, атсыз «API аркылуу» деп кол коюлат. Эгер Сиздин CRM автордун ким экенин билсе, аны бериңиз: билдирүүнүн астында «API аркылуу · Назерке А.» деп көрүнөт, ал эми аты Сизге messages_outgoing вебхугунда кайтып келет. Ошентип чаттын тасмасынан кардарга менеджерлердин кайсынысы жооп бергени түшүнүктүү болот.

curl -X POST "https://api.wazzabee.com/api-gateway/v1/messages/send" \
  -H "Authorization: Bearer СИЗДИН_API_АЧКЫЧЫҢЫЗ" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "550e8400-e29b-41d4-a716-446655440000",
    "chatId": "77001234567",
    "text": "Саламатсызбы! Документтериңиз даяр.",
    "senderName": "Назерке Ахметова",
    "userId": "manager-42"
  }'

senderName жана userId ордуна author объектин берсеңиз болот, натыйжасы ошол эле:

{
  "channelId": "550e8400-e29b-41d4-a716-446655440000",
  "chatId": "77001234567",
  "text": "Саламатсызбы!",
  "author": { "id": "manager-42", "name": "Назерке Ахметова" }
}

Адам эмес жөнөткөн билдирүүлөрдү (роботтор, автожооптор, эскертмелер) "automated": true деп белгилеңиз: чатта алар менеджерлердин жоопторунан өзүнчө көрүнөт.

chatId форматы

Суроо-талаптардын мисалдары

Тексттик билдирүү

curl -X POST "https://api.wazzabee.com/api-gateway/v1/messages/send" \
  -H "Authorization: Bearer СИЗДИН_API_АЧКЫЧЫҢЫЗ" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "550e8400-e29b-41d4-a716-446655440000",
    "chatId": "77001234567",
    "text": "Саламатсызбы! №1234 буйрутмаңыз берүүгө даяр."
  }'

Кол жазмасы бар сүрөт

curl -X POST "https://api.wazzabee.com/api-gateway/v1/messages/send" \
  -H "Authorization: Bearer СИЗДИН_API_АЧКЫЧЫҢЫЗ" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "550e8400-e29b-41d4-a716-446655440000",
    "chatId": "77001234567",
    "mediaUrl": "https://example.com/photo.jpg",
    "mediaType": "photo",
    "caption": "Буйрутмаңыздын сүрөтү"
  }'

Документ

curl -X POST "https://api.wazzabee.com/api-gateway/v1/messages/send" \
  -H "Authorization: Bearer СИЗДИН_API_АЧКЫЧЫҢЫЗ" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "550e8400-e29b-41d4-a716-446655440000",
    "chatId": "77001234567",
    "mediaUrl": "https://example.com/invoice.pdf",
    "mediaType": "document"
  }'

Ийгиликтүү жооп (202 Accepted)

{
  "success": true,
  "queued": true,
  "queueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Сообщение поставлено в очередь на отправку"
}

Мүмкүн болгон каталар

Ичинде кантип иштейт

1. API авторизацияны жана каналга кирүү укугун текшерет
2. chatId (телефон же external_id) боюнча байланышты издейт. Табылбаса, жаңысын түзөт
3. Учурдагы диалогду (conversation) издейт. Табылбаса, жаңысын түзөт
4. Каналдын түрү боюнча жеткирүү ыкмасын аныктайт
5. Билдирүүнү message_queue кезегине коёт
6. Фондук процесс билдирүүнү кезектен алып, провайдер аркылуу жөнөтөт

Жаңы линиянын туташуусун текшерүү

Иштеп жаткан интеграциянын алдында кыска текшерүүдөн өтүңүз, ал бир мүнөт талап кылат жана алмашуу кайсы жерде токтоп калганын дароо көрсөтөт.

1. Линия API'де көрүнөт. GET /v1/channels сурап, керектүү линия жоопто бар экенин жана анын status мааниси active экенин текшериңиз. Сыноо мөөнөтү кабыл алууга жана жөнөтүүгө тоскоол болбойт.
2. Чыгуучу. Өзүңүздүн экинчи аккаунтуңузга POST /v1/messages/send жөнөтүңүз. Жоопто queueId келет: бул кезектеги тапшырманын номери, жеткирүүнүн ырастоосу эмес.
3. Жөнөтүүнүн натыйжасы. Вебхукта messages_status жана messages_outgoing окуяларына жазылыңыз: queueId боюнча жыйынтык дал ошол жерден келет. Билдирүү кабинеттин чаттарында да пайда болот.
4. Кирүүчү. Башка аккаунттан линияга жазыңыз. Билдирүү кабинеттин чаттарында пайда болуп, messages_incoming вебхугуна келиши керек. Эгер кабинетте бош болсо, маселе Сиздин кодуңузда эмес: колдоо кызматына жазып, жөнөткөн убакытты жана линиянын дарегин тиркеңиз.