Webhooks no Pipeline Digital

Webhooks no Pipeline Digital

Webhooks são notificações enviadas para aplicativos de terceiros para informar sobre eventos que ocorreram na Kommo. Você pode configurar os endereços HTTP dos seus aplicativos e as regras associadas nas configurações do pipeline digital da Kommo.
Mais informações sobre esta tecnologia podem ser encontradas na seção WebHooks REST API . Embora a tecnologia de Webhooks no pipeline digital seja semelhante à usada nas configurações da conta (ConfiguraçõesIntegrações🪝Web hooks), há algumas diferenças.

  • Primeiro, a lista de eventos para os quais notificações são enviadas é mais limitada.
  • Segundo, No pipeline digital, ao contrário das configurações da conta, um webhook é enviado apenas uma vez para cada evento, sem tentativas de repetição.

Lista de eventos possíveis:

  • E-mail recebido
  • Chamada recebida
  • Mensagem de chat recebida
  • Visita ao site
  • Mudança de etapa

Como criar um webhook

Acesse o Pipeline Digital (LeadsAutomatize no canto superior direito) e selecione adicionar uma ação automática para todos os negócios na etapa desejada.

Depois escolha API: + Enviar um webhook.

Selecione o evento que será o gatilho do webhook.

Insira a URL para a qual o webhook será enviado.

Formato dos dados enviados

O webhook envia uma solicitação POST para o aplicativo de terceiros contendo uma variável com o seguinte formato: {"lead":{"event":{entity fields array}}}.

Configurações de Eventos

ParâmetroDescrição
call_inEvento de chamada recebida
chatEvento de mensagem de chat recebida
site_visitEvento de visita ao site
mail_inEvento de e-mail recebido
statusEvento de mudança de etapa

Parâmetros dos campos da entidade

ParâmetroDescrição
idID do Lead
old_pipeline_idID do pipeline digital anterior
pipeline_idID do novo pipeline digital
old_status_idID da etapa anterior
status_idID da nova etapa

Exemplos

Evento de e-mail recebido:

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

Evento de mudança para outra etapa:

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