Integração Kommo + Leavo

Conecte o Leavo ao Kommo para uma gestão completa de leads e vendas. Sincronize contatos, automatize follow-ups e acompanhe seu pipeline.

CRM5 min de leitura

Teste 7 dias grátis Agendar demo

Integração via Webhook – Kommo + Leavo

1. Visão Geral

A Kommo (anteriormente amoCRM) é uma plataforma de Customer Relationship Management (CRM) focada em automação de vendas e comunicação via mensageiros. A integração via Webhook com o Leavo permite sincronização automática entre o Kommo e o Leavo para qualificação de leads, automação de follow-up e gestão inteligente do funil de vendas.

Casos de uso principais:

Receber leads do Kommo para qualificação via IA
Enviar leads qualificados do Leavo para o Kommo
Sincronizar status entre sistemas em tempo real
Automatizar follow-up de leads frios

Fluxos disponíveis:

✅ Kommo → Leavo: Kommo envia webhooks quando leads mudam de status
✅ Leavo → Kommo: Leavo envia leads qualificados para o CRM

2. Documentação Oficial

Kommo:

Leavo:

Painel de Webhooks

3. Recursos disponíveis via Webhook

A Kommo suporta o envio e recebimento de notificações (Webhooks) bidirecionalmente.

Entidade	Eventos Suportados
Leads	Adicionado, Editado, Apagado, Restaurado, Estágio alterado, Responsável alterado
Contatos	Adicionado, Editado, Apagado, Restaurado, Responsável alterado
Empresas	Adicionada, Editada, Apagada, Restaurada, Responsável alterado
Tarefas	Adicionada, Editada, Apagada, Responsável alterado

4. Como configurar webhooks

4.1 FLUXO 1: Kommo enviando webhooks para o Leavo

Este fluxo permite que o Kommo notifique o Leavo quando eventos importantes acontecem no CRM.

Passo 1: Criar Webhook de Entrada no Leavo

Acesse https://app.leavo.ai/pt-BR/ai-settings/webhooks
Clique na aba "Entrada" (ícone de seta para baixo)
Clique em "+ Criar Webhook"

No modal:

Nome: Leads Kommo - Funil Principal
Descrição: Recebe leads que entram na etapa de qualificação
Webhook ativo: LIGADO
Clique em "Criar Webhook"

Passo 2: Configurar Webhook no Kommo

Opção A: Webhooks por Automação de Funil (Recomendado)

Acesse Vendas → Funis no Kommo
Selecione o funil desejado
Clique na etapa específica
Clique em "Automatize" (ícone de raio ⚡)
Selecione "Webhook"
Configure:
- URL de destino: Cole a URL gerada pelo Leavo
- Método HTTP: POST
- Trigger: "Quando o lead entrar nesta etapa"
Clique em Salvar

Opção B: Webhooks Globais

Vá para Configurações → Integrações
Clique em "Webhooks"
Clique em "Adicionar webhook"
Insira a URL do Leavo
Selecione os Eventos: Lead adicionado, Lead editado, Status alterado
Clique em Salvar

Nota: Webhooks requerem planos Avançado ou Empresarial do Kommo.

Passo 3: Estrutura do Payload Enviado pelo Kommo

{
  "leads": {
    "update": [
      {
        "id": "12345678",
        "name": "João Silva - Interesse em Solar",
        "status_id": "42867890",
        "pipeline_id": "3456789",
        "price": 15000,
        "custom_fields_values": [
          {
            "field_code": "PHONE",
            "values": [{"value": "+5511999999999"}]
          },
          {
            "field_code": "EMAIL",
            "values": [{"value": "joao.silva@email.com"}]
          }
        ]
      }
    ]
  },
  "account": {
    "subdomain": "sua-empresa",
    "id": "31234567"
  }
}

Passo 4: Mapear Campos no Leavo

Campo do Lead	Campo do Payload
Nome *	`leads.update[0].name`
E-mail	`leads.update[0].custom_fields_values[1].values[0].value`
Telefone *	`leads.update[0].custom_fields_values[0].values[0].value`

4.2 FLUXO 2: Leavo enviando webhooks para o Kommo

Este fluxo permite enviar leads qualificados do Leavo para o Kommo automaticamente.

Passo 1: Criar Webhook de Saída no Leavo

Vá em Webhooks no Leavo
Clique na aba "Saída" (ícone de avião de papel)
Clique em "+ Criar Webhook de Saída"

Configurar:

Nome: Integração CRM Kommo
URL de Destino: URL do webhook do Kommo
Trigger: Criação de Lead OU Mudança de Status

Passo 2: Mapear Campos de Saída

Estrutura que o Kommo espera:

{
  "leads": [
    {
      "name": "Nome do Lead",
      "price": 5000,
      "custom_fields_values": [
        {
          "field_code": "PHONE",
          "values": [{"value": "+5511999999999"}]
        },
        {
          "field_code": "EMAIL",
          "values": [{"value": "email@example.com"}]
        }
      ]
    }
  ]
}

Mapeamento:

Campo no destino	Campo do Leavo
`leads[0].name`	`nome`
`leads[0].custom_fields_values[0].field_code`	(fixo: "PHONE")
`leads[0].custom_fields_values[0].values[0].value`	`telefone`
`leads[0].custom_fields_values[1].field_code`	(fixo: "EMAIL")
`leads[0].custom_fields_values[1].values[0].value`	`email`

5. Observações e Limitações

5.1 Limitações do Kommo

Aspecto	Limitação
Rate Limiting	7 requisições/segundo
Timeout de resposta	5 segundos
Tentativas de reenvio	3 tentativas com intervalos exponenciais
Tamanho do payload	~1 MB
Requisito de Plano	Avançado ou Empresarial

5.2 Estrutura de Arrays

⚠️ CRÍTICO: O Kommo espera estruturas de array:

✅ Correto: "leads": [{ ... }]
❌ Errado: "leads": { ... }
✅ Correto: "values": [{ "value": "..." }]
❌ Errado: "values": { "value": "..." }

6. Troubleshooting

6.1 Lead não está sendo criado no Kommo

Causa	Solução
Estrutura de payload incorreta	✅ Verifique se tem `leads[0]` (array)
field_code incorreto	✅ Use "PHONE" (maiúsculo) não "phone"
Campos obrigatórios faltando	✅ Campo `name` é obrigatório
Rate limit excedido	✅ Não envie mais de 7 req/segundo