Como atualizar campos do Kommo usando ByteGPT + n8n

Esse guia mostra como configurar o n8n para responder mensagens, alterar campos e o estágio dos leads na Kommo utilizando como meio o ByteGPT.

🔧 Pré-requisitos

• Widget ByteGPT ativo no Kommo CRM;
• Chave API da OpenAI, para transcrição de áudios e análise de arquivos (Opcional);
• Template padrão para uso no n8n: JSON (Chat e Webhook Trigger) (Opcional).

🚀 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, UPDATE STATUS_ID 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 n8n.
  • IDs dos campos customizados ativos em sua conta Kommo.
    • Campos ativos do ByteGPT na instalação atual;
    • Campos customizados de Leads e Contatos;
    • Ids de Pipeline de vendas do Lead;
    • Etapas de cada etapa do Lead no Kommo.

Mapeamento de campos da conta Kommo:

2. Configure o bloco HTTP request no n8n

Faça a configuração da seguinte forma:

• Método HTTP: GET
• URL: Insira a URL do webhook copiado na aba de campos de ativos do ByteGPT (update, status_id ou pause)
• Cabeçalhos (Headers): Deixe desabilitado.
• Corpo (Body): Deixe desabilitado.
• Parâmetros: Preencha as chaves e os valores, conforme instruções abaixo.

Exemplo:

📝 Parâmetros da Requisição

Chave	Valor	Descrição
entity	leads ou contacts	Entidade a ser atualizada
entity_id	{{ $('When chat message received').first().json.leadId }}	ID do lead ou contato
field[ID]	valor ou variável do n8n	Campo Kommo seguido pelo seu respectivo ID
field[status_id]	ID do estágio no Kommo	ID da etapa onde será movido o lead

Exemplo prático

Imagine um cenário onde o usuário deseja automatizar o preenchimento de campo e movimentação de lead no Kommo CRM utilizando n8n e o widget ByteGPT. O fluxo utilizado, servirá para:

1. Atualizar um campo customizado: O campo com o ID 1567115 (encontrado na aba “Campos Ativos”) deve receber o resultado gerado por uma LLM, ou inserido manualmente, ficando field[1567115] e o respectivo valor da variável.
2. Alterar a etapa da pipeline (status): A etapa da pipeline, identificada pelo field[status_ID] e o valor 73814828, que representa “Venda Ganha”, deve ser atualizada.

Para isso, o usuário irá configurar um bloco “HTTP Request” no n8n, utilizando os parâmetros mostrados na imagem e as variáveis do n8n para inserir os dados necessários.

✅ Execução e Validação

Ao executar esse bloco no n8n, 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 contato
• field[status_id]: ID da etapa (status) na Pipeline (funil)
• field[pipeline_id]: ID da Pipeline (funil)
• field[price]: Valor monetário
• field[responsible_user_id]: ID do usuário responsável no Kommo

Utilize variáveis do n8n, geradas a partir da execução de uma LLM 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.