Crie Chatbots de Qualificação de Leads em 2026: Tutorial API Toolzz Bots
Aprenda a criar e publicar chatbots de qualificação de leads com a API do Toolzz Bots e impulsione suas vendas.
Crie Chatbots de Qualificação de Leads em 2026: Tutorial API Toolzz Bots
17 de abril de 2026
Chatbots visuais estão revolucionando a forma como empresas interagem com seus leads, automatizando a qualificação inicial e liberando equipes de vendas para focar em oportunidades mais promissoras. Este tutorial detalhado guiará você na criação de um chatbot de qualificação de leads utilizando a API do Toolzz Bots, permitindo a integração perfeita com seus sistemas existentes.
Pré-requisitos
Para seguir este tutorial, você precisará de:
- Uma conta no Toolzz Bots.
- Um workspace criado dentro da plataforma.
- Um token de API. Para obter seu token, vá para as configurações do seu workspace e gere um novo token com as permissões necessárias (leitura e escrita de bots).
Observação: É recomendado utilizar uma linguagem de programação como Python ou Node.js para interagir com a API. Você também precisará de uma ferramenta como Postman ou Insomnia para testar os endpoints.
Arquitetura
O fluxo de funcionamento do nosso chatbot de qualificação de leads será o seguinte:
- Usuário: Inicia uma conversa com o chatbot através de um canal de comunicação (WhatsApp, Facebook Messenger, etc.).
- Canal: Envia a mensagem do usuário para a API do Toolzz Bots.
- Toolzz Bot: Recebe a mensagem e a direciona para o fluxo visual configurado na plataforma.
- Lógica Visual: O chatbot executa a lógica pré-definida, fazendo perguntas de qualificação e analisando as respostas do usuário.
- Resultado: Com base nas respostas, o chatbot determina se o lead é qualificado ou não.
- Integração: As informações do lead (nome, e-mail, telefone, respostas às perguntas) são enviadas para um CRM externo ou outro sistema de automação de marketing.
Configuração no Produto
Primeiramente, precisamos criar o fluxo visual do nosso chatbot no Toolzz Bots. Utilize a interface de arrastar e soltar para criar as seguintes etapas:
- Mensagem de Boas-vindas: Uma mensagem inicial que apresenta o chatbot e explica seu propósito.
- Pergunta 1: Qual é o seu cargo na empresa?
- Pergunta 2: Qual é o tamanho da sua empresa (número de funcionários)?
- Pergunta 3: Qual é o seu principal desafio atual?
- Lógica de Qualificação: Analise as respostas do usuário para determinar se ele se encaixa no perfil do seu cliente ideal. Por exemplo, se o cargo for “Gerente de Marketing” e o tamanho da empresa for “50-200 funcionários”, o lead pode ser considerado qualificado.
- Mensagem de Confirmação: Se o lead for qualificado, envie uma mensagem agradecendo pelo contato e informando que um representante entrará em contato em breve.
- Mensagem de Desqualificação: Se o lead não for qualificado, envie uma mensagem informando que, no momento, o seu produto ou serviço não atende às suas necessidades, mas convide-o a seguir a empresa nas redes sociais para ficar por dentro das novidades.
Quer começar a criar chatbots de alta performance?
Solicite uma demonstraçãoImplementação via API
Agora, vamos automatizar a criação e publicação desse chatbot utilizando a API do Toolzz Bots.
1. Create a Toolzz Bot
Este endpoint permite criar um novo bot no seu workspace.
URL: https://api.toolzz.ai/bots
Método: POST
Headers:
| Header | Value | Description |
|---|---|---|
| Authorization | Bearer SEU_TOKEN_DE_API |
Token de autenticação da API |
| Content-Type | application/json |
Tipo de conteúdo do corpo da requisição |
Body (JSON):
{ "name": "Chatbot de Qualificação de Leads", "description": "Chatbot para qualificar leads e coletar informações de contato", "flow_id": "ID_DO_FLUXO_VISUAL_CRIAADO_NO_TOOLZZ" }
Exemplo (Python):
python import requests import json
url = "https://api.toolzz.ai/bots" headers = { "Authorization": "Bearer SEU_TOKEN_DE_API", "Content-Type": "application/json" } data = { "name": "Chatbot de Qualificação de Leads", "description": "Chatbot para qualificar leads e coletar informações de contato", "flow_id": "ID_DO_FLUXO_VISUAL_CRIAADO_NO_TOOLZZ" }
response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.json())
Response (JSON):
{ "id": "ID_DO_BOT_CRIAADO", "name": "Chatbot de Qualificação de Leads", "description": "Chatbot para qualificar leads e coletar informações de contato", "flow_id": "ID_DO_FLUXO_VISUAL_CRIAADO_NO_TOOLZZ", "created_at": "2024-10-27T10:00:00Z", "updated_at": "2024-10-27T10:00:00Z" }
2. Publish Toolzz Bot
Este endpoint permite publicar o bot em um ou mais canais de comunicação.
URL: https://api.toolzz.ai/bots/{bot_id}/publish
Método: POST
Headers: (mesmos do endpoint anterior)
Body (JSON):
{ "channels": ["whatsapp", "facebook_messenger"] }
3. Start Chat
Este endpoint permite iniciar uma conversa com o chatbot.
URL: https://api.toolzz.ai/bots/{bot_id}/chat
Método: POST
Headers: (mesmos do endpoint anterior)
Body (JSON):
{ "user_id": "ID_DO_USUARIO", "message": "Olá, gostaria de saber mais sobre seus produtos." }
Testando
Após publicar o chatbot, utilize o recurso de Preview Chat na plataforma para testar o fluxo e garantir que ele esteja funcionando corretamente. Verifique se as perguntas de qualificação estão sendo exibidas, se as respostas estão sendo processadas corretamente e se as mensagens de confirmação/desqualificação estão sendo enviadas.
A integração de chatbots com a API do Toolzz Bots permite otimizar o processo de qualificação, liberando sua equipe para focar em leads com maior potencial de conversão. Se você busca uma solução completa para automatizar suas interações com clientes, a Toolzz oferece diversas ferramentas e APIs para atender às suas necessidades.
Erros Comuns
- Token de API inválido: Verifique se o token está correto e se possui as permissões necessárias.
- Flow ID inválido: Verifique se o ID do fluxo visual está correto.
- Erros de formatação no JSON: Certifique-se de que o JSON está bem formatado e que todos os campos obrigatórios estão presentes.
- Problemas de conexão: Verifique sua conexão com a internet e se os servidores do Toolzz Bots estão acessíveis.
Conclusão
Este tutorial demonstrou como criar e publicar um chatbot de qualificação de leads utilizando a API do Toolzz Bots. Ao automatizar este processo, você pode economizar tempo, melhorar a eficiência da sua equipe de vendas e aumentar suas taxas de conversão. A API do Toolzz Bots oferece flexibilidade e escalabilidade para atender às necessidades específicas do seu negócio.
Pronto para levar sua automação para o próximo nível? Conheça a Toolzz AI e descubra como a inteligência artificial pode impulsionar seus resultados.
Configuração do ToolzzVoice
Veja como configurar agentes de voz e ligações telefônicas com IA no Toolzz Voice.
.webp){kind=small}
