При получении вебхука

​

Создание с помощью ИИ

​

Конфигурация

​

Настройка

1. Откройте Автоматизацию и добавьте новый триггер.
2. Выберите При получении вебхука.
3. Триггер сразу создаст уникальный URL вебхука. Скопируйте его: он понадобится для внешней системы.
4. Необязательно, но рекомендуется: нажмите Создать токен, чтобы включить авторизацию по Bearer-токену. Будет создан токен, который необходимо включать в заголовок Authorization входящих запросов.
5. Сохраните и активируйте Автоматизацию.
6. Настройте внешнюю систему на отправку POST-запроса на URL вебхука. Если вы включили авторизацию, добавьте токен в заголовок.
7. Отправьте тестовый запрос (см. примеры ниже). Проверьте историю запусков Автоматизации, чтобы убедиться, что данные получены правильно.
8. Добавьте шаги действий. Чтобы сослаться на значения из JSON-тела вебхука, нажмите + в любом Поле действия.

​

Какие данные доступны следующим шагам

{
  "order_id": "12345",
  "customer": "Алиса",
  "amount": 99.95
}

​

Настройка ответа

{"challenge":"{{body.challenge}}"}

​

Тестирование вебхука

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -d '{"test": true, "message": "Привет от curl"}'

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{"order_id": "12345", "status": "оплачено"}'

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{
    "event": "invoice.paid",
    "data": {
      "invoice_id": "INV-001",
      "amount": 250.00,
      "currency": "USD",
      "customer_email": "alice@example.com"
    }
  }'

​

Ограничения частоты запросов

​

Рекомендации по безопасности

• Всегда используйте авторизацию по Bearer-токену для рабочих вебхуков. Публичный URL вебхука может запустить любой, кто его обнаружит.
• Не раскрывайте URL вебхука. Относитесь к нему как к паролю. Не сохраняйте его в общедоступных репозиториях и не публикуйте в открытых каналах.
• Создайте токен заново, если подозреваете, что он скомпрометирован. Новый токен можно создать на панели триггера в любое время.
• Проверяйте данные в рабочем процессе. Не считайте входящие данные заведомо корректными. С помощью фильтров или шагов со скриптом проверяйте наличие обязательных Полей до начала обработки.
• Контролируйте историю запусков. Регулярно проверяйте журналы запусков Автоматизации, чтобы выявлять неожиданные или неавторизованные запросы.

​

Когда использовать

• Получать события оплаты от Stripe или PayPal. Настройте вебхук Stripe на отправку событий invoice.paid в Автоматизацию Teable, чтобы автоматически создавать или обновлять записи заказов.
• Принимать отправленные формы с вашего сайта. Направьте контактную форму или форму регистрации сайта на URL вебхука, чтобы создавать записи непосредственно в Teable.
• Получать данные от устройств Интернета вещей. Датчики и устройства, способные отправлять HTTP-запросы, могут передавать данные в Teable для мониторинга и оповещения.
• Подключать конвейеры CI/CD. Запускайте рабочие процессы при успешной или неудачной сборке: создавайте записи, отправляйте уведомления или обновляйте статус проекта.
• Получать события из любого SaaS-инструмента. Многие инструменты (GitHub, Jira, Shopify, Twilio и другие) поддерживают уведомления через вебхуки. Направьте их на вебхук Teable, чтобы автоматизировать рабочие процессы между инструментами.

​

Советы

• Вебхук принимает только запросы POST. Запросы GET, PUT и с другими методами не запускают Автоматизацию.
• Всегда отправляйте заголовок Content-Type: application/json. Если тело не является допустимым JSON, триггер может разобрать данные неправильно.
• Если нужно отправлять данные из системы, которая не поддерживает пользовательские заголовки для авторизации Bearer, используйте публичный режим, но добавьте секретный ключ в JSON-тело и проверяйте его в рабочем процессе с помощью фильтра или скрипта.
• Для отладки можно использовать такие сервисы, как webhook.site, чтобы проверить, что именно отправляет внешняя система, прежде чем направлять её запросы в Teable.

​

Связанные разделы

• Действие «HTTP-запрос» — исходящий аналог: вызов внешних API из рабочего процесса
• Запуск скрипта — для расширенной обработки полезной нагрузки вебхука
• Действие «Цикл (пакетная обработка)» — обработка массивов в полезной нагрузке вебхука