Webhook

Webhook

Descripción general

La acción "Webhook" permite enviar datos a sistemas externos a través de solicitudes HTTP POST. Esto resulta especialmente útil para la integración con aplicaciones de terceros, la automatización de transferencias de datos o la activación de eventos en otras plataformas en función de las condiciones del flujo de trabajo. Un ejemplo de ello son los envíos de formularios a otra plataforma.

La acción "Webhook" envía una solicitud HTTP POST o GET a una URL específica y transfiere datos a una aplicación o servicio externo. Esta acción se puede utilizar para activar automatizaciones en sistemas de terceros, actualizar bases de datos externas o enviar datos a API personalizadas. La acción brinda flexibilidad para integrar flujos de trabajo con otras herramientas.

Detalles de la acción

Guía paso a paso

1. Elija el tipo de acción:

   • Seleccione “Webhook” de la lista de acciones disponibles en el generador de flujo de trabajo.

2. Nombra tu acción:

   • Ingrese un nombre descriptivo para la acción, como "Enviar información de contacto a CRM externo".

3. Introduzca la URL del webhook:

   • Proporcione la URL de la aplicación externa a la que se deben enviar los datos. Normalmente, se trata de una URL de punto final proporcionada por sistemas de terceros, como CRM, herramientas de marketing por correo electrónico u otras API.

4. Configurar carga útil:

   • Define los datos que se enviarán a través del webhook mediante el formato JSON. Puedes utilizar campos de combinación para incorporar dinámicamente información como detalles de contacto, estado de la oportunidad o campos personalizados. Ejemplo:

     { 
         "first_name": "{{contact.first_name}}", 
         "last_name": "{{contact.last_name}}", 
         "email": "{{contact.email}}", 
         "phone": "{{contact.phone}}", 
         "status": "{{contact.status}}"
     }

5. Agregar encabezados (opcional):

   • Si el sistema externo requiere autenticación o encabezados específicos, puede agregarlos aquí. Por ejemplo, es posible que deba incluir una clave API o un encabezado de tipo de contenido, como:

     • Authorization: Bearer <API_KEY>

     • Content-Type: application/json

6. Agregar datos personalizados (opcional):

   • Si desea enviar datos personalizados, puede agregar el par clave y valor en la acción, como por ejemplo:

     • Clave: Dirección

     • Valor: Dirección del selector de valores

   • Más información sobre los tipos de datos disponibles aquí

7. Probar webhook (opcional):

• Antes de finalizar, puedes utilizar herramientas de prueba como Webhook.site o Postman para verificar que los datos se estén enviando correctamente al sistema externo.

Ejemplo

Escenario: desea sincronizar los datos de contacto con un CRM externo cada vez que se crea un nuevo contacto.

1. Crear disparador de flujo de trabajo:

   • Configure un disparador de flujo de trabajo para que se inicie cuando se crea un nuevo contacto.

2. Agregar acción de webhook:

   • Seleccione la acción "Webhook" y nómbrela "Sincronizar contacto con CRM".

3. Introduzca la URL del webhook:

   • Proporcionar el punto final de la API de CRM para actualizaciones de contactos, por ejemplo,https://api.externaltestcrm.com/contacts/create

4. Configurar carga útil:

   • Define los datos de contacto que se enviarán en formato JSON, como {

     "first_name": "{{contact.first_name}}",
     "last_name": "{{contact.last_name}}",
     "email": "{{contact.email}}",
     "phone": "{{contact.phone}}"
     }

     JavaScript

5. Agregar encabezados:

   • Incluya todos los detalles de autenticación necesarios, como:

     • Authorization: Bearer abc123xyz

     • Content-Type: application/json

6. Guardar y activar el flujo de trabajo:

   • Una vez que el flujo de trabajo esté activo, cada vez que se cree un nuevo contacto, sus detalles se enviarán automáticamente al CRM externo.