Toolzz: garantia de resultados em Integração CRM com Chatbots
Aprenda a integrar chatbots Toolzz Bots com seu CRM para qualificar leads e automatizar processos.
Toolzz: garantia de resultados em Integração CRM com Chatbots
2 de maio de 2026
Chatbots visuais estão revolucionando a forma como as empresas interagem com seus clientes e gerenciam seus processos de vendas. A integração com sistemas de CRM (Customer Relationship Management) é um passo crucial para otimizar a qualificação de leads, automatizar tarefas repetitivas e fornecer uma experiência do cliente mais personalizada. Neste tutorial detalhado, vamos explorar como integrar o Toolzz Bots a um CRM externo utilizando a API, demonstrando um caso de uso real e fornecendo exemplos práticos de código.
Pré-requisitos
Para acompanhar este tutorial, você precisará dos seguintes recursos:
- Conta Toolzz Bots: Crie uma conta gratuita em bots.toolzz.ai e acesse o workspace.
- Workspace: Um workspace ativo na plataforma Toolzz Bots.
- API Token: Gere um token de API para autenticar suas solicitações. Para obter seu token, vá para as configurações do seu workspace em Toolzz Bots e selecione a opção "API Tokens".
- Conhecimento Básico de API: Familiaridade com conceitos de API REST, como métodos HTTP (GET, POST, PUT, DELETE) e formatos de dados JSON.
- Acesso a um CRM: Um sistema de CRM configurado e com acesso via API (ex: Salesforce, HubSpot, Pipedrive).
Arquitetura
O fluxo de integração entre o Toolzz Bot e o CRM externo pode ser descrito da seguinte forma:
- Usuário: Inicia uma conversa com o chatbot através de um canal de comunicação (ex: WhatsApp, site, Facebook Messenger).
- Canal: O canal encaminha a mensagem do usuário para o Toolzz Bot.
- Toolzz Bot: Recebe a mensagem e processa a lógica definida no fluxo visual.
- Lógica Visual: O fluxo visual do chatbot contém perguntas, respostas, condicionais e ações, incluindo o envio de dados para o CRM.
- Resultado: O chatbot coleta informações do usuário e formata os dados em um formato adequado para o CRM.
- Integração: A API do Toolzz Bots envia os dados para o CRM, criando um novo lead, atualizando um registro existente ou executando outras ações.
Simplifique a integração do seu chatbot com o CRM e impulsione suas vendas. Conheça a Toolzz e descubra como podemos te ajudar.
Configuração no Produto
Primeiramente, configure o fluxo visual do seu chatbot no Toolzz Bots. Crie um bot com o objetivo de coletar informações de leads, como nome, e-mail, telefone e empresa. Utilize os blocos de pergunta e resposta para obter os dados do usuário e, em seguida, utilize o bloco "Webhook" para enviar os dados para a API do seu CRM.
No bloco Webhook, configure a URL da API do seu CRM, o método HTTP (geralmente POST) e o corpo da requisição em formato JSON. Utilize as variáveis do Toolzz Bots (ex: {{nome}}, {{email}}) para preencher os campos do JSON com os dados coletados do usuário.
Implementação via API
Neste exemplo, vamos demonstrar como listar os resultados de um bot e obter os detalhes de um resultado específico, que podem ser usados para integrar com o seu CRM.
Listar Resultados (List Results)
Este endpoint permite listar todos os resultados de um bot.
URL:
/api/bots/{bot_id}/resultsMétodo:
GETHeaders:
Authorization: Bearer {seu_token_api}Content-Type: application/json
Parâmetros:
Parâmetro Obrigatório Descrição Tipo Exemplo bot_idSim ID do bot do qual listar os resultados string 654321a987bcd6efglimitNão Limite de resultados por página number 10offsetNão Deslocamento para paginação number 0Exemplo (JavaScript):
javascript const token = 'SEU_TOKEN_API'; const botId = '654321a987bcd6efg';
fetch(https://api.toolzz.dev/api/bots/${botId}/results, {
method: 'GET',
headers: {
'Authorization': Bearer ${token},
'Content-Type': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Erro:', error));
- Response JSON:
{ "results": [ { "id": "result_id_1", "bot_id": "654321a987bcd6efg", "chat_id": "chat_id_1", "created_at": "2024-10-27T10:00:00Z", "data": { "nome": "João da Silva", "email": "[email protected]" } }, { "id": "result_id_2", "bot_id": "654321a987bcd6efg", "chat_id": "chat_id_2", "created_at": "2024-10-27T11:00:00Z", "data": { "nome": "Maria Souza", "email": "[email protected]" } } ] }
Obter um Resultado Específico (Get a Result)
Este endpoint permite obter os detalhes de um resultado específico.
URL:
/api/bots/{bot_id}/results/{result_id}Método:
GETHeaders:
Authorization: Bearer {seu_token_api}Content-Type: application/json
Parâmetros:
Parâmetro Obrigatório Descrição Tipo Exemplo bot_idSim ID do bot string 654321a987bcd6efgresult_idSim ID do resultado a ser obtido string result_id_1Exemplo (Python):
python import requests
token = 'SEU_TOKEN_API' bot_id = '654321a987bcd6efg' result_id = 'result_id_1'
url = f'https://api.toolzz.dev/api/bots/{bot_id}/results/{result_id}' headers = { 'Authorization': f'Bearer {token}', 'Content-Type': 'application/json' }
response = requests.get(url, headers=headers)
if response.status_code == 200: data = response.json() print(data) else: print(f'Erro: {response.status_code}')
- Response JSON:
{ "id": "result_id_1", "bot_id": "654321a987bcd6efg", "chat_id": "chat_id_1", "created_at": "2024-10-27T10:00:00Z", "data": { "nome": "João da Silva", "email": "[email protected]" } }
Pronto para levar a integração do seu chatbot para o próximo nível?
Solicite uma demonstraçãoTestando
Após configurar o fluxo visual e a integração com a API do seu CRM, teste o chatbot utilizando o recurso "Preview Chat" no Toolzz Bots. Verifique se os dados coletados do usuário estão sendo enviados corretamente para o CRM e se as ações desejadas estão sendo executadas.
Erros Comuns
- Token de API Inválido: Verifique se o token de API está correto e possui as permissões necessárias.
- URL da API do CRM Incorreta: Certifique-se de que a URL da API do CRM está correta e acessível.
- Formato JSON Inválido: Verifique se o corpo da requisição JSON está no formato correto e inclui todos os campos necessários.
- Problemas de CORS: Se você estiver enfrentando problemas de CORS, configure o seu servidor CRM para permitir solicitações de diferentes origens.
Conclusão
A integração do Toolzz Bots com um CRM externo pode otimizar significativamente seus processos de vendas e marketing, automatizando a qualificação de leads e fornecendo uma experiência do cliente mais personalizada. Ao utilizar a API do Toolzz Bots, você pode criar integrações poderosas e flexíveis que se adaptam às suas necessidades específicas. Explore a documentação completa da API em https://docs.toolzz.dev/bots-reference/ para descobrir todas as possibilidades.
Configuração do ToolzzVoice
Veja como configurar agentes de voz e ligações telefônicas com IA no Toolzz Voice.
.webp){kind=small}
