вхідних повідомлень (зворотні дзвінки)
Коли користувачі надсилають вхідне повідомлення на ваш бот Viber або інші налаштовані канали, SMSBAT пересилає ці повідомлення на ваш сервер через Webhook (Callback).
Формат вебхука
Зворотні виклики надсилаються на вашу налаштовану URL-адресу Webhook через запит HTTP POST із корисним навантаженням JSON.
Приклад тіла запиту
{
"idUuid": "123e4567-e89b-12d3-a456-426614174000",
"alphaName": "ViberBotName",
"phoneNumber": "380936670003",
"text": "Hello, I need help with my order",
"dt": "2025-01-20T14:30:00.000Z"
}
Параметри
| Поле | Тип | Опис |
|---|---|---|
idUuid |
рядок | Унікальний ідентифікатор для вхідного повідомлення |
alphaName |
рядок | Назва вашого бренду/бота, який отримав повідомлення |
телефонний номер |
рядок | Номер телефону відправника |
текст |
рядок | Текстовий вміст вхідного повідомлення |
dt |
датачас | Позначка часу отримання повідомлення |
Конфігурація
Щоб почати отримувати вхідні повідомлення:
1. Надайте свою URL-адресу Webhook (потрібен HTTPS) менеджеру облікового запису SMSBAT або налаштуйте її на інформаційній панелі.
2. Ваша кінцева точка має приймати запити POST із Content-Type: application/json.
3. Ваш сервер має відповісти 200 OK після успішного отримання корисного навантаження.
Примітка: якщо ваш сервер не відповідає «200 OK» або минув час очікування, SMSBAT може спробувати повторити доставку на основі конфігурації вашого облікового запису.