Коли отримано вебхук

​

Створення за допомогою ШІ

​

Налаштування

​

Як налаштувати

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": "paid"}'

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.
• Приймання даних із пристроїв IoT. Датчики або пристрої, що можуть надсилати 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 з робочого процесу
• Запуск сценарію — розширена обробка корисного навантаження вебхука
• Дія «Цикл (пакетна обробка)» — обробка масивів у корисних навантаженнях вебхука