Вебхуки позволяют внешним сервисам запускать выполнение рабочих процессов, отправляя HTTP-запросы к вашему рабочему процессу. AACFlow поддерживает два подхода для триггеров на основе вебхуков.
Универсальный триггер вебхука
Блок "Универсальный вебхук" создает гибкую конечную точку, которая может получать любые данные и запускать ваш рабочий процесс:
Как это работает
- Добавьте блок "Универсальный вебхук" - Перетащите блок "Универсальный вебхук" в начало вашего рабочего процесса
- Настройте структуру данных - Настройте ожидаемую структуру полезной нагрузки (опционально)
- Получите URL вебхука - Скопируйте автоматически сгенерированную уникальную конечную точку
- Внешняя интеграция - Настройте ваш внешний сервис для отправки POST-запросов на этот URL
- Выполнение рабочего процесса - Каждый запрос к URL вебхука запускает рабочий процесс
Особенности
- Гибкая полезная нагрузка: Принимает любую структуру JSON-данных
- Автоматический парсинг: Данные вебхука автоматически разбираются и становятся доступными для последующих блоков
- Аутентификация: Опциональная аутентификация с помощью токена Bearer или пользовательских заголовков
- Ограничение частоты запросов: Встроенная защита от злоупотреблений
- Дедупликация: Предотвращает дублирующие выполнения из повторяющихся запросов
Триггер "Универсальный вебхук" срабатывает каждый раз, когда URL вебхука получает запрос, что делает его идеальным для интеграций в реальном времени.
Режим триггера для сервисных блоков
В качестве альтернативы вы можете использовать конкретные сервисные блоки (такие как Slack, GitHub и т.д.) в "режиме триггера" для создания более специализированных конечных точек вебхуков:
Настройка режима триггера
- Добавьте сервисный блок - Выберите сервисный блок (например, Slack, GitHub, Airtable)
- Включите режим триггера - Переключите "Использовать как триггер" в настройках блока
- Настройте сервис - Настройте аутентификацию и фильтры событий, специфичные для этого сервиса
- Регистрация вебхука - Сервис автоматически регистрирует вебхук на внешней платформе
- Выполнение на основе событий - Рабочий процесс запускается только для конкретных событий от этого сервиса
Когда использовать каждый подход
Используйте "Универсальный вебхук" когда:
- Интегрируетесь с пользовательскими приложениями или сервисами
- Вам нужна максимальная гибкость в структуре полезной нагрузки
- Работаете с сервисами, для которых нет специальных блоков
- Создаете внутренние интеграции
Используйте "Режим триггера" когда:
- Работаете с поддерживаемыми сервисами (Slack, GitHub и т.д.)
- Вам нужна фильтрация событий, специфичная для сервиса
- Вам нужна автоматическая регистрация вебхуков
- Вам нужна структурированная обработка данных для этого сервиса
Поддерживаемые сервисы для режима триггера
Разработка и управление проектами
- GitHub - Issues, PRs, pushes, releases, workflow runs
- Jira - Issue events, worklogs
- Linear - Issues, comments, projects, cycles, labels
Коммуникация
- Slack - Messages, mentions, reactions
- Microsoft Teams - Chat messages, channel notifications
- Telegram - Bot messages, commands
- WhatsApp - Messaging events
Электронная почта
- Gmail - New emails (polling), label changes
- Outlook - New emails (polling), folder events
CRM и продажи
- HubSpot - Contacts, companies, deals, tickets, conversations
- Stripe - Payments, subscriptions, customers
Формы и опросы
- Typeform - Form submissions
- Google Forms - Form responses
- Webflow - Collection items, form submissions
Другие
- Airtable - Record changes
- Twilio Voice - Incoming calls, call status
Безопасность и лучшие практики
Варианты аутентификации
- Токены Bearer: Включите заголовок
Authorization: Bearer <token> - Пользовательские заголовки: Определите пользовательские заголовки аутентификации
Обработка полезной нагрузки
- Валидация: Проверяйте входящие данные для предотвращения некорректных данных
- Ограничения размера: Вебхуки имеют ограничения на размер полезной нагрузки для безопасности
- Обработка ошибок: Настройте ответы на ошибки для невалидных запросов
Тестирование вебхуков
- Используйте инструменты вроде Postman или curl для тестирования ваших конечных точек вебхуков
- Проверяйте логи выполнения рабочих процессов для отладки
- Убедитесь, что структура полезной нагрузки соответствует вашим ожиданиям
- Тестируйте сценарии аутентификации и ошибок
Всегда проверяйте и очищайте входящие данные вебхуков перед их обработкой в ваших рабочих процессах.
Распространенные сценарии использования
Уведомления в реальном времени
- Сообщения Slack, запускающие автоматические ответы
- Уведомления по электронной почте для критических событий
Интеграция CI/CD
- Push в GitHub, запускающие рабочие процессы развертывания
- Обновления статуса сборки
- Автоматизированные конвейеры тестирования
Синхронизация данных
- Изменения в Airtable, обновляющие другие системы
- Отправка форм, запускающая последующие действия
- Обработка заказов в электронной коммерции
Поддержка клиентов
- Рабочие процессы создания тикетов поддержки
- Автоматизированные процессы эскалации
- Маршрутизация многоканальной коммуникации