Leads do Kommo no WhatsApp
O Kommo junta seus leads de formulários, anúncios e chats. Com esta integração, cada lead novo recebe seu WhatsApp do seu número ChatSales em minutos e, quando você o move para a etapa de venda ganha, recebe seu agradecimento. A conversa continua na sua caixa de entrada do ChatSales.
O que faz e o que não faz
| ✅ Pode | 🚫 Não pode |
|---|---|
| Dar boas-vindas no WhatsApp a cada lead novo do Kommo, do seu número ChatSales, em minutos. | Escrever para leads cujo contato não tem telefone no Kommo. |
| Agradecer o cliente quando você move o lead para a etapa de venda ganha (Closed - won). | Escrever sobre leads criados há horas ou importados em massa (só leads recentes recebem boas-vindas). |
| Registrar o webhook no Kommo por você (nada para colar) e removê-lo se você desconectar. | Mudar leads, etapas ou contatos: só os lê e gerencia o próprio webhook. |
| Se o Kommo já conversa com esse lead no WhatsApp, desative «Lead novo» para não enviar duas mensagens. |
🔐 O token de longa duração do Kommo age com as permissões do administrador que o criou. O ChatSales o guarda criptografado e só o usa para ler leads e contatos e criar ou remover o webhook. Você pode revogá-lo quando quiser no Kommo (aba Autorização da integração).
Antes de começar
Você precisa de:
Um número do WhatsApp API conectado no ChatSales (Conecte seu WhatsApp). Estas mensagens são o primeiro contato com quem ainda não te escreveu, então o WhatsApp só as permite com um modelo aprovado pela Meta.
Ser administrador da sua equipe no ChatSales e ter acesso à sua conta do Kommo.
Abra a App Store
No menu à esquerda entre em App Store e clique em Criar (1).
Escolha Kommo
Procure o cartão Kommo (1) e clique nele. Você também o encontra com o filtro CRM.
No Kommo: crie um token de longa duração
Você precisa ser administrador no Kommo, no plano Avançado ou superior (o Kommo só permite webhooks via API nesses planos). No Kommo vá em Configurações → Integrações → Criar integração (privada) e salve. Na aba «Keys and scopes» clique em «Generate long-lived token», escolha a validade e copie o token: o Kommo o mostra uma única vez.
Cole o endereço do Kommo e o token, e salve
No ChatSales cole o endereço (suaempresa.kommo.com) (1) e o token (2), e clique em Salvar (3). O ChatSales confere com o Kommo, registra o webhook na sua conta e cria 2 modelos no seu número do WhatsApp API: boas-vindas e agradecimento.
Pronto: nada para colar no Kommo
Você vê Conectado a com o nome da sua conta Kommo (1). O ChatSales registrou o webhook no Kommo; se você desconectar, nós o removemos.
Confira se chega
Crie um lead de teste com seu número no contato: você recebe as boas-vindas e em Atividade (1) as vê como Enviado. Mova-o para a etapa de venda ganha: você recebe o agradecimento.
A mensagem (opcional)
Em Mensagem você vê o status do modelo na Meta (1) e o texto que é enviado. Para personalizar, escolha outro fluxo ou crie um (2): a Meta precisa aprovar. O interruptor (3) desliga. Clique em Salvar.
Regras que protegem seu número
Para que um formulário público não seja usado para fazer seu número escrever para desconhecidos: uma mensagem por número a cada 24 h, e no máximo 60 por hora e 300 por dia por app. O que passar do limite fica em Atividade com o motivo.
Números sem código de país são tratados como do México (+52) por padrão. Se você recebe contatos de outros países, desligue em Conexão e só escreveremos para números com «+código».
Adicione ao formulário um texto de consentimento (por exemplo «Aceito ser contatado pelo WhatsApp»): o WhatsApp exige que a pessoa aceite receber mensagens da sua empresa.
Encontre depois
Seus apps conectados aparecem no topo da App Store, em Seus apps (1), com o que falta fazer. Clique em Kommo para abrir.
Problemas comuns
Um lead não recebeu as boas-vindas. Só leads recentes (criados nas últimas horas) com telefone no contato principal recebem; se o contato ainda não tinha número, recebe quando tiver e o lead mudar de etapa. Se o Kommo já conversa com esse lead no WhatsApp, desative «Lead novo» para não enviar duas mensagens.
Vejo «O Kommo recusou o token». O token venceu ou foi revogado: gere um novo na sua integração do Kommo, cole em Conexão e salve.
Ao salvar diz que o token não pode criar webhooks. Precisa ser de um administrador, no plano Avançado do Kommo ou superior.
Quero parar de usar. Em Conexão clique em Desconectar: a URL para de funcionar e a atividade deste app é apagada.