Настройка триггера вебхука

​

Когда использовать вебхуки

​

Пошаговая настройка

​

Шаг 1: Создайте рабочий процесс

1. Перейдите в Настройки → Рабочие процессы
2. Нажмите + Новый рабочий процесс
3. Дайте ему имя (например, “Отправка формы на сайте”)

​

Шаг 2: Настройте триггер вебхука

1. Нажмите на блок триггера
2. Выберите Вебхук
3. Вы получите уникальный URL вебхука, например:
   https://api.twenty.com/webhooks/workflow/abc123...
   
4. Скопируйте этот URL — он понадобится вашему внешнему сервису

​

Шаг 3: Определите ожидаемую структуру данных

1. Нажмите Определить ожидаемое тело
2. Введите пример JSON, который ваш сервис будет отправлять:

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com",
  "company": "Acme Inc",
  "message": "Interested in your product"
}

3. Нажмите Сохранить — это создаст переменные, которые можно использовать на следующих шагах

​

Шаг 4: Добавьте действия

1. Добавьте действие Создать запись
2. Выберите объект People
3. Сопоставьте поля:

​

Шаг 5: Протестируйте вебхук

curl -X POST https://api.twenty.com/webhooks/workflow/abc123... \
  -H "Content-Type: application/json" \
  -d '{"firstName":"Test","lastName":"User","email":"test@example.com"}'

1. Создайте POST-запрос на URL вашего вебхука
2. Установите заголовок Content-Type в application/json
3. Добавьте тестовое тело JSON
4. Отправьте и проверьте запуски рабочего процесса

​

Шаг 6: Активируйте

​

Обработка разных структур данных

​

Вложенные данные

{
  "contact": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "source": "website"
}

​

Массивы

{
  "items": [
    {"name": "Product A", "qty": 2},
    {"name": "Product B", "qty": 1}
  ]
}

export const main = async (params: { items: any }) => {
  const items = typeof params.items === "string"
    ? JSON.parse(params.items)
    : params.items;
  return { items };
};

export const main = async (params: { items: any }) => {
  const items = typeof params.items === "string"
    ? JSON.parse(params.items)
    : params.items;

  return {
    product: {
      name: items[0]?.name || "",
      qty: items[0]?.qty || 0
    }
  };
};

​

Связанные материалы

• Триггеры рабочего процесса
• Действия рабочего процесса