<aside> 💡 В этой части находятся ссылки, которые помогут разобраться в настройке интеграции
</aside>
происходит в кабинете настройки интеграций DealApp с помощью тех же шагов, что и Custom HTTPS интеграция для телефонии:
HTTPS интеграция с телефонией (через API Qolio)
Или вы так же можете посмотреть на предварительную настройку организации и создании чата по API в этом видео:
https://s3-us-west-2.amazonaws.com/secure.notion-static.com/e4493864-cb0c-4be6-b05d-406d72b22d1f/dealapp-integration-with-chats.mp4
После добавления интеграции для текстового канала, вам будет предоставлен:
https://{DEALAPP_API_URL}/api/v1/integrations/{INTEGRATION_ID}/text
, где DEALAPP_API_URL
адрес установки сервера DealApp, а INTEGRATION_ID
сгенерирован сервисом DealApp.Для регистрации текстовой коммуникации нужно сделать POST запрос следующим образом:
POST <https://api.prod1.dealapp.io/api/v1/integrations/c34f637a-..../text>
Зарос должен содержать следующие заголовки (headers): "Content-Type: application/json" и "Authorization: ...". В Authorization заголовке передается значение Authorization Token, которое можно найти на странице настройки интеграции в DealApp.
Вместе с запросом нужно передать JSON документ с данными о текстовой коммуникации. Пример JSON документа для запроса на добавление / обновление объекта текстового взаимодействия:
{
"client_id": "375299933332", // Идентификатор клиента в системе клиента (номер телефона, id или хэш)
"communication_id": "1911-1498-11", // Идентификатор текстового взаимодействия
"communication_type": "chat", // Тип текстового взаимодействия. Возможные варианты: chat / ticket / email
"title": "Добрый вечер. Я хочу приобрести холодильник", // Заглавие беседы, если нету - берется из conversation_parts.first.body
"source": "chat", // источник чата (telegram, viber и другие)
"nps": 8, // Net Promoter Score
"client_feedback": 1, // число, отображающее отзыв клиента
"status": "closed", // String обозначающий статус (accepted / rejected)
"direction": "incoming", // incoming / outcoming / local
"communication_parts": [
{
"communication_part_id": "2202737122",
"author": {
"type": "client" // при отсутствии id клиента мы используем client_id из
},
"body": "Добрый вечер. Я хочу приобрести холодильник",
"created_at": "2020-01-17T08:15:30+03:00"
},
{
"communication_part_id": "2202737122",
"author": {
"type": "client"
},
"body": "Интересует модель X этого года",
"created_at": "2020-01-17T08:15:30+03:00",
"updated_at": "2020-01-17T09:30:28+03:00"
},
{
"communication_part_id": "2202737122",
"author": {
"id": "123", // id оператора (внутренний номер)
"type": "operator" // возможные значения operator / client
},
"body": "Здравствуйте! Спасибо за сообщение, наш отдел продаж обязательно свяжется с вами",
"content_type": "text/plain", // text/plain by default, возможные варианты text/html
"created_at": "2020-01-17T08:15:30+03:00",
"updated_at": "2020-01-17T08:15:30+03:00"
}
],
"custom_fields": {
"reopens_count": 3
}
}
Обновление текстового сообщения может происходит при отправке запроса с уже существующим communication_id, в этом случае все значения будут переписаны исходя из тела нового сообщения. Допускаются только добавление или обновление значений элементов массива communication_parts.
curl запрос с помощью, которого можно создать чат:
export INTEGRATION_URL="<https://api.prod1.dealapp.io/api/v1/integrations/9e5af994-9d16-4607-8964-86272a452299/text>"
export AUTHORIZATION_TOKEN="289a2b91a681031fc576e3c66e155761cef58926a97d201363abd4c3196546318b597a9171aca4ae008be8e7fae5bec6f8de396adec24a"
curl --header "Content-Type: application/json" --request POST --header "Authorization: $AUTHORIZATION_TOKEN" --data @request.json $INTEGRATION_URL