WebHooks

WebHooks in digital pipeline

Webhooks is the notification of third-party applications by sending notifications of events that occurred in Kommo. You can configure the HTTP addresses of your applications and associated working rules in the digital pipeline settings, in Kommo.

More information about the technology can be found in the WebHooks REST API section. However, despite the fact that the technology used for notifying Webhooks in the digital pipeline is the same as in the settings section of your account (“Settings -> Integration”), it has several differences.

• The first difference, a more limited list of events for which the sending of notifications will respond.
• The second difference, from the digital pipeline, unlike the account settings, webhook is sent only once, for the event that occurred. No retry attempts.

List of possible events:

• With an outgoing letter
• With incoming call
• When you receive a chat message
• When you visit the site
• When going to step

To create a webhook

Go to the digital pipeline settings menu from the Deals section and choose to add an automatic action for all trades, under the stage you want.

Then select “API: send webhook”.

Select the event where the webhook will be sent.

Enter the URL where the webhook will be sent.

Format of the data to be sent

Webhook sends a variable to a third-party POST application that contains an array of the form {“entity”: {“action”: {array of entity fields}}}.

Parameters

Event Settings

Field Parameters of the Entity

Example

With the incoming letter, for the lead

{
    "leads": {
        "mail_in": {[
            "id": 4921027,          
            "pipeline_id": 752662,  
            "status_id": 16203334  
        ]}
    }
}

When going to the stage, for the lead

{
    "leads": {
        "status": {[
            "id": 4831596,              
            "old_pipeline_id": 752662,
            "pipeline_id": 752662,    
            "old_status_id": 16203334  
            "status_id": 16203337      
        ]}
    }
}

When the period changes, for the buyer

{
    "customers": {
        "period": {[
            "id": 4831596,              
            "old_period_id": 16203334  
            "period_id": 16203337      
        ]}
    }
}