Skip to main content
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 рабочие процессы

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