KiT Docs Portal
  1. Входящие сообщения от абонента
KiT Docs Portal
  • KiT Docs Portal
  • Личный кабинет
  • WhatsApp API
    • Типы сообщений
    • Форматирование в текстовых сообщениях
    • Форматы WhatsApp Media
    • Коды ошибок платформы WABA
    • Шаблонные сообщения
      • Категории шаблонов
      • Типы заголовков в шаблонных сообщениях
      • Тело шаблонного сообщения
      • Кнопки в шаблонных сообщениях
      • Общее описание запроса
      • Сообщение со всеми параметрами - заголовок изображение
      • Сообщение со всеми параметрами - заголовок текст
      • Сообщение изображение и текст
      • Сообщение изображение, текст и подпись сообщения
      • Сообщение изображение, текст и 2 кнопки - переход на сайт и позвонить
      • Сообщение изображение, текст и 3 кнопки быстрого ответа
      • Сообщение с кнопками содержащие динамическое дополнение к основному URL
      • Сообщение местоположение и текст
      • Сообщение динамиечский текст тело сообщения
      • Сообщение динамиечский текст тело сообщения и заголовка сообщения
      • Сообщение статичный текст
      • Получить имена всех шаблонов - gettemplate
    • Авторизационныe сообщения
      • Авторизационное сообщение
    • Чат сообщения
      • Сообщение текстовое
      • Сообщение с изображением
      • Сообщение аудиозапись
      • Сообщение с документом
      • Сообщение с видео
      • Сообщение со стикерам
      • Сообщение с списками
      • Сообщение с кнопками ответа
      • Сообщение с кнопкой перехода на URL
      • Сообщение с местоположением
      • Сообщение запрос местоположения
    • Входящие сообщения от абонента
      • Входящие сообщения от абонента
      • Текстовое входящее сообщение
        POST
      • Медиа (изображение, аудио, видео, документ, стикер) - входящее сообщение
        POST
      • Местоположение - входящее сообщение
        POST
      • Нажатие на кнопку быстрого ответа
        POST
      • Нажатие на кнопку из списка (из листа)
        POST
    • Установить WebHook - setwebhook
      POST
    • Статусы сообщений на WebHook
      POST
  • HTTP SMS API
    • sendMessage
      GET
    • getMessageByID
      GET
    • reporturl
      GET
  • JSON SMS API
    • send
      POST
    • sendBulk
      POST
    • reportByID
      GET
    • reportByExtraID
      GET
    • reportByBulkID
      GET
    • reportByPeriod
      GET
    • getSenders
      GET
    • notify_url
      GET
  • SOAP SMS API
    • sendMessage
    • sendBulkMessage
    • getInfoByID
    • getBulkInfoByID
    • getAbonents
    • getReport
    • getSenders
  • XML SMS API
    • sendMessage
    • sendBulkMessage
    • getInfoByID
  • MobiCheck SMS API. OTP/2FA
    • sendRequest
    • verifyPin
    • verifyRequest
  • SMPP SMS API
    • SMPP 3.4
  1. Входящие сообщения от абонента

Нажатие на кнопку быстрого ответа

POST
https://ВашWebhook

На ваш URL приходит JSON запрос следующего формата.#

CAUTION
Для получения статусов и входящих сообщений от абонента, Вам необходимо реализовать "приемщик" (webhook) на своей стороне, разместить на своем сервере и задать его методом SetWebhook
CHECK
"typeRequest": "inboxmsg"
"type": "quick_reply"

Request

Header Params
X-API-KEY
string 
required
Ваш X-API-KEY, который вы задали через "Установить WebHook - setwebhook"
Example:
123
Body Params application/json
typeRequest
string 
required
Тип запроса. Для входящих сообщений inboxmsg
Example:
inboxmsg
id
string 
required
ID входящего сообщения
Example:
00DDDAC9-9C05-4767-954E-F30D9E14F4F
receivedAt
string 
required
Дата и время сообщения
Example:
2024-11-27 13:32:49
channel
string 
required
Номер канала на который отправлено сообщение
Example:
7700999999
payload
object 
required
type
string 
required
Тип входящего сообщения. При нажатии на кнопку быстрого ответа абонентом - quick_reply
Example:
quick_reply
payload
object 
required
sender
object 
required
phone
string 
required
Номер отправителя
Example:
77771234567
name
string 
required
Никнейм в системе WhatsApp
Example:
Abai
context
object 
required
id
string 
required
ID вашего исходящего сообщения, кнопку в котором нажал абонент
Example:
2DC27650-FCC0-4F9B-8FD5-AEF5F2FD777C
forwarded
string 
required
true - абонент переслал вам это сообщение от другого абонента
Example:
false
frequently_forwarded
string 
required
true - это часто пересылаемое сообщение
Example:
false
Example
{
    "typeRequest": "inboxmsg",
    "id": "00DDDAC9-9C05-4767-954E-F30D9E14F4F9",
    "receivedAt": "2024-11-27 13:32:49",
    "channel": "7700999999",
    "payload": {
        "type": "quick_reply",
        "payload": {
            "text": "Другое",
            "btn_code": "3"
        }
    },
    "sender": {
        "phone": "77771234567",
        "name": "Abai"
    },
    "context": {
        "id": "2DC27650-FCC0-4F9B-8FD5-AEF5F2FD777C",
        "forwarded": "false",
        "frequently_forwarded": "false"
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ВашWebhook' \
--header 'X-API-KEY: 123' \
--header 'Content-Type: application/json' \
--data-raw '{
    "typeRequest": "inboxmsg",
    "id": "00DDDAC9-9C05-4767-954E-F30D9E14F4F9",
    "receivedAt": "2024-11-27 13:32:49",
    "channel": "7700999999",
    "payload": {
        "type": "quick_reply",
        "payload": {
            "text": "Другое",
            "btn_code": "3"
        }
    },
    "sender": {
        "phone": "77771234567",
        "name": "Abai"
    },
    "context": {
        "id": "2DC27650-FCC0-4F9B-8FD5-AEF5F2FD777C",
        "forwarded": "false",
        "frequently_forwarded": "false"
    }
}'

Responses

🟠404Record Not Found
text/html
Body
object {0}
Example
Сервис недоступен, попробуйте позднее
Previous
Местоположение - входящее сообщение
Next
Нажатие на кнопку из списка (из листа)
Built with