Подтверждение заявки на стороннем сервисе с помощью API

Функционал позволяет отправлять полученные заявки с виджетов в систему клиента до запуска обратного звонка. Это дает клиенту возможность принять решение о необходимости прозвона таких заявок или их отмене.

Например, чтобы клиент мог самостоятельно отсеивать спам, либо клиентов, с которыми КЦ уже связался ранее.

Для подключения функционала необходимо обратиться к вашему аккаунт-менеджеру либо написать на почту info@calltouch.net. 

После настройки функционала, при получении заявки, она будет попадать в общую очередь со статусом "Заявка находится на проверке внешним сервисом". Параллельно заявка со всеми данными из формы будет улетать вебхуком в стороннюю систему.

Пример тела запроса

Тело запроса в формате JSON:

{
  "attempt_id": "ID попытки (вебхука)",
  "request_created": "Время создания заявки, в формате yyyy-mm-dd hh:mm:ss",
  "work_mode": "Режим работы виджета (рабочее/не рабочее время)",
  "request_id": "ID заявки",
  "client_phone": "Номер телефона клиента",
  "form_data": {
    "name": "Имя",
    "note": "Комментарий",
    "phone": "Номер телефона",
    "email": "Email",
    "contactUnitGroupId": "ID группы отделов",
    "contactUnitGroupTitle": "Название группы отделов",
    "textField1": "Поле ввода",
    "selectField1": "Выпадающий список"
  },
  "call_center_phone_number": [
    "Номер контакт центра"
  ],
  "widget_type": "Тип виджета",
  "widget_name": "Название виджета",
  "widget_id": "ID виджета",
  "widget_tag": ["тег1", "тег2"],
  "unit_id": "ID отдела",
  "unit_name": "Название отдела",
  "unit_tag": ["тег1", "тег2"],
  "attempt_number": "Номер попытки отправки вебхука",
  "attempt_status": "Статус отправки вебхука",
  "request_status": "Статус заявки"
}

Параметры запроса

Запрос

POST:

https://api.calltouch.ru/widget-service/v1/api/widget-request/queue/attempt/foreign-service/approve

HTTP-заголовки:

• Access-Token — API-ключ.

Пример тела запроса

Тело запроса в формате JSON.

Подтверждение заявки:

{
  "attemptId": 232930762,
  "isPassed": true
}

Отмена заявки:

{
  "attemptId": 232930762,
  "isPassed": false
}

Параметры тела запроса

После того, как система обработает заявку:

• Если получили подтверждение, заявка уйдет на прозвон, в журнале отобразится лид. Вторая и остальные попытки, будут отработаны в штатном режиме нашей системой.
• Если получили отказ, заявка на прозвон не уйдет, в журнале лид не отобразится. Такая заявка в очереди на прозвон будет отмечена статусом: "Отменена сторонней системой". 
• Если мы не получим ответ от системы в течение 24 часов, то заявка будет отменена автоматически.

1. Пользователь на сайте заполняет форму на обратный звонок.

2. Данные из формы отправляются вебхуком в систему клиента:

{
  "attempt_id": 232930762,
  "request_created": "2024-11-22T16:56:19+03:00",
  "work_mode": "В рабочее время",
  "request_id": 222825448,
  "client_phone": "79001234567",
  "form_data": {
    "name": "Антон",
    "phone": "79001234567",
  },
  "call_center_phone_number": [
    "74994604358"
  ],
  "widget_type": "callback",
  "widget_name": "Новый виджет",
  "widget_id": 197851,
  "attempt_number": 1,
  "attempt_status": "foreign_service_check",
  "request_status": "successful"
}

3. Система клиента обрабатывает вебхук и направляет запрос-подтверждения по API:

{
  "attemptId": 232930762,
  "isPassed": true
}

4. После получения подтверждения, заявка уходит на прозвон и отображается в журнале звонков/лидов.

5. При получении отказа от системы, заявка на прозвон не уходит, в очереди отображается статус "Отменена сторонней системой".