Webhooks en el pipeline digital

WebHooks en el pipeline digital

Los webhooks son notificaciones enviadas a aplicaciones de terceros para informarles sobre eventos que han ocurrido en Kommo. Puedes configurar las direcciones HTTP de tus aplicaciones y las reglas asociadas en la configuración del pipeline digital en Kommo.
Puedes encontrar más información sobre esta tecnología en la sección WebHooks REST API . Aunque la tecnología utilizada para los webhooks en el pipeline digital es similar a la que se usa en los ajustes de cuenta (Ajustes ➡ Integración ➡ 🪝Web hooks), existen varias diferencias.

• Primero, la lista de eventos para los cuales se envían notificaciones es más limitada.
• Segundo, en el pipeline digital, a diferencia de los ajustes de cuenta, un webhook se envía una sola vez por cada evento que ocurre, sin intentos de reenvío.

Lista de eventos posibles:

• Correo entrante
• Llamada entrante
• Mensaje entrante
• Visita al sitio web
• Cambio de etapa

Para crear un webhook

Dirígete al pipeline digital (Leads ➡ Automatiza en la esquina superior derecha) y selecciona añadir una acción automática para todos los leads en la etapa que necesitas.

Luego selecciona API: + Enviar un webhook.

Selecciona el evento que disparará el webhook.

Ingresa la URL a la que se enviará el webhook.

Formato de los datos a enviar

El webhook envía una solicitud POST a una aplicación de terceros que contiene una variable con el siguiente formato:{"lead":{"event":{entity fields array}}}.

Configuración de eventos

Parámetros de campo de la entidad

Ejemplos

Evento de correo entrante:

{
    "leads": {
        "mail_in": {[
            "id": XXXXXXX,          
            "pipeline_id": 1111XXX,  
            "status_id": 2222XXX  
        ]}
    }
}

Evento de cambio de etapa:

{
    "leads": {
        "status": {[
            "id": XXXXXXX,              
            "old_pipeline_id": 123XXX,
            "pipeline_id": 321XXXX,    
            "old_status_id": 567XXXX  
            "status_id": 765XXXX     
        ]}
    }
}