Webhook — это входящий триггер для сценариев. Внешняя система отправляет HTTP-запрос на специальный адрес, и TgPanel запускает ваш сценарий.
Подходит, например, для интеграции со Zapier, Make или n8n.
Для исходящих HTTP-запросов из сценария есть отдельный шаг «Отправить вебхук» в редакторе сценариев — это другая функция.
POST https://<домен>/api/webhooks/{userId}/{token}
Content-Type: application/json
{userId} — ваш идентификатор в TgPanel.{token} — секретный токен из узла webhook вашего сценария.Тело запроса — произвольный JSON; его содержимое попадёт в контекст выполнения сценария.
| Код | Когда |
|---|---|
200 OK { "accepted": true } |
Запуск поставлен в очередь. |
404 Not Found |
Любая ошибка: пользователь не найден, токен не подошёл, сценария нет. |
200 OK означает «принято в обработку», но не гарантирует, что сценарий уже выполнился — выполнение асинхронное.
/api/webhooks/{userId}/{token}.Какой аккаунт исполнит сценарий: webhook не передаёт информации об аккаунте, поэтому TgPanel выбирает первый активный аккаунт пользователя. Если активных аккаунтов нет, запуск пропускается, но клиенту всё равно вернётся 200 OK.
curl -X POST "https://app.tgpanel.ru/api/webhooks/42/aGVsbG93b3JsZHRoaXNpc3NlY3JldA" \
-H "Content-Type: application/json" \
-d '{
"event": "new_lead",
"lead_id": 12345,
"name": "Иван"
}'