Toolzz: suporte brasileiro para integração de chatbots com CRM
Aprenda a integrar chatbots Toolzz Bots com seu CRM externo via API e otimize a gestão de leads.
Toolzz: suporte brasileiro para integração de chatbots com CRM
19 de abril de 2026
Chatbots são ferramentas poderosas para qualificação de leads e coleta de informações. Mas o verdadeiro valor reside na integração desses dados com seu CRM, permitindo um acompanhamento mais eficiente e personalizado. Neste tutorial técnico, vamos explorar como integrar um chatbot criado com a API do Toolzz Bots a um CRM externo, automatizando o fluxo de informações e otimizando o trabalho da sua equipe de vendas.
Pré-requisitos
Para acompanhar este tutorial, você precisará de:
- Uma conta ativa no Toolzz Bots.
- Um workspace criado dentro da plataforma.
- Um CRM externo com API disponível (ex: Pipedrive, HubSpot, Salesforce).
- Um token de API do Toolzz Bots. Para obtê-lo, acesse seu workspace, vá em Configurações → API Keys e gere um novo token.
Arquitetura
O fluxo de integração pode ser resumido da seguinte forma:
- Usuário: Interage com o chatbot através de um canal de comunicação (WhatsApp, Website, etc.).
- Canal: Envia a mensagem do usuário para a API do Toolzz Bots.
- Toolzz Bot: Processa a mensagem com base na lógica visual definida.
- Lógica Visual: Extrai informações relevantes (nome, e-mail, telefone, etc.).
- Resultado: A API do Toolzz Bots retorna os dados coletados.
- Integração: Uma aplicação externa (ou webhook) consome os resultados da API e os envia para o CRM.
Configuração no produto
Primeiro, precisamos criar um fluxo simples no Toolzz Bots para coletar informações de um lead. Crie um bot com as seguintes etapas:
- Saudação: Mensagem de boas-vindas.
- Pergunta Nome: Solicite o nome do usuário.
- Pergunta E-mail: Solicite o e-mail do usuário.
- Pergunta Telefone: Solicite o telefone do usuário.
- Confirmação: Exiba um resumo das informações coletadas.
Após criar o fluxo, publique o bot e obtenha o ID do bot. Este ID será necessário para as chamadas à API.
Quer ver como o Toolzz Bots pode simplificar a coleta de dados dos seus leads? Conheça a Toolzz e comece a criar seus chatbots agora mesmo.
Implementação via API
Agora, vamos implementar a integração com o CRM. Usaremos a API do Toolzz Bots para obter os resultados do chatbot e, em seguida, enviaremos esses dados para o CRM.
1. List Results
Este endpoint permite listar os resultados de um bot.
- URL:
https://api.toolzz.ai/bots/v1/results - Método:
GET - Headers:
Authorization: Bearer <seu_token_api>Toolzz-Workspace: <seu_workspace_id>
- Parâmetros:
bot_id: ID do bot do qual você deseja obter os resultados.
| Parâmetro | Obrigatório | Tipo | Descrição | Exemplo |
|---|---|---|---|---|
| bot_id | Sim | string | ID do bot. | bot_12345678 |
Exemplo em Python:
python import requests
api_token = "seu_token_api" workspace_id = "seu_workspace_id" bot_id = "bot_12345678"
headers = { "Authorization": f"Bearer {api_token}", "Toolzz-Workspace": workspace_id }
response = requests.get(f"https://api.toolzz.ai/bots/v1/results?bot_id={bot_id}", headers=headers)
if response.status_code == 200: results = response.json() print(results) else: print(f"Erro: {response.status_code} - {response.text}")
Exemplo de Response JSON:
{ "results": [ { "id": "result_87654321", "bot_id": "bot_12345678", "chat_id": "chat_98765432", "data": { "nome": "João da Silva", "email": "[email protected]", "telefone": "11999999999" }, "created_at": "2024-10-27T10:00:00Z" } ] }
2. Get a Result
Se você já conhece o ID do resultado, pode usá-lo para obter informações detalhadas.
- URL:
https://api.toolzz.ai/bots/v1/results/{result_id} - Método:
GET - Headers:
Authorization: Bearer <seu_token_api>Toolzz-Workspace: <seu_workspace_id>
Exemplo em JavaScript:
javascript const apiToken = 'seu_token_api'; const workspaceId = 'seu_workspace_id'; const resultId = 'result_87654321';
fetch(https://api.toolzz.ai/bots/v1/results/${resultId}, {
method: 'GET',
headers: {
'Authorization': Bearer ${apiToken},
'Toolzz-Workspace': workspaceId
}
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
A integração entre chatbots e CRMs, como demonstramos, é muito mais simples com a Toolzz. Se você busca uma solução completa e com suporte em português, verifique nossos planos e encontre o ideal para sua empresa.
Testando
Após configurar a integração, teste o chatbot e verifique se os dados estão sendo enviados corretamente para o seu CRM. Utilize o Preview Chat do Toolzz Bots para simular a interação com o bot antes de publicar.
Quer colocar a mão na massa?
Solicitar demonstraçãoErros comuns
- Token de API inválido: Verifique se o token está correto e se você tem permissão para acessar o recurso.
- Workspace ID inválido: Verifique se o ID do workspace está correto.
- Formato dos dados incorreto: Certifique-se de que os dados enviados para o CRM estão no formato esperado.
- Erros de rede: Verifique sua conexão com a internet.
Conclusão
Integrar chatbots com CRMs é fundamental para otimizar a gestão de leads e o processo de vendas. A API do Toolzz Bots oferece a flexibilidade necessária para criar integrações personalizadas e automatizar o fluxo de informações. Ao combinar a facilidade de uso do Toolzz Bots com o poder da integração, você pode aumentar a eficiência da sua equipe e melhorar a experiência do cliente.
Configuração do ToolzzVoice
Veja como configurar agentes de voz e ligações telefônicas com IA no Toolzz Voice.
.webp){kind=small}
