Webhooks

События сгруппированы по разделам: Contacts, Conversations, Messages, Handovers to your team, AI agent, Bookings, Reminders, Orders, Products, Calls, Campaigns, Forms, Account and channels, and Workspace settings. Откройте раздел и отметьте отдельные события или нажмите Выбрать все, чтобы выбрать весь раздел. Не знаете, где искать? Введите запрос в поле поиска, например «booking» или «tag». Нажмите на любое событие, чтобы увидеть пример того, что именно Entagl отправит. Для некоторых событий можно также выбрать источник, так что можно получать только те бронирования, которые сделал ваш AI, и пропускать те, что команда внесла в календарь вручную.

Входящее сообщение и Исходящее сообщение срабатывают для каждого сообщения. В загруженном аккаунте это могут быть тысячи событий в день. Поэтому Выбрать все пропускает их: каждое нужно отметить вручную рядом с предупреждением. Включайте их только если инструмент на другой стороне может обрабатывать такой объём. Если вам нужно лишь знать, когда чат начинается или заканчивается, Диалог открыт и Диалог закрыт гораздо тише.

Два переключателя определяют, сколько информации о клиенте покидает Entagl. Включать содержимое сообщения добавляет то, что написали клиенты: сообщения, заметки и сводки звонков. Включать контактные данные добавляет имя клиента, номер телефона и email. Оба по умолчанию выключены. При этом вы всё равно получаете каждое событие, но с ID контакта там, где обычно были бы данные. Включить их может только владелец workspace или администратор, и делать это стоит лишь если принимающий инструмент имеет право хранить данные клиентов. В HIPAA workspace данные клиентов никогда не отправляются, независимо от переключателей.

Инструменты и разработчики могут регистрировать собственные webhooks через API Entagl, и они сами появляются в разделе Подключенные приложения. Для каждого видно, сколько событий оно слушает и когда пришло последнее. Можно открыть Недавние доставки, использовать Пауза и Возобновить или нажать Удалить. У scenario Make есть своя страница: Каналы → Make.

Нажмите Недавние доставки, чтобы увидеть последние 50 событий, которые Entagl пытался отправить, начиная с самых новых. Для каждого отображается, дошло ли оно, какой ответ вернул ваш инструмент (например, 200 или 500), сколько было попыток и когда запланирована следующая. Если доставка окончательно не удалась, исправьте проблему у себя и нажмите Отправить снова. Entagl отправит её через несколько секунд.

Если ваш инструмент недоступен или отвечает ошибкой, Entagl попробует снова через 30 секунд, 2 минуты, 10 минут, 1 час, 6 часов и 24 часа. Это примерно 31 час до того, как доставка будет помечена как неудачная. Если подключённое приложение ошибается 3 дня подряд, Entagl приостанавливает его и отправляет уведомление владельцу workspace. Исправьте инструмент, затем нажмите Возобновить. Если Make сообщает, что webhook сценария больше не существует, Entagl сразу прекращает отправку туда.

Каждый запрос содержит подпись в заголовке X-Entagl-Signature, созданную с помощью вашего signing secret. Ваш разработчик использует её, чтобы подтвердить, что запрос пришёл из Entagl и по пути никто его не изменил.

• Подключённые приложения и webhooks, созданные через API, отправляют t=1767225600,v1=5257a869…. Часть t — это время отправки в секундах. Каждое значение v1 — это HMAC-SHA256 от текста timestamp.body (значение t, точка, затем raw request body), созданный с вашим secret. Отклоняйте любой запрос, у которого t старше 5 минут, чтобы старый запрос нельзя было повторно воспроизвести. Сразу после смены secret вы можете увидеть два значения v1: примите запрос, если совпадает хотя бы одно.
• Webhook, который вы настроили на этой странице, отправляет sha256= и затем HMAC-SHA256 от raw request body.