Visão geral do processo
Este guia detalhado irá orientá-lo através do processo de integração da poderosa ferramenta de automação de fluxo de trabalho, n8n, com a sua Kommo CRM, utilizando a integração ByteGPT. Esta conexão permitirá que você crie chatbots inteligentes e automatize conversas de forma avançada.
A integração consiste em configurar o ByteGPT dentro da Kommo para atuar como uma ponte, conectando-se a um fluxo de trabalho (workflow) específico no n8n. Este fluxo no n8n, por sua vez, poderá utilizar o poder dos modelos OpenAI para processar e responder às mensagens. Finalmente, um Salesbot na Kommo será configurado para acionar e gerenciar essa interação.
Passo 1: Configurando a Integração ByteGPT na Kommo
Acesse as configurações e encontre o ByteGPT
- No menu lateral esquerdo da Kommo, clique em “Configurações”.
- Na seção “Integrações”, utilize a barra de pesquisa e digite “ByteGPT”.
- Clique na integração “ByteGPT+ (Plus) via Bytebio” para abrir suas configurações.
Adicione o provedor n8n (chat)
- Dentro da janela de configurações do ByteGPT, na aba “Settings”, localize a seção “AI Providers” e clique em “Adicione +“.
- Uma janela “Select the Providers” será exibida. Na lista suspensa, selecione a opção “n8n – Chat Trigger“.
- Ao selecionar, dois novos campos aparecerão: “OpenAI Key” e “Chat Trigger URL”. Estes campos serão preenchidos nas etapas seguintes.
Passo 2: Criando e configurando o fluxo de trabalho no n8n
Baixe o template para o n8n: JSON (Chat e Webhook Trigger)
Importe o Template no n8n
- Acesse sua conta n8n e crie um novo fluxo de trabalho (“My workflow 1” ou um novo).
Clique no menu de três pontos (…) localizado no canto superior direito e selecione “Import from File…“. - Selecione o arquivo .json que você acabou de baixar.
O fluxo de trabalho com três nós principais será carregado na sua tela: “When chat message received“, “OpenAI Message Assistant” e “Respond to Webhook“.
Configure o nó da OpenAI
- Clique no nó “OpenAI Message Assistant” para abrir suas configurações.
- No campo “Credential to connect with“, você precisará adicionar suas credenciais do OpenAI. Se já tiver uma configurada, selecione-a na lista. Caso contrário, crie uma nova.
- Certifique-se de que os outros parâmetros estão corretos, conforme o template importado
Ative o Fluxo de Trabalho e realize um teste
- No canto superior direito da tela do n8n, ative o fluxo de trabalho movendo o seletor de “Inactive” para “Active“.
- Para garantir que tudo está funcionando, abra a janela de chat de teste clicando em “Open chat” e envie uma mensagem de teste, como “Bom dia”.
- Observe a execução do fluxo. Se os nós ficarem verdes e você vir a resposta do assistente, o teste foi bem-sucedido.
Obtenha a URL do chat (Webhook)
- Clique no primeiro nó, “When chat message received“.
- No painel de parâmetros à esquerda, você encontrará o campo “Chat URL“. Esta é a URL que conecta a Kommo ao seu fluxo de trabalho n8n.
- Clique para copiar a URL.
Passo 3: Finalizando a configuração na Kommo
Insira as credenciais no ByteGPT
- Volte para a janela de configurações do ByteGPT na Kommo.
- Cole a URL que você copiou do n8n no campo “Chat Trigger URL“.
- Insira sua chave da OpenAI no campo “OpenAI Key“.
- Clique em “Salvar“. O sistema irá submeter e salvar as informações.
Baixe e importe o template do salesbot
- Ainda na janela de configurações do ByteGPT, role para baixo até encontrar a seção de templates do Salesbot.
- Localize o template “v2 – N8N – Chat Trigger” e clique em “Baixar“. O arquivo será carregado e baixado.
- Agora, vá para “Configuração” > “Ferramentas de comunicação” no menu lateral da Kommo.
- Clique em “Criar ou acionar um novo bot” e importe o arquivo do Salesbot que você baixou.
Configure o salesbot
- Com o Salesbot importado, você pode personalizar o gatilho (“Trigger”). Por exemplo, você pode configurar o bot para iniciar “Quando uma conversa é iniciada por uma nova mensagem em qualquer canal”.
- Se preferir, pode adaptar o fluxo para a conversa começar diretamente, sem a etapa de pausa inicial, conectando o “Start bot” diretamente às próximas etapas.
Passo 4: Teste final da integração
Inicie uma conversa
- Acesse um dos seus canais de comunicação conectados à Kommo (como o Live Chat do seu site, WhatsApp, etc.).
- Envie uma mensagem de teste, como “Bom dia”.
Verifique a resposta e os dados
- A mensagem deve aparecer no seu “Inbox” da Kommo.
- O Salesbot será acionado, enviará a informação para o n8n, que processará com a OpenAI e devolverá a resposta.
- Você verá a resposta automática “Olá, como podemos ajudar?” na conversa.
- Dentro do card do lead na Kommo, na aba “ByteGPT+”, você poderá ver os detalhes da interação, como o prompt enviado e a resposta recebida.
- No n8n, na aba “Executions“, você poderá ver um log da execução bem-sucedida do seu fluxo de trabalho.