Подтверждение заявки на стороннем сервисе с помощью 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": "Статус заявки"
  "user_schedule_time": "дата/время, которое пользователь выбрал в элементе "Выбор времени звонка"",
  "widgetCustomFieldList": [
    {
      "Пользовательские поля из виджета"
    }
  ],
  "site_id": "сайт_id"
}

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

Запрос

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"
  "site_id": 12345
}

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

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

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

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