[go: up one dir, main page]

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

Работа с входящими звонками#

В зависимости от потребностей интеграции, работу с уведомлениями о входящих звонках можно реализовать несколькими способами:

  1. Если Вам не нужна работа с входящими звонками, то рекомендуем делать сброс входящего уведомления incomingCall

    • При работе обработчика уведомлений - установить удаление неизвестных типов уведомлений по полю typeWebhook. Так все ненужные вам уведомления будут удаляться из очереди.
    • При работе через HTTP API - удалять уведомления методом deleteNotification.
    • При работе через Webhook Endpoint - отдавать статус код 200.
  2. Если Вам необходимо получать только факт входящего звонка, можно сделать обработчик на получение уведомления typeWebhook: incomingCall и отслеживать статус status: offer. Все остальные статусы исключать из обработки звонков.

  3. Если вам необходимо видеть только результат звонка и не информировать оператора о поступлении входящего звонка, тогда требуется отслеживать и записывать в чат все статусы кроме offer. Также можно сократить информацию по неотвеченным звонкам.

    Например:

    • При получении уведомления (typeWebhook: incomingCall + status: offer) - просто сбрасывать уведомление.
    • При получении других статусов - записывать в чат с собеседником записи:

      pickUp - "Отвеченный звонок"
      hungUp - "Пропущенный звонок"
      missed - "Пропущенный звонок"
      declined - "Пропущенный звонок"

  4. Если необходимо получать все статусы звонков, требуется реализовать обработку всех уведомлений типа incomingCall. Необходимо при получении уведомления транслировать в чат запись о звонке.

    Например:

    • Получаем входящий звонок (typeWebhook: incomingCall + status: offer), записываем в чат Входящий вызов и информируем оператора.
    • Завершение звонка (по причинам: ответа оператора, сброса звонка, истечения времени ожидания) - получаем уведомление (typeWebhook: incomingCall) и в зависимости от значения поля status делаем запись в чат:

      pickUp - "Отвеченный звонок"
      hungUp - "Сброшенный звонок" - оператор сбросил звонок или в системе установлена настройка или на телефоне активирована функция Не беспокоить (положили трубку)
      missed - "Пропущенный звонок" - собеседник завершил звонок
      declined - "Пропущенный звонок" - собеседник не дождался ответа

Получение имени звонящего собеседника

  1. Получить уведомление incomingCall о входящем звонке, в поле from указан номер аккаунта собеседника.

  2. Использовать метод GetContactInfo для определения информации о звонящем собеседнике.

  3. Использовать поля name или contactName из метода GetContactInfo для получения имени собеседника.