Билдирүүлөрдүн тарыхы

GET /v1/messages

Каналдын билдирүүлөр тарыхын пагинация жана байланыш боюнча чыпкалоо менен алуу.

URL

GET https://api.wazzabee.com/api-gateway/v1/messages?channelId=...&chatId=...&limit=50&offset=0

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

Authorization: Bearer СИЗДИН_API_АЧКЫЧЫҢЫЗ

Суроо параметрлери (query string)

Параметр	Түрү	Милдеттүү	Демейки	Сүрөттөмө
channelId	string (UUID)	✅ Ооба	-	Каналдын ID'си. GET /v1/channels аркылуу алсаңыз болот
chatId	string	Жок	-	Байланыш боюнча чыпка: телефон номери же chat_id. Көрсөтүлбөсө, каналдын бардык билдирүүлөрү кайтарылат
limit	integer	Жок	50	Бир барактагы билдирүүлөрдүн саны. Эң көп: 200
offset	integer	Жок	0	Пагинация үчүн жылыш (канча билдирүүнү өткөрүп жиберүү керек)
campaignId	string	Жок	-	Ушул белгиси бар кампаниянын билдирүүлөрү гана (жөнөтүүдөгү campaignId)

Суроо мисалдары

Каналдын бардык билдирүүлөрү (акыркы 50)

curl -X GET "https://api.wazzabee.com/api-gateway/v1/messages?channelId=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer СИЗДИН_API_АЧКЫЧЫҢЫЗ"

Белгилүү бир байланыштын билдирүүлөрү

curl -X GET "https://api.wazzabee.com/api-gateway/v1/messages?channelId=550e8400-e29b-41d4-a716-446655440000&chatId=77001234567" \
  -H "Authorization: Bearer СИЗДИН_API_АЧКЫЧЫҢЫЗ"

Пагинация: 20 билдирүүдөн экинчи барак

curl -X GET "https://api.wazzabee.com/api-gateway/v1/messages?channelId=550e8400-e29b-41d4-a716-446655440000&limit=20&offset=20" \
  -H "Authorization: Bearer СИЗДИН_API_АЧКЫЧЫҢЫЗ"

Ийгиликтүү жооп (200 OK)

{
  "success": true,
  "messages": [
    {
      "id": "msg-uuid-1",
      "conversationId": "conv-uuid-1",
      "contactId": "contact-uuid-1",
      "direction": "incoming",
      "type": "text",
      "text": "Саламатсызбы, буйрутма качан даяр болот?",
      "mediaUrl": null,
      "createdAt": "2026-03-12T10:30:00.000Z"
    },
    {
      "id": "msg-uuid-2",
      "conversationId": "conv-uuid-1",
      "contactId": "contact-uuid-1",
      "direction": "outgoing",
      "type": "text",
      "text": "Кутман күн! Буйрутма эртең даяр болот.",
      "mediaUrl": null,
      "createdAt": "2026-03-12T10:31:00.000Z"
    }
  ],
  "total": 156,
  "limit": 50,
  "offset": 0
}

Жооптун талааларынын сүрөттөмөсү

Талаа	Түрү	Сүрөттөмө
messages	array	Жаңыдан эскиге карай иреттелген билдирүүлөрдүн массиви
messages[].id	string (UUID)	Билдирүүнүн уникалдуу ID'си
messages[].conversationId	string (UUID)	Билдирүү таандык болгон диалогдун ID'си
messages[].contactId	string (UUID)	Байланыштын ID'си
messages[].direction	string	incoming: кирүүчү, outgoing: чыгуучу
messages[].type	string	Билдирүүнүн түрү: text, image, video, document, audio
messages[].text	string | null	Билдирүүнүн тексти (тексти жок медиа үчүн null)
messages[].mediaUrl	string | null	Медиафайлдын URL'и (тексттик билдирүүлөр үчүн null)
messages[].createdAt	string (ISO 8601)	Билдирүү түзүлгөн күн жана убакыт
messages[].queueId	string | null	Чыгуучуларда гана: жөнөтүүгө берилген жооптогу queueId
messages[].campaignId	string | null	Чыгуучуларда гана: кампаниянын белгиси
messages[].status	string	Чыгуучуларда гана: pending, sent, delivered, read, failed
messages[].sentAt, deliveredAt, readAt	string | null	Чыгуучуларда гана: жөнөтүлгөн, жеткирилген жана окулган убакыт
messages[].error	object | null	Жеткирилбегендерде гана: {"code": 131026, "description": "..."}
total	integer	Билдирүүлөрдүн жалпы саны (пагинация үчүн)
limit	integer	Бир барактагы учурдагы чек
offset	integer	Учурдагы жылыш

Пагинация

Билдирүүлөр жаңыдан эскиге карай иреттелет (createdAt DESC боюнча). Барактап көрүү үчүн offset жана limit колдонуңуз.

chatId боюнча чыпкалоо

Эгер chatId көрсөтүлсө, API байланышты телефон номери же external_id боюнча издейт жана анын билдирүүлөрүн гана кайтарат. Мындай chatId менен байланыш табылбаса, бош массив кайтарылат (бул ката эмес).

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

Код	Ката	Себеби
400	channelId параметри милдеттүү	Query string'де channelId көрсөтүлгөн эмес
403	Канал бул интеграцияга байланган эмес	Канал бул API ачкычы үчүн уруксат берилгендердин катарына кирбейт
404	Канал табылган жок же кирүү укугу жок	Канал жок же башка колдонуучуга таандык