Создать вебхук
- Перейдите в Настройки → API и Вебхуки → Вебхуки
- Нажмите + Создать вебхук
- Введите URL вашего вебхука (должен быть общедоступным)
- Нажмите Сохранить
Управление вебхуками
Изменить: Нажмите на вебхук → Обновите URL → Сохранить Удалить: Нажмите на вебхук → Удалить → ПодтвердитьСобытия
Twenty отправляет вебхуки для следующих типов событий:
Все типы событий отправляются на URL вашего вебхука. Фильтрация событий может быть добавлена в будущих версиях.
Формат полезной нагрузки
Каждый вебхук отправляет HTTP POST с телом JSON:Ответьте со статусом HTTP 2xx (200-299), чтобы подтвердить получение. Ответы вне диапазона 2xx фиксируются как ошибки доставки.
Валидация вебхуков
Twenty подписывает каждый запрос вебхука для обеспечения безопасности. Проверяйте подписи, чтобы убедиться в подлинности запросов.Заголовки
Шаги проверки
- Получите метку времени из
X-Twenty-Webhook-Timestamp - Создайте строку:
{timestamp}:{JSON payload} - Вычислите HMAC SHA256, используя секрет вашего вебхука
- Сравните с
X-Twenty-Webhook-Signature
Пример (Node.js)
Вебхуки vs рабочие процессы
Для получения внешних данных см. Настройка триггера вебхука.