Когда к вашему проекту подключена интеграция — Chotam будет присылать события на указанный вами адрес.
Это происходит автоматически, через механизм, который называется Webhook.
Не существует метода посмотреть "с вашей стороны" - а какие там есть комментарии/сообщения (уже собранные). Мы отправляем их вам по мере получения.
Каждое событие приходит как JSON-объект. Ниже мы объясним, из чего он состоит.
Какой будет метод и адрес?
Метод:
POSTАдрес: ваш собственный endpoint, который вы указали при настройке
Заголовок:
X-Auth-Token: ваш_токен
? Пример тела запроса
Вот как выглядит структура входящего запроса (это пример из Ватсапа, но в других будет примерно аналогично:
{'channel_id': 123, 'dialog_id': 456, 'project': {'id': 789, 'title': 'API test'}, 'context': {'repliable': 1, 'removable': 0, 'id': 99999, 'social_media': 'gupshup', 'owner_id': '777777777777', 'owner_url': 'https://wa.me/77777777', 'parent_id': '79059599575', 'parent_type': 'message', 'comment_type': 'message', 'comment_id': 'wamid.HBgLNzkwNTk1OTk1NzUVAgASGBQzQTJEOUI2REMyNENDQjRDNUE2RgA=', 'comment_url': 'https://wa.me/79059599575', 'author_id': 1010, 'author_social_id': '79059599575', 'author_url': 'https://wa.me/79059599575', 'author_name': 'Евгений Скрипник', 'author_realname': 'Евгений Скрипник', 'text': 'тут текст сообщения'}}
Что это всё значит?
| Поле | Что означает |
|---|---|
channelId | Канал внутри нашей системы (обычно не нужен для базовой работы) |
dialogId | Идентификатор диалога (внутренний) |
project | Информация о проекте, из которого пришло сообщение |
context.id | Идентификатор самого сообщения |
context.authorId | ID автора |
context.text | Текст комментария или сообщения |
context.action | Что можно сделать В ОТВЕТ - repliable - можно ответить (0 или 1), removable - можно удалить (0 или 1) |
Когда вы получаете такие сообщения — вы можете:
показать их оператору,
автоматически среагировать (например, ответить, если это частый вопрос),
записать в базу и отправить в CRM.