Este guia explica como utilizar o Dify para enviar requisições HTTP diretamente ao Kommo CRM, atualizando automaticamente informações em leads ou contatos por meio do widget ByteGPT.
🔎 Quadro Comparativo: Webhook ByteGPT vs API Direta Kommo
A seguir, veja um comparativo prático entre usar os webhooks prontos do ByteGPT e a API tradicional do Kommo, destacando por que o método via ByteGPT é mais simples e direto para quem integra com Dify.
| Característica | Webhook do ByteGPT | API Oficial Kommo |
|---|---|---|
| Autenticação | Não precisa de token | Requer token de longa duração |
| Cabeçalhos (Headers) | Não requer | Obrigatório (Authorization + Content-Type) |
| Corpo da Requisição | Não precisa (usa apenas parâmetros) | Obrigatório (JSON estruturado) |
| Facilidade de uso no Dify | Muito simples (GET com parâmetros) | Requer POST com payload customizado |
| Atualização múltipla de campos | Sim, com vários field[...] | Sim, mas exige JSON mais complexo |
| Pronto para uso no ByteGPT | Sim, já vem com URLs personalizadas | Precisa construir tudo do zero |
🔧 Pré-requisitos
- Widget ByteGPT ativo no Kommo CRM;
- Aplicativo Dify configurado corretamente.
🚀 Passo a Passo para Integração
1. Acesse o Widget ByteGPT no Kommo
- Entre no Kommo CRM, vá até Configurações > Integrações > ByteGPT;
- Clique na aba “Campos Ativos”;
- Nesta aba, você terá acesso a:
- URLs dos Webhooks (EndPoints) disponíveis (para atualização de leads, contatos, pausa, etc.);
- Você encontrará uma lista com diferentes webhooks ou endpoints disponíveis, como UPDATE e PAUSE. Copie o webhook específico que deseja utilizar e guarde-o para colar posteriormente no campo de URL da requisição HTTP no Dify.
- IDs dos campos customizados ativos em sua conta Kommo.
- URLs dos Webhooks (EndPoints) disponíveis (para atualização de leads, contatos, pausa, etc.);
2. Configure o Bloco HTTP Request no Dify
No bloco HTTP do seu fluxo no Dify, configure da seguinte forma:
- Método HTTP:
GET - URL: Cole aqui a URL do webhook copiado.
- Cabeçalhos (Headers): Deixe vazio.
- Parâmetros: Preencha as chaves e os valores, conforme instruções abaixo.
- Corpo (Body): Selecione
none.
Exemplo:
📝 Parâmetros da Requisição
Obrigatórios:
| Chave | Valor | Descrição |
|---|---|---|
entity | leads ou contacts | Entidade a ser atualizada |
entity_id | {{sys.user_id}} | ID do lead ou contato |
field[ID] | valor ou {{variável Dify}} | Ao menos 1 campo para atualizar |
Exemplo prático:
Imagine que um usuário deseja automatizar a atualização de informações de leads no Kommo CRM, utilizando o Dify e o widget ByteGPT. Especificamente, ele precisa configurar um fluxo no Dify para:
- Atualizar um campo customizado: O campo com o ID
1567115(que poderia ser encontrado na aba “Campos Ativos”) deve receber o resultado gerado por uma LLM, obtido através de um agregador de variáveis no Dify, ficandofield[1567115]e o respectivo valor da variável da LLM, do Dify. - Alterar a etapa da pipeline (status): A etapa da pipeline, identificada pelo
field[status_id]e o valor73814828, que representa “Venda Ganha”, deve ser atualizada.
Para isso, o usuário irá configurar um bloco “HTTP Request” no Dify, utilizando os parâmetros mostrados na imagem e as variáveis dinâmicas do Dify para inserir os dados necessários.
✅ Execução e Validação
Ao executar esse bloco no Dify, o sistema envia automaticamente uma requisição HTTP para o Kommo via ByteGPT, atualizando os campos especificados imediatamente.
💡 Dicas Adicionais
- Você pode atualizar outros campos nativos diretamente usando o nome do campo como parâmetro:
field[name]: Nome do lead ou contatofield[status_id]: ID da etapa (status) na Pipeline (funil)field[pipeline_id]: ID da Pipeline (funil)field[price]: Valor monetáriofield[responsible_user_id]: ID do usuário responsável no Kommo
- Utilize variáveis do Dify para preencher automaticamente valores com respostas dinâmicas do seu assistente.
- Verifique os IDs corretos dos campos customizados de sua conta na aba Campos Ativos do widget ByteGPT.
- Esta automação garante eficiência e agilidade nas atualizações do seu CRM em tempo real.
- Você pode ativar um Salesbot automaticamente ao atualizar um campo específico, usando o gatilho do Kommo que dispara fluxos com base na alteração desse campo.