Інтеграція Meta & Instagram API

Довідка для створення програми Instagram на платформі SMSBAT ChatHub: автентифікація, Бесіди в Instagram Direct, коментарі до публікацій і барабанів, відповіді на історії, веб-хуки та опитування.

---

1. Базові URL-адреси

Призначення	URL
API чату + API мета	https://chatapi.smsbat.com
Swagger UI / OpenAPI	https://chatapi.smsbat.com/index.html · …/swagger/v1/swagger.json
REST API (організації, URL-адреси зворотного виклику)	https://restapi.smsbat.com
REST API Swagger	https://restapi.smsbat.com/swagger/v1/swagger.json
Веб-панель оператора	https://chat.smsbat.com

---

2. Автентифікація

Схема авторизації залежить від групи кінцевих точок. Їх змішування є найпоширенішою причиною 401.

Група	Заголовок
chatapi.smsbat.com/api/meta/* (дописи, коментарі)	X-Authorization-Key: <organization token>
chatapi.smsbat.com/api/chat/*, /api/company/*, /api/operator/*	Authorization: Bearer <JWT>
restapi.smsbat.com/*	X-Authorization-Key · Authorization: Bearer · Основна авторизація

Маркер організації для X-Authorization-Key видається на панелі в розділі Профіль. JWT компанії та оператора походять із /api/company/get-token та /api/operator/get-token.

2.1 Маркер компанії

POST https://chatapi.smsbat.com/api/company/get-token
Content-Type: application/json

{ "login": "company_login", "password": "company_password" }

200 OK повертає голий рядок маркера.

2.2 Організації

GET https://chatapi.smsbat.com/api/company/organization
Authorization: Bearer <company_token>

[ { "id": 24, "name": "My Instagram Store" } ]

2.3 Оператори в організації

GET https://chatapi.smsbat.com/api/operator?organizationId=24
Authorization: Bearer <company_token>

[
  {
    "id": 21,
    "name": "Jane Doe",
    "status": 0,
    "organization": { "id": 24, "name": "My Instagram Store" }
  }
]

Статуси оператора: 0 Активний, 1 Неактивний, 2 Видалений.

2.4 Додати/синхронізувати оператори

POST https://chatapi.smsbat.com/api/operator/synchronize
Authorization: Bearer <company_token>
Content-Type: application/json

[ { "organizationId": 24, "name": "John Operator" } ]

200 OK → [ { "id": 21, "status": 0, "name": "John Operator" } ]

2.5 Оператор JWT

POST https://chatapi.smsbat.com/api/operator/get-token
Authorization: Bearer <company_token>
Content-Type: application/json

{ "id": 21, "expiresAt": "2026-12-31T23:59:59.000Z" }

200 OK повертає JWT як рядок.

2.6 Перевірте маркер оператора

POST https://chatapi.smsbat.com/api/operator/validate-token
Authorization: Bearer <company_token>
Content-Type: application/json

"eyJhbGciOi..."

{
  "isValid": true,
  "operatorId": 21,
  "clientId": 0,
  "expiresAt": "2026-12-31T23:59:59.000Z",
  "error": null
}

Якщо недійсний: { "isValid": false, "error": "Invalid token" }.

2.7 Вставте панель чату оператора

<script type="module" id="operator-chat-panel-script"
  src="https://widget.smsbat.com/operator-chat-panel/widget-script.js"
  token="YOUR_OPERATOR_JWT_TOKEN"></script>

---

3. Посилання на панель чату

Зовнішня система (CRM, ERP, веб-сайт) може відкрити певну бесіду в https://chat.smsbat.com/. Оператор авторизується JWT, переданим як параметр запиту.

https://chat.smsbat.com/?chat_raw_id=<chat_id>&token=<jwt>
https://chat.smsbat.com/?phone=<phone>&token=<jwt>
https://chat.smsbat.com/?from=<bm_id>&phone=<phone>&token=<jwt>
https://chat.smsbat.com/?source=7&from=<bm_id>&phone=<phone>&token=<jwt>

Параметр	Опис
chat_raw_id	ID чату
phone	Номер телефону в міжнародному форматі
from	Ідентифікатор бренду/бізнес-облікового запису (bm_id)
source	Джерело чату — 7 для Instagram, див. §8.1
token	Дійсний, непрострочений оператор JWT з доступом до чатів

Недійсний JWT спрямовує відвідувача на екран входу в панель оператора.

---

4. Прямі розмови в Instagram

4.1 Список чатів

GET https://chatapi.smsbat.com/api/chat/chats?source=7&page=1&per_page=20
Authorization: Bearer <token>

Параметри запиту, усі необов’язкові:

Параметр	Тип	Опис
source	ChatSource	7 обмежує результати Instagram
entityId	int	Ідентифікатор бізнес-облікового запису. Застосовується лише разом із source
instagram_user_id	int	Ідентифікатор користувача Instagram у ChatHub
facebook_user_id	int	Ідентифікатор користувача Facebook у ChatHub
page / per_page	int	Пагінація, за замовчуванням 1 / 20
status	ChatStatus[]	Статус чату, повторюється
search	string	Пошук у довільному тексті (ім’я, телефон, …)
organizationId	int	ID організації
operatorId	int[]	Фільтрувати за призначеними операторами
date	string[]	Дві межі: ?date=…&date=…
isChain	bool	Повертати чати як ланцюжки, що містять повідомлення з попередніх чатів
isUnread, starMark, isOperator, isAIAgent	bool	Додаткові фільтри
phone, email, contactId, clientId, tagIds, rate, sortedBy	—	Інші фільтри

200 OK повертає GetChatsResponse:

{
  "total": 1,
  "newMessagesCount": 2,
  "items": [
    {
      "id": 1867,
      "theme": null,
      "messSource": 7,
      "chatStatus": 1,
      "countUnread": 2,
      "metaUserId": "1585775752382460",
      "instaAccount": { "id": 12, "name": "my_instagram_shop", "photo": "https://..." },
      "instagramUser": { "id": 123, "name": "marianna_cat", "photo": "https://..." },
      "operator": { "id": 21, "name": "Jane", "photo": "https://..." },
      "client": { "id": 55, "name": "Marianna", "photo": null },
      "textLastMess": "Hello! Is this product available?",
      "timeLastMess": "2026-08-13T10:15:00Z",
      "authorLastMessage": 1,
      "messageStatus": 6,
      "isMedia": false,
      "phone": null,
      "organizationId": 1,
      "createdAt": "2026-08-13T10:14:00Z",
      "isStarred": false,
      "isBlocked": false,
      "tags": []
    }
  ]
}

Поля, важливі для програми Instagram:

Поле	Значення
instaAccount	Бізнес-акаунт Instagram (магазин). id – значення фільтра entityId; name – це ім’я облікового запису з Meta
instagramUser	Клієнт. name – дескриптор Instagram, id – значення фільтра instagram_user_id
metaUserId	Ідентифікатор області дії клієнта на стороні Meta (рядок)
messSource	7 для Instagram
phone	Зазвичай null для Instagram — не використовуйте його як ключ

ChatDTO також містить olxUser, promUser, waba, rozetkaUser, facebookAccount, facebookUser, viberAccount, tgBot, tgUser, viberBot, viberBotUser, widget, media, isConnectedAI, isPromo, rate, rateComment, closedBy, draft, lang, starMark, contactId, contactName, block, isInStopList, stopList, isSmsFallbackEnabled та taggedMessages.

4.2 Повідомлення чату

GET https://chatapi.smsbat.com/api/chat/chats/1867/messages?isChain=false
Authorization: Bearer <token>

200 OK повертає масив ChatMessageDTO:

[
  {
    "id": 9928,
    "chatId": 1867,
    "message": "Hi! Do you have size M in stock?",
    "messageTranslation": null,
    "phone": null,
    "author": 1,
    "source": 7,
    "media": null,
    "replyTo": null,
    "status": 6,
    "date": "2026-08-13T10:14:00Z",
    "operator": null,
    "client": { "id": 123, "name": "marianna_cat", "photo": "https://..." },
    "messageType": 0,
    "isInternal": false,
    "isBroadcast": false,
    "starMark": false,
    "referralGuid": null,
    "postId": null,
    "isConnectedAI": false,
    "organizationId": 1,
    "countUnreadMessages": 0
  }
]

postId заповнюється, коли повідомлення стосується публікації в Instagram або історії — передайте його назад як id / postId до Meta API. media є ChatMediaDTO: { name, format, type, uri, raw, length, isUploaded }.

4.3 Надіслати повідомлення (JSON)

POST https://chatapi.smsbat.com/api/chat/1867/message
Authorization: Bearer <token>
Content-Type: application/json

Тіло — SendChatMessageDTO:

{
  "textMessage": "Hello! Yes, size M is available.",
  "author": 0,
  "isInternal": false,
  "replyToMessageId": 9928,
  "appGuid": "550e8400-e29b-41d4-a716-446655440000",
  "media": {
    "name": "item.jpg",
    "format": "image/jpeg",
    "dataBase64": "/9j/4AAQSkZJRg...",
    "type": 1
  }
}

Поле	Тип	Опис
textMessage	string?	Текст повідомлення. Може бути порожнім, якщо присутній media
author	AuthorMessage?	0 оператор, 1 клієнт
isInternal	bool?	true позначає внутрішню примітку, яка не доставлена ​​клієнту
replyToMessageId	int?	ID повідомлення, на яке відповідає
appGuid	uuid?	Реферальний GUID
media	MediaDTO?	{ name, format, dataBase64, thumbnail, duration, type }

200 OK → { "id": 9930, "messageStatus": 0 }

GUID направлення також може передаватися в шляху: POST /api/chat/{chatId}/{referralGuid}/message (також …/message/v1, …/message/v2).

4.4 Надіслати файл або відео (багаточастинний, v2)

POST https://chatapi.smsbat.com/api/chat/1867/message/v2
Authorization: Bearer <token>
Content-Type: multipart/form-data

Поле форми	Тип	Опис
TextMessage	string	Текст повідомлення
Author	int	0 оператор, 1 клієнт
IsInternal	bool	Внутрішня примітка
ReplyToMessageId	int	Повідомлення, на яке відповідає
AppGuid	uuid	Реферальний GUID
Media.File	binary	Сам файл
Media.Name	string	Ім’я файлу
Media.Format	string	Тип MIME (video/mp4, image/png, application/pdf)
Media.Type	MediaType	Див. §8.5
Media.DataBase64	string	Альтернатива Media.File
Media.Thumbnail	string	Кадр попереднього перегляду відео Base64
Media.Duration	double	Тривалість відео в секундах

curl -X POST "https://chatapi.smsbat.com/api/chat/1867/message/v2" \
  -H "Authorization: Bearer <token>" \
  -F "TextMessage=Here is the price list" \
  -F "Author=0" \
  -F "Media.Type=2" \
  -F "Media.File=@./price.pdf"

200 OK → { "id": 9931, "messageStatus": 0 }

4.5 Змінити статус чату

PUT https://chatapi.smsbat.com/api/chat/status
Authorization: Bearer <token>
Content-Type: application/json

{ "id": 1867, "status": 4 }

200 OK повторює оновлений об’єкт.

4.6 Оновлення статусів повідомлень

PUT https://chatapi.smsbat.com/api/chat/messages/status
Authorization: Bearer <token>
Content-Type: application/json

{ "status": 3, "messageIds": [9928, 9929] }

4.7 Видалити чат

DELETE https://chatapi.smsbat.com/api/chat/chats/1867
Authorization: Bearer <token>

---

5. Пости, ролики та історії

Основний шлях: https://chatapi.smsbat.com/api/meta Авторизація: X-Authorization-Key: <organization token>

5.1 Список дописів, роликів і історій

GET https://chatapi.smsbat.com/api/meta/posts?platform=instagram&mediaType=story&page=1&perPage=20
X-Authorization-Key: <token>

Параметр	Тип	Необхідно	Опис
page	int	ні	Сторінка, за замовчуванням 1
perPage	int	ні	Елементів на сторінці, за замовчуванням 20
id	int	ні	Фільтрувати за ідентифікатором внутрішньої публікації
platform	string	ні	instagram або facebook
mediaType	string	ні	post, reel або story. Усі типи, якщо опущено

# Every post
curl -H "X-Authorization-Key: <token>" \
  "https://chatapi.smsbat.com/api/meta/posts?page=1&perPage=10"

# Instagram only
curl -H "X-Authorization-Key: <token>" \
  "https://chatapi.smsbat.com/api/meta/posts?platform=instagram"

# A single post by ID
curl -H "X-Authorization-Key: <token>" \
  "https://chatapi.smsbat.com/api/meta/posts?id=42"

# Instagram Stories only
curl -H "X-Authorization-Key: <token>" \
  "https://chatapi.smsbat.com/api/meta/posts?platform=instagram&mediaType=story"

200 OK:

{
  "total": 42,
  "items": [
    {
      "id": 42,
      "metaId": "18113450675314072",
      "text": "Check out our new collection!",
      "imageUrl": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-1711-4aa8-b21d-f6dbf8f347ef",
      "platform": "instagram",
      "mediaType": "story",
      "createdAt": "2026-07-22T09:35:30Z",
      "story": {
        "id": 42,
        "metaId": "18113450675314072",
        "url": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-1711-4aa8-b21d-f6dbf8f347ef"
      }
    }
  ]
}

Поле	Опис
id	ID внутрішньої посади
metaId	Зовнішня публікація / Котушка / Ідентифікатор історії в мета
text	Підпис до повідомлення
imageUrl	URL-адреса медіа-проксі-сервера з непослідовним ключем MetaPost.Guid або null
platform	facebook або instagram
mediaType	post, reel або story
createdAt	Дата створення (дата платформи або дата бази даних)
story	Подаруйте лише за mediaType: "story"
story.id	Ідентифікатор внутрішньої історії; дорівнює post.id
story.metaId	Зовнішній ідентифікатор історії в мета
story.url	Стабільна URL-адреса проксі-сервера збережених носіїв історії; null, якщо медіа не вдалося зберегти

Пошта обслуговується двома маршрутами: GET /api/meta/post/media/{id:int} для зворотного зв’язку сумісність і GET /api/meta/post/media/{guid:guid}. Нові відповіді API та зворотні виклики завжди створюйте форму GUID.

5.2 Список коментарів

GET https://chatapi.smsbat.com/api/meta/comments?platform=instagram&postId=42&page=1&perPage=20
X-Authorization-Key: <token>

Параметр	Тип	Необхідно	Опис
page	int	ні	Сторінка, за замовчуванням 1
perPage	int	ні	Елементи на сторінці, за замовчуванням 20
postId	int	ні	Фільтрувати за ID повідомлення
parentCommentId	int	ні	Дочірні коментарі (відповіді) на даний коментар
platform	string	ні	facebook або instagram

200 OK:

{
  "total": 100,
  "items": [
    {
      "id": 5,
      "metaId": "179000000000005",
      "text": "What is the price?",
      "createdAt": "2026-04-15T10:30:00Z",
      "platform": "instagram",
      "replyStatus": null,
      "author": {
        "type": "meta_user",
        "name": "John Doe",
        "metaUserId": "1585775752382460"
      },
      "post": {
        "id": 1,
        "metaId": "18113450675314072",
        "text": null,
        "imageUrl": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-…",
        "createdAt": "2026-07-22T09:35:30Z",
        "mediaType": "story",
        "story": {
          "id": 1,
          "metaId": "18113450675314072",
          "url": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-…"
        }
      },
      "mediaUrl": "https://chatapi.smsbat.com/api/meta/comment/media/5",
      "replyTo": {
        "id": 3,
        "metaId": "179000000000003",
        "text": "Parent comment..."
      }
    }
  ]
}

Поле	Опис
id	ID внутрішнього коментаря
metaId	Зовнішній ідентифікатор у Мета. null за нашу відповідь, що очікує на розгляд, поки її не буде надіслано
text	Текст коментаря
createdAt	Дата створення
platform	facebook або instagram
replyStatus	null для вхідного коментаря користувача; "pending" / "sent" / "failure" за нашу відповідь
author.type	"meta_user" зовнішній користувач, "owner" власник сторінки
author.name	Ім’я автора
author.metaUserId	Ідентифікатор користувача з областю дії в мета; null для "owner"
post	Публікація, ролик або історія, до якої належить коментар
post.mediaType	post, reel або story
post.story	Посилання на історію { id, metaId, url }, лише історії
mediaUrl	До коментаря додається медіа, або null
replyTo	Батьківський коментар { id, metaId, text }; null на верхньому рівні

5.3 Відповідь на коментар

Поставте відповідь у чергу для доставки.

curl -X POST \
  -H "X-Authorization-Key: <token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "Thanks for the feedback!"}' \
  "https://chatapi.smsbat.com/api/meta/comments/5/reply"

Тіло запиту: { "text": "Reply text" }

202 Accepted повертає об’єкт коментаря — такої ж форми, як GET /api/meta/comments — з replyStatus: "pending" та metaId: null. Результат доставки надходить пізніше як a Зворотний виклик source: 13 (§6.4).

---

6. Вебхуки

SMSBAT надсилає POST запитів із application/json на вашу URL-адресу та очікує HTTP 200 назад.

6.1 Зареєструйте URL зворотного виклику

curl -X POST 'https://restapi.smsbat.com/organizations/callback_urls' \
  -H 'X-Authorization-Key: <token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://your-server.com/webhook",
    "source": 12,
    "headerName": "X-Webhook-Secret",
    "headerValue": "your-secret",
    "channelType": 7,
    "channelEntityId": 12
  }'

Поле	Тип	Опис
url	string	Ваша кінцева точка
source	SendingSourceCallback	Тип події, див. §8.2
headerName / headerValue	string	Довільний заголовок авторизації, який ми додаємо до запиту (необов’язково)
channelType	ChatSource	Канал. 7 для Instagram. Необов’язковий
channelEntityId	int	Конкретний бізнес-акаунт. Потрібен channelType

Без channelType URL-адреса отримує події з кожного каналу.

Решта операцій:

GET    https://restapi.smsbat.com/organizations/callback_urls?source=12
GET    https://restapi.smsbat.com/organizations/callback_urls/{id}
PUT    https://restapi.smsbat.com/organizations/callback_urls/{id}
DELETE https://restapi.smsbat.com/organizations/callback_urls/{id}

GET повертає:

[
  {
    "id": 101,
    "url": "https://your-server.com/webhook",
    "source": 12,
    "headerName": "X-Webhook-Secret",
    "headerValue": "your-secret",
    "createdAt": "2026-08-13T09:00:00Z",
    "channelType": 7,
    "channelEntityId": 12
  }
]

6.2 Нове повідомлення та відповідь на Instagram Story (source: 3, 11)

Відповідь користувача на Історію Instagram надходить як звичайне повідомлення в цих зворотних викликах, з додатковим блоком верхнього рівня Story:

{
  "ChatId": 123,
  "MessageId": 456,
  "MessageText": "😍",
  "Username": "Jane Smith",
  "UserId": 789,
  "MetaUserId": "1585775752382460",
  "ShopId": 12,
  "ShopName": "instagram shop name",
  "Author": 0,
  "type_messenger": 7,
  "Story": {
    "Id": 42,
    "MetaId": "18113450675314072",
    "Url": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-1711-4aa8-b21d-f6dbf8f347ef"
  }
}

Поле	Опис
ChatId / MessageId	Ідентифікатори чату та повідомлень
Author	0 користувач, 1 оператор
Username	Відображуване ім’я або дескриптор Instagram/Facebook
UserId	Внутрішній числовий ідентифікатор користувача в SMSBAT
MetaUserId	Охоплений ідентифікатор співрозмовника в Meta. У вихідному повідомленні оператора це все ще ідентифікує мета-користувача чату, а не оператора
ShopId	Внутрішній ідентифікатор бізнес-облікового запису Instagram / Facebook
ShopName	Назва бізнес-облікового запису, отримана від Meta під час підключення
MessageText	Текст повідомлення
MessageMedia	URL-адреса медіа, якщо повідомлення є медіа
type_messenger	Джерело, 7 для Instagram
operator_name	Ім’я оператора, коли Author = 1
Story	Показувати тільки у вхідній відповіді Story
Story.Id	Ідентифікатор внутрішньої історії (MetaPost) — можна використовувати безпосередньо як id / postId у Meta API
Story.MetaId	Зовнішній ідентифікатор історії в мета
Story.Url	Стабільна URL-адреса проксі-сервера збережених носіїв Story. Відсутній, коли медіа не вдалося зберегти — блок Story і повідомлення все ще доставляються

6.3 Новий коментар (source: 12)

Спрацьовує, коли користувач Meta коментує публікацію у Facebook або Instagram / Reel.

{
  "type": "new_comment",
  "platform": "instagram",
  "comment": {
    "id": 10,
    "metaId": "179000000000010",
    "parentCommentId": 5,
    "parentMetaId": "179000000000005",
    "parentCommentText": "The user's previous comment",
    "text": "Great product!",
    "createdAt": "2026-04-16T12:00:00Z",
    "author": {
      "type": "meta_user",
      "name": "Jane Smith",
      "metaUserId": "1585775752382460"
    }
  },
  "post": {
    "id": 1,
    "metaId": "123456789012345",
    "text": "Post description...",
    "imageUrl": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-…",
    "createdAt": "2026-04-10T12:00:00Z",
    "mediaType": "post"
  }
}

6.4 Статус відповіді на коментар (source: 13)

Спрацьовує після того, як ми намагаємось надіслати відповідь, незалежно від того, вдалось це чи не вдалося.

{
  "type": "comment_status",
  "platform": "instagram",
  "comment": {
    "id": 15,
    "metaId": "179000000000015",
    "parentCommentId": 10,
    "parentMetaId": "179000000000010",
    "parentCommentText": "Great product!",
    "text": "Thanks for the feedback!",
    "createdAt": "2026-04-16T12:05:00Z",
    "updatedAt": "2026-04-16T12:05:03Z",
    "replyStatus": "sent",
    "author": {
      "type": "owner",
      "name": "Support Agent"
    }
  },
  "post": {
    "id": 1,
    "metaId": "179999999999999",
    "text": "Reel description...",
    "imageUrl": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-…",
    "createdAt": "2026-07-22T09:35:30Z",
    "mediaType": "reel"
  }
}

6.5 Спільні поля зворотного виклику коментарів

Обидва зворотні виклики коментарів мають одну форму тіла і відрізняються лише на type.

Поле	Опис
type	"new_comment" або "comment_status"
platform	"facebook" або "instagram"
comment.id	ID внутрішнього коментаря
comment.metaId	Зовнішній ідентифікатор у мета; null для очікуваної відповіді перед її відправленням
comment.parentCommentId	ID батьківського коментаря. Відсутній для коментаря вищого рівня
comment.parentMetaId	Ідентифікатор зовнішнього батьківського коментаря. Відсутній на вищому рівні
comment.parentCommentText	Текст коментаря батьків. Відсутній на вищому рівні
comment.text	Текст коментаря
comment.createdAt	Дата створення
comment.updatedAt	Останнє оновлення. Відсутній, якщо коментар ніколи не редагувався
comment.replyStatus	"pending" / "sent" / "failure". Відсутній для вхідного коментаря користувача
comment.author.type	"meta_user" або "owner"
comment.author.name	Ім’я автора
comment.author.metaUserId	Ідентифікатор автора з областю дії в мета. Відсутній протягом "owner"
comment.mediaUrl	Коментуйте ЗМІ. Відсутній, коли немає
post.id	ID внутрішньої посади
post.metaId	Зовнішня публікація / Котушка / Ідентифікатор історії в мета
post.text	Текст публікації
post.imageUrl	Опублікуйте URL-адресу зображення або null
post.createdAt	Дата створення публікації
post.mediaType	У зворотних викликах коментарів лише post або reel

6.6 Новий чат (source: 7)

{ "ChatId": 12345, "Phone": "+380501234567", "chat.Source": 7 }

6.7 Зміна статусу повідомлень і чату (source: 6 / 5)

{ "name": "changed_message_status", "id": 9928, "status": 6 }
{ "name": "changed_chat_status",    "id": 1867, "status": 4 }

6.8 Повідомлення відредаговано або видалено (source: 9)

{ "messageId": 9930, "text": "Updated message text" }
{ "messageId": 9931, "delete": true }

6.9 Індикатор набору тексту (source: 8)

{ "chat_id": 1867, "event": "start_typing", "operator_name": "Iryna" }
{ "chat_id": 1867, "event": "end_typing" }

---

7. Опитування подій

Для середовищ, які не можуть приймати вхідний HTTP.

7.1 Отримання подій

GET https://chatapi.smsbat.com/api/chat/callback-events?page=1&perPage=20
Authorization: Bearer <token>

Параметр	Опис
organizationId	Додатково. Взято з лексеми, якщо опущено
page / perPage	Пагінація, за замовчуванням 1 / 20

{
  "page": 1,
  "perPage": 20,
  "total": 947,
  "items": [
    {
      "ChatId": 1867,
      "MessageId": 9928,
      "MessageText": "Hello there!",
      "MessageMedia": null,
      "Phone": null,
      "Username": "marianna_cat",
      "UserId": 123,
      "ShopId": 12,
      "ShopName": "instagram shop name",
      "Author": 1,
      "type_messenger": 7,
      "message_date": "2026-08-13T12:27:39.724Z",
      "timestamp": "2026-08-13T12:27:39.736Z",
      "event_guid": "ff60129e-c6e4-4876-9d90-badb430c0606",
      "organization_id": 1,
      "callback_type": "3"
    }
  ]
}

Кожна подія містить event_guid, timestamp, organization_id та callback_type — рядок, що відповідає значенням source у §8.2. Решта полів відповідають відповідним вебхук у §6.

7.2 Підтвердження оброблених подій

POST https://chatapi.smsbat.com/api/chat/callback-events/processed
Authorization: Bearer <token>
Content-Type: application/json

[ "ff60129e-c6e4-4876-9d90-badb430c0606" ]

200 OK → { "deleted": 1 }

Події, які вже видалено, просто не зараховуються до deleted. Замовлення та повторні спроби за вами відповідальність сторони.

7.3 Рекомендований цикл

1. Опитування GET /api/chat/callback-events за розкладом.
2. Обробка подій у вашому сервісі.
3. Надішліть оброблений список event_guid на /callback-events/processed.
4. Повторіть.

---

8. Посилання на Enum

8.1 ChatSource — канал (0–9)

Код	Канал
0	Viber
1	ViberBot
2	TelegramBot
3	Whatsapp
4	Віджет
5	Розетка
6	Facebook
7	Instagram
8	Випускний
9	Olx

8.2 SendingSourceCallback — тип події зворотного виклику (0–13)

Код	Подія
3	Chat — нове повідомлення в чаті, включаючи відповіді на історію
5	Статус чату змінено
6	Статус повідомлення змінено
7	Створено новий чат
8	Індикатор набору
9	Повідомлення оновлено або видалено
11	AnyChatMessage — будь-яке повідомлення чату
12	MetaNewComment — новий коментар в Instagram / Facebook
13	MetaCommentStatus — статус доставки нашої відповіді на коментар

Перелік охоплює 0–13; решта значень не потрібні для інтеграції з Instagram.

8,3 ChatStatus (0–4)

0 Нове, 1 Відкрито, 2 Очікування, 3 На паузі, 4 Закрито

8,4 MessageStatus (0–11)

Код	Ім’я
0	НОВИЙ
1	УСПІХ
2	ВІДХИЛЕНО
3	ПРОЧИТАТИ
4	НЕВІДОМО
5	ОБРОБКА
6	ДОСТАВЛЕНО
7	BLOCKED_BY_USER
8	USER_NOT_FOUND

Перелік охоплює 0–11. Значення 9, 10 і 11 існують в API, але ще не задокументовані — розглядайте їх як UNKNOWN.

8,5 MediaType (1–10)

1 Фото, 2 Файл, 3 Аудіо, 4 Відео, 5 Наклейка, 6 Наклейка Анімована, 7 StickerVideo, 8 Animation, 9 Voice, 10 VideoNote

8.6 AuthorMessage — автор в Chat API (0–4)

0 Оператор, 1 Клієнт, 2 Бот, 3 ViberAccount

Перелік охоплює 0–4; значення 4 не задокументовано. Зворотні виклики “нове повідомлення” використовують протилежне відображення — див. §6.2.

8,7 ChatMessageType (0–2)

0 Текст, 1 Фото, 2 Файл

8.8 Коментар replyStatus

null вхідний коментар користувача, "pending" наша відповідь у черзі, "sent" доставлено, Помилка доставки "failure".

---

Відкриті питання

Три пункти, де внутрішня специфікація та згенерований код Swagger розходяться. Один запит із реальним токеном розраховує їх усі; до того часу пишіть клієнту в захисті.

#	Питання	Специфікація	Чванство	Як перевірити
1	Заголовок авторизації для /api/meta/*	X-Authorization-Key	лише Bearer заявлено	curl -i -H "X-Authorization-Key: <token>" ".../api/meta/posts?perPage=1" — очікуйте 200, а не 401
2	Поле лічильника в метавідповідях	totalCount	total	Той самий запит — прочитати кореневий ключ JSON
3	author.type тип і reply код статусу	"meta_user" / "owner", 202 з корпусом	int [0,1], 200 без тіла	curl -i .../api/meta/comments?perPage=1 плюс тестова відповідь

Тимчасове керівництво:

• лічильник — читання total ?? totalCount;
• author.type — приймати як рядок, так і ціле число (0 ↔ meta_user, 1 ↔ owner, відображення потрібно підтвердити);
• reply — розглядати будь-який 2xx як успішний, не вимагати тіла, отримати кінцевий статус із зворотного виклику source: 13.

---

Примітки щодо впровадження

• Автентифікація залежить від групи кінцевих точок — /api/meta/* використовує X-Authorization-Key, чати та оператори використовують Bearer, restapi приймає будь-який.
• Позначення сторінок пишеться двома способами — per_page на /api/chat/chats, perPage на /api/meta/* і /api/chat/callback-events.
• Поля multipart/form-data мають регістр Pascal із крапковою нотацією (Media.File, Media.Type).
• Пульові поля пропускаються у зворотних викликах — відсутність ключа означає null.
• phone зазвичай це null в Instagram. Ідентифікуйте клієнта за номером instagramUser.id / metaUserId та магазин за instaAccount.id (значення фільтра entityId).
• Story.Id із зворотного виклику можна передати прямо назад як id / postId до Meta API.
• Перевірте expiresAt оператора JWT, перш ніж використовувати його в глибокому посиланні або віджеті.