Webhooks

Входящие HTTP-запросы, которые запускают процессы или доставляют события из внешних систем.

Webhook как триггер Start Event

Start Event с типом «Webhook» при публикации процесса получает уникальный URL:

POST https://api.schemix.ru/webhooks/inbound/{webhook_id}

JSON body становится входными переменными запущенного процесса.

Пример

curl -X POST https://api.schemix.ru/webhooks/inbound/abc123 \
  -H "Content-Type: application/json" \
  -d '{"order_id": 456, "event": "payment_received"}'

Переменные order_id и event будут доступны в процессе сразу после старта — их можно использовать в Gateway-условиях, AI Task, Service Task и других узлах.

Безопасность

• Уникальный webhook_id — единственный «ключ», по которому внешняя система вызывает процесс.
• Для production рекомендуется настроить секрет webhook и проверять подпись входящих запросов.
• Не публикуйте URL webhook в открытых репозиториях и клиентском коде.

---

Мессенджер-webhooks

Настраиваются автоматически при подключении каналов — вручную вызывать не нужно.

Канал	Endpoint
Telegram	/webhooks/telegram
Wazzup	/channels/wazzup/inbound
MAX	/webhooks/max
Web-чат	/channels/webchat/{config_id}/inbound

Web-чат — единственный канал, который вызывается вашей системой напрямую (с API-ключом). Остальные каналы настраиваются автоматически. Подробнее: Интеграции — Web-чат.