Webhook Personalizado

Custom webhook

Descripción general

La acción de webhook personalizado le permite integrarse con sistemas externos mediante el envío de datos en tiempo real a través de los métodos HTTP POST, GET, PUT y DELETE. Esta acción permite una automatización, un intercambio de datos y una interacción sin inconvenientes con servicios de terceros, API y aplicaciones personalizadas sin necesidad de codificación.

La acción de webhook personalizado permite a los usuarios enviar solicitudes HTTP a URL específicas, integrándose con servicios externos para el intercambio automático de datos. Esta acción admite varios métodos HTTP (POST, GET, PUT, DELETE), encabezados personalizables, parámetros de consulta y opciones de autenticación para satisfacer las necesidades de cualquier servicio de terceros.

Funciones compatibles:

• Métodos HTTP: POST, GET, PUT, DELETE

• Encabezados personalizados y parámetros de consulta: pase autenticación, tipo de contenido u otros datos necesarios

• Métodos de autorización: autenticación básica, token de portador, clave API y sin autenticación.

  • La autenticación básica requiere nombre de usuario y contraseña

  • El token portador requiere el token de la plataforma

  • La clave API requiere un par clave-valor del nombre de la clave y su valor, es decir, la clave API.

• Mapeo de datos: sugerencias de autocompletar para mapear valores personalizados como información de contacto, estado de clientes potenciales y más

Detalles de la acción

Guía paso a paso

1. Elija el tipo de acción:

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

2. Nombra tu acción:

   • Ingrese un nombre descriptivo, como "Enviar datos a API externa".

3. Introduzca la URL del webhook:

   • Proporcione la URL del punto final del sistema externo donde se deben enviar los datos (por ejemplo, un CRM, una pasarela de pago o una API personalizada).

4. Seleccionar método HTTP:

   • Elija entre POST, GET, PUT o DELETE según el tipo de operación de datos requerida por el servicio externo.

5. Seleccione el método de autorización (opcional):

   • Elija el método de autorización necesario, como claves API, tokens de portador o autenticación básica, para garantizar una comunicación segura con el servicio externo.

6. Configurar encabezados y parámetros de consulta (opcional):

   • Agregue cualquier encabezado requerido, como Authorization: Bearer <API_KEY>encabezados de tipo de contenido, para definir el formato de datos ( Content-Type: application/json).

   • Utilice parámetros de consulta para pasar información adicional, filtrar datos o ajustar la respuesta de la API externa.

7. Datos del mapa:

   • Inserte datos relevantes (por ejemplo, nombre de contacto, correo electrónico, número de teléfono) en el cuerpo de la solicitud. Puede estructurar la carga útil en JSON u otro formato requerido por el sistema externo. Ejemplo de carga útil:

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

1. Guardar y activar el flujo de trabajo:

   • Una vez configurado, active el flujo de trabajo. El webhook se activará y enviará datos en tiempo real según las condiciones del flujo de trabajo.

Ejemplo

Escenario: una empresa desea enviar información de contacto a un CRM externo cada vez que se crea un nuevo cliente potencial en su sistema.

1. Crear disparador de flujo de trabajo:

   • Configure un disparador de flujo de trabajo para cuando se crea un nuevo cliente potencial.

2. Agregar acción de webhook personalizada:

   • Seleccione “Webhook personalizado” y nómbrelo “Enviar datos de clientes potenciales a CRM”.

   • URL del webhook:https://api.externaltestcrm.com/leads/create

   • Método HTTP: POST

   • Carga útil

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

   • Encabezados: agregue una clave API para autenticar la solicitud

     • Authorization: Bearer xyz123

     • Content-Type: application/json

3. Probar el webhook:

   • Pruebe utilizando una herramienta como Webhook.site o Postman para confirmar que los datos se envían y reciben correctamente.

4. Guardar y activar:

   • Una vez activado, el webhook enviará automáticamente datos de clientes potenciales al CRM cada vez que se cree un nuevo cliente potencial.

Resultado: Cada nuevo cliente potencial se sincroniza con el CRM externo, lo que mejora la automatización y reduce la entrada manual de datos.