Вебхуки задач Telegram в Deskgram 2

Вебхуки задач Telegram в Deskgram 2

Отправляйте события Deskgram 2 в свою CRM, HTTP-обработчик или сервис автоматизации. Выберите получателя, события и поля JSON. Результат доставки, ответ сервера и ошибки сохраняются в журнале вебхуков.

Какие события отправляет Deskgram

Для задач доступны task.completed, task.failed и task.cancelled: завершение, ошибка и остановка. Эти события формируются через диспетчер задач; завершение задачи не означает успех каждого действия внутри неё.

События message.sent, message.failed и lead.reply_received сейчас подключены к модулю личных сообщений spam_pm. Для других модулей наличие таких событий нужно проверять отдельно. Ответ лида — входящее сообщение, а не покупка или подтверждение сделки.

Можно выбрать события и фильтр модулей для каждого получателя. Вебхуки передают уведомления наружу; для управления задачами из ИИ-агента используется MCP.

Получатель, POST и тестовый запрос

Откройте «Настройки → Вебхуки» или отдельный модуль вебхуков. Задайте название, URL получателя, события, фильтр модулей и включите endpoint. Доставка поддерживает POST с JSON; таймаут можно выбрать от 3 до 60 секунд, по умолчанию 15.

При необходимости задайте заголовки, например Authorization, и secret. При настроенном secret отправляется X-Deskgram-Signature с HMAC-SHA256 по точным байтам тела. Для совместимости secret также передаётся в x-secret и X-Deskgram-Webhook-Secret; используйте HTTPS для рабочего получателя.

Кнопка теста отправляет webhook.test выбранному endpoint. Это проверка доставки, а не имитация результата настоящей задачи: task, lead и message в тестовом событии отсутствуют, поэтому часть полей сокращённых шаблонов может не появиться.

Данные уведомления и четыре формата JSON

Стандартный deskgram содержит schema_version, event, occurred_at и source. Для события задачи в task передаются task_id, модуль, статус, число аккаунтов, время, params, statistics и result.

События личных сообщений содержат module=spam_pm, task, account, lead и message. Доступные поля лида включают Telegram ID, username, телефон и имя; состав зависит от исходных данных, пустые значения не становятся известными контактами.

Есть short_result — краткий результат, crm_lead — плоские поля лида и сообщения, и custom — собственное сопоставление полей. Выберите исходный путь и имя поля у получателя; отсутствующие значения при mapping пропускаются. Полный формат передаёт параметры и результат задачи, сокращённый позволяет оставить нужные поля.

Автоматическая и ручная повторная доставка

Ответ HTTP 2xx считается успешной доставкой. Другой статус или ошибка соединения вызывают повтор: максимум 3 попытки, паузы перед второй и третьей — 2 и 4 секунды. Ответ 2xx подтверждает HTTP-приём, но не завершение обработки в CRM.

Автоповторы одной доставки используют один X-Deskgram-Delivery-Id. Получатель должен учитывать повторы; идемпотентность обработки не возникает автоматически.

Ручной повтор доступен для записи error и создаёт новую доставку с новым ID. Используются сохранённое исходное событие и текущие настройки получателя, включая mapping; отправляемый JSON может отличаться от первого запроса.

Доставка выполняется в фоне и не является устойчивой очередью. Автоматическое продолжение после остановки приложения или рестарта не предусмотрено; проверьте журнал. Доставку ровно один раз модуль не гарантирует.

Что смотреть в журнале

Фильтруйте доставки по получателю, событию и статусу. В записи видны pending, retrying, success или error, число попыток, последний HTTP-код, ответ сервера, ошибка и время.

Откройте детали, чтобы сравнить исходное событие source_payload и отправленный request_payload. Тело ответа сохраняется до 2000 символов. Автоматические попытки обновляют одну запись; отдельный ручной повтор появляется новой строкой.

Начните с тестового получателя и webhook.test, затем проверьте нужное событие на своей задаче. Сверьте JSON, подпись, код ответа и данные на стороне получателя. Сам тестовый запрос не подтверждает, что все бизнес-события вашего сценария сформировались.

Другие модули Deskgram 2