Webhook

Расширение Webhook вызывает ваш адрес, когда с задачей в форме что-то происходит. Так внешняя система узнаёт «посмотри на эту задачу», не опрашивая HCAPP.

Настройки

• URL: адрес, который вызывает HCAPP.
• Include task ID in request: добавляет в запрос task_id и form_id, чтобы получатель знал, какую задачу читать.
• Use SSL/TLS: проверять сертификат получателя. Выключайте только для тестовых адресов с самоподписанными сертификатами.
• Header: необязательный заголовок, который добавляется к каждому запросу, обычно Authorization: Bearer <token>, чтобы получатель мог проверить, что вызов от HCAPP.
• Trigger events: при создании, изменении, завершении.

Что отправляется

GET-запрос с параметрами: event (create, update или finish) и, если включено, task_id и form_id. Данных задачи вебхук не несёт; получатель читает задачу через Bot API ботом с доступом к форме.

Получатель должен ответить 200 или 202.

См. также

• Внешние интеграции: боты, Bot API и собственный вебхук бота для событий, адресованных ему.
• Поле Кнопка вызывает адрес по нажатию пользователя.