Перейти к основному содержанию
Twenty отправляет запрос HTTP POST на ваш URL каждый раз, когда запись создаётся, обновляется или удаляется. Поддерживаются все типы объектов, включая пользовательские объекты.

Создать вебхук

  1. Перейдите в Настройки → API и Вебхуки → Вебхуки
  2. Нажмите + Создать вебхук
  3. Введите URL вашего вебхука (должен быть общедоступным)
  4. Нажмите Сохранить
Вебхук активируется сразу и начинает отправлять уведомления.

Управление вебхуками

Изменить: Нажмите на вебхук → Обновите URL → Сохранить Удалить: Нажмите на вебхук → Удалить → Подтвердить

События

Twenty отправляет вебхуки для следующих типов событий: Все типы событий отправляются на URL вашего вебхука. Фильтрация событий может быть добавлена в будущих версиях.

Формат полезной нагрузки

Каждый вебхук отправляет HTTP POST с телом JSON:
Ответьте со статусом HTTP 2xx (200-299), чтобы подтвердить получение. Ответы вне диапазона 2xx фиксируются как ошибки доставки.

Валидация вебхуков

Twenty подписывает каждый запрос вебхука для обеспечения безопасности. Проверяйте подписи, чтобы убедиться в подлинности запросов.

Заголовки

Шаги проверки

  1. Получите метку времени из X-Twenty-Webhook-Timestamp
  2. Создайте строку: {timestamp}:{JSON payload}
  3. Вычислите HMAC SHA256, используя секрет вашего вебхука
  4. Сравните с X-Twenty-Webhook-Signature

Пример (Node.js)

Вебхуки vs рабочие процессы

Для получения внешних данных см. Настройка триггера вебхука.