Configurar un disparador de webhook

Los disparadores de webhook permiten que servicios externos inicien tus flujos de trabajo enviando datos a una URL única. Úsalos para conectar formularios, aplicaciones de terceros e integraciones personalizadas.

Cuándo usar webhooks

Caso de uso	Ejemplo
Formularios web	Los envíos del formulario de contacto crean clientes potenciales
Aplicaciones de terceros	Pago de Stripe → crear registro de cliente
Integraciones personalizadas	Tu aplicación → Automatización de Twenty
Herramientas sin código	Conexiones con Zapier, Make, n8n

Configuración paso a paso

Paso 1: Crear el flujo de trabajo

Ve a Configuración → Flujos de trabajo
Haz clic en + Nuevo flujo de trabajo
Ponle un nombre (p. ej., “Envío de formulario del sitio web”)

Paso 2: Configurar el disparador de webhook

Haz clic en el bloque del disparador
Selecciona Webhook

Recibirás una URL de webhook única como:

https://api.twenty.com/webhooks/workflow/abc123...

Copia esta URL; la necesitarás para tu servicio externo

Paso 3: Definir la estructura de datos esperada

Para solicitudes POST, define la estructura esperada del cuerpo:

Haz clic en Definir cuerpo esperado
Introduce un JSON de ejemplo que coincida con lo que enviará tu servicio:

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

Haz clic en Guardar—esto crea variables que puedes usar en pasos posteriores

Paso 4: Agregar acciones

Ahora agrega acciones que utilicen los datos del webhook: Ejemplo: Crear un registro de Persona

Añade la acción Crear registro
Selecciona el objeto Personas
Asigna los campos:

Campo	Valor
Nombre	`{{trigger.body.firstName}}`
Apellidos	`{{trigger.body.lastName}}`
Correo electrónico	`{{trigger.body.email}}`
Empresa	Buscar o crear según `{{trigger.body.company}}`

Paso 5: Probar el webhook

Antes de activarlo, prueba tu webhook: Usando cURL:

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

Usando Postman o similar:

Crea una solicitud POST a tu URL de webhook
Establece el encabezado Content-Type en application/json
Añade tu cuerpo JSON de prueba
Envía y verifica las ejecuciones del flujo de trabajo

Paso 6: Activar

Una vez probado, haz clic en Activar para poner el flujo de trabajo en marcha.

Cómo manejar diferentes estructuras de datos

Datos anidados

Si tu webhook envía datos anidados:

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

Haz referencia con: {{trigger.body.contact.email}}

Arrays

Si los datos incluyen arrays:

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

Cómo manejes los arrays depende de tu caso de uso: Número desconocido de elementos → Usa Iterator Si necesitas procesar cada elemento del array (p. ej., crear un registro para cada uno), añade una acción Code para analizar el array y luego usa Iterator:

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

Luego usa Iterator para iterar: {{code.items}} Campos conocidos/específicos → Extraer a campos con nombre Si el array contiene campos específicos a los que quieres acceder individualmente (p. ej., respuestas de formulario donde la posición 0 siempre es “nombre”, la posición 1 siempre es “apellido”), añade una acción Code para extraerlos:

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
    }
  };
};

Ahora puedes seleccionar product.name y product.qty individualmente en pasos posteriores.

Para más detalles sobre cómo manejar arrays, consulta Cómo manejar arrays en acciones de código.

Overview

Modelo de datos

Migración de datos

Calendario y correos electrónicos

Flujos de trabajo

IA

Layout

Tableros

Permisos y acceso

Facturación

Configuración

Configurar un disparador de webhook

Cuándo usar webhooks

Configuración paso a paso

Paso 1: Crear el flujo de trabajo

Paso 2: Configurar el disparador de webhook

Paso 3: Definir la estructura de datos esperada

Paso 4: Agregar acciones

Paso 5: Probar el webhook

Paso 6: Activar

Cómo manejar diferentes estructuras de datos

Datos anidados

Arrays

Relacionado

​Cuándo usar webhooks

​Configuración paso a paso

​Paso 1: Crear el flujo de trabajo

​Paso 2: Configurar el disparador de webhook

​Paso 3: Definir la estructura de datos esperada

​Paso 4: Agregar acciones

​Paso 5: Probar el webhook

​Paso 6: Activar

​Cómo manejar diferentes estructuras de datos

​Datos anidados

​Arrays

​Relacionado

Cuándo usar webhooks

Configuración paso a paso

Paso 1: Crear el flujo de trabajo

Paso 2: Configurar el disparador de webhook

Paso 3: Definir la estructura de datos esperada

Paso 4: Agregar acciones

Paso 5: Probar el webhook

Paso 6: Activar

Cómo manejar diferentes estructuras de datos

Datos anidados

Arrays

Relacionado