Справочный центр | Как отправлять транскрипты чатов через вебхуки

Как отправлять транскрипты чатов через вебхуки

Инструкции ниже предназначены только для ПК и ноутбуков.

С помощью вебхуков вы можете отправлять полные транскрипты чатов из tawk.to напрямую в ваше приложение, CRM или базу данных. После того как посетитель покидает диалог (обычно после около 3 минут бездействия), создаётся транскрипт, который автоматически отправляется на указанную конечную точку. Это удобно для архивирования чатов, запуска последующих действий, интеграции данных в существующие рабочие процессы.

Настройка вебхука для транскриптов чатов

Войдите в свой аккаунт tawk.to.

2. Выберите нужный Проект (Property).

3. В левом меню навигации нажмите Администрирование.

4. В левом подменю в разделе Настройки выберите Вебхуки.

5. Нажмите Создать вебхук.

Примечание: для одного Property можно создать до 10 вебхуков.

6. Укажите понятное и описательное Название.

7. Введите URL-адрес конечной точки сервиса, который будет получать данные. URL должен поддерживать HTTPS, принимать POST-запросы в формате JSON.

8. Выберите событие Новый транскрипт чата. Это гарантирует отправку транскрипта после завершения сессии.

Транскрипт всего разговора отправляется после 3 минут бездействия. Ниже приведён пример передаваемых данных.

9. Проверьте настройки и нажмите Сохранить.

Примечание: при срабатывании события tawk.to отправляет JSON-payload. Подробное описание структуры данных доступно в документации Developer Portal.

Чтобы узнать, как работать с JSON-файлами, см. руководство:
Как конвертировать файлы JSON?

Управление вебхуками

После создания webhooks может потребоваться их обновление или удаление.

Включение / отключение вебхука
Используйте переключатель в правом верхнем углу соответствующего вебхука.

Редактирование вебхука
Нажмите на значок карандаша, измените имя, конечную точку или события и сохраните изменения.

Удаление вебхука
Нажмите на значок корзины. Это полностью удалит вебхук и остановит дальнейшую отправку данных на эту конечную точку.

Совет: поддерживайте список webhooks в порядке - удаляйте неиспользуемые конечные точки. Это снижает лишний трафик и повышает безопасность интеграций.

Дополнительные моменты

Проверяйте полезную нагрузку

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

Обеспечьте безопасность

tawk.to подписывает каждый вебхук с помощью HMAC-SHA1.
Используйте заголовок X-Tawk-Signature и ваш вебхук-секрет, чтобы проверить подлинность запроса.

Учитывайте повторные попытки отправки

Если ваша конечная точка не отвечает в течение 30 секунд или возвращает ошибку tawk.to будет повторять попытки доставки до 12 часов. Убедитесь, что ваша система безопасно обрабатывает дублирующиеся запросы.

Обработка вложений

Некоторые чаты содержат файлы. Вебхук передаёт метаданные и URL вложений - решите, нужно ли загружать файлы, сохранять их локально или в облаке.

Конфиденциальность данных

Транскрипты могут содержать персональные данные. Храните и используйте их ответственно, соблюдая требования законодательства о защите данных.

Тестируйте перед запуском

Проведите несколько тестовых чатов и убедитесь, что транскрипты приходят корректно. Это поможет выявить проблемы до подключения к боевым системам.

Дополнительные ресурсы

Ознакомьтесь с Платформой разработчиков, чтобы получить подробную информацию о payload’ах webhooks и примерах интеграций.

Связанные руководства

Создание и управление вебхуками

Портал разработчиков tawk.to: Вебхуки

Как конвертировать файлы JSON?

Просмотр, удаление и экспорт истории чатов

Экспорт сообщений

Настройка почтовых уведомлений

Есть отзывы по этой статье или нужна помощь?

Нажмите на зелёный значок чата
Запланируйте звонок с нами
Посетите наше сообщество

Эта статья была вам полезна?

81 из 104 понравилась эта статья