Перейти к содержанию

Входящий звонок#

Уведомление данного типа возникает при входящем звонке и содержит информацию об инициаторе и адресате звонка.

Уведомление#

Формат уведомления#

Параметр Тип Описание
from string Идентификатор инициатора звонка
typeWebhook string Тип входящего уведомления. Для уведомлений данного типа поле принимает значение incomingCall
instanceData object Объект данных с информацией об инстансе и аккаунте
status string Статус входящего звонка, принимает значения:
offer - входящий звонок
pickUp - отвеченный входящий звонок
hangUp - не отвеченный входящий звонок
missed - пропущенный, не отвеченный входящий звонок, соединение было прервано инициатором
declined - пропущенный, не отвеченный входящий звонок, соединение было прервано WhatsApp
timestamp integer Время наступления события в UNIX-формате
idMessage string Идентификатор входящего звонка

Поля объекта instanceData

Параметр Тип Описание
idInstance integer Идентификатор аккаунта
wid string Идентификатор аккаунта в формате WhatsApp
typeInstance string Тип мессенджера для аккаунта

Статусы звонков

При входящем звонке система формирует по очереди два уведомления:

  • Первое уведомление со статусом offer, что указывает на получение нового входящего звонка.
  • Второе уведомление со статусом pickUp, hangUp, missed или declined, в зависимости от исхода звонка.

Сценарий получения уведомлений:

  1. offer + pickUp - успешный входящий звонок, адресат ответил на звонок
  2. offer + hungUp - не отвеченный входящий звонок, адресат прервал соединение или на телефоне активирована функция "Не беспокоить" (положили трубку)
  3. offer + missed - пропущенный входящий звонок, инициатор прервал соединение (завершил звонок звонивший)
  4. offer + declined - пропущенный входящий звонок, приложение завершило соединение из-за таймаута (Whatsapp завершил звонок)

Пример тела уведомления#

{
    "from": "79001234500@c.us",
    "typeWebhook": "incomingCall",
    "instanceData": {
        "idInstance": 1101123456,
        "wid": "11001234567@c.us",
        "typeInstance": "whatsapp"
    },
     "status": "pickUp",
     "timestamp": 1617691757,
     "idMessage": "104179EDB7F5328988D8834107EEBE50"
}