Guia Rápido de Chatbot de Qualificação de Leads para Iniciantes em Vendas 2026
Aprenda a criar um chatbot de qualificação de leads via API e impulsione suas vendas. Guia prático para iniciantes em 2026.

Guia Rápido de Chatbot de Qualificação de Leads para Iniciantes em Vendas 2026
17 de abril de 2026
No cenário competitivo de vendas, a qualificação eficiente de leads é crucial. Chatbots visuais oferecem uma solução eficaz para automatizar esse processo, garantindo que sua equipe de vendas foque nos leads mais promissores. Este guia prático mostrará como criar e publicar um chatbot de qualificação de leads usando a API do Toolzz Bots, mesmo que você seja um iniciante.
Pré-requisitos
Antes de começar, você precisará de:
- Uma conta ativa no Toolzz Bots:
- Um workspace configurado dentro do Toolzz Bots.
- Um API token válido. Para obter seu API token, vá para as configurações do seu workspace no Toolzz Bots.
Arquitetura do Chatbot de Qualificação
Entenda o fluxo de informações do seu chatbot:
- Usuário: Interage com o chatbot através de um canal (WhatsApp, site, etc.).
- Canal: O canal de comunicação (ex: WhatsApp) envia a mensagem para o Toolzz Bots.
- Toolzz Bot: O chatbot recebe a mensagem e inicia o fluxo de conversação definido.
- Lógica Visual: O fluxo visual no Toolzz Bots define as perguntas, condições e ações do chatbot.
- Resultado: O chatbot coleta as respostas do usuário e as armazena.
- Integração: Os dados coletados são integrados a um CRM externo ou usados para outras finalidades.
Pronto para automatizar a qualificação de leads? Conheça a Toolzz Bots e comece a focar nos leads certos.
Configuração no Produto (Toolzz Bots)
- Crie um novo Bot: Acesse seu workspace no Toolzz Bots e clique em "Criar Bot".
- Defina o fluxo visual: Use a interface drag-and-drop para criar o fluxo de conversação. Inclua perguntas de qualificação (ex: "Qual o tamanho da sua empresa?", "Qual o seu orçamento?").
- Adicione condições: Use blocos de condição para direcionar o fluxo com base nas respostas do usuário. Por exemplo, se o orçamento for alto, avance para a próxima etapa; caso contrário, colete mais informações.
- Configure as ações: Defina as ações a serem executadas com base nas respostas. Você pode enviar os dados para um CRM, notificar sua equipe de vendas ou agendar uma ligação.
- Publique o Bot: Depois de configurar o fluxo, clique em "Publicar" para disponibilizar o chatbot.
Implementação via API
Agora, vamos automatizar a criação e publicação do chatbot usando a API do Toolzz Bots. Veja a documentação completa em docs.toolzz.dev/bots-reference/.
Criar um Toolzz Bot
Este endpoint cria um novo bot no seu workspace.
URL:
https://api.toolzz.com.br/botsMétodo:
POSTHeaders:
Content-Type: application/jsonAuthorization: Bearer SEU_API_TOKEN
Body JSON:
{ "name": "Chatbot de Qualificação de Leads", "description": "Bot para qualificar leads e direcionar para a equipe de vendas.", "workspace_id": "SEU_WORKSPACE_ID" }
Tabela de parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
name |
string | Nome do chatbot. |
description |
string | Descrição do chatbot. |
workspace_id |
string | ID do workspace onde o chatbot será criado. |
Code block (Python):
python import requests import json
url = "https://api.toolzz.com.br/bots" headers = { "Content-Type": "application/json", "Authorization": "Bearer SEU_API_TOKEN" } data = { "name": "Chatbot de Qualificação de Leads", "description": "Bot para qualificar leads e direcionar para a equipe de vendas.", "workspace_id": "SEU_WORKSPACE_ID" } response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.json())
Response JSON:
{ "id": "BOT_ID", "name": "Chatbot de Qualificação de Leads", "description": "Bot para qualificar leads e direcionar para a equipe de vendas.", "workspace_id": "SEU_WORKSPACE_ID", "created_at": "2024-01-01T00:00:00.000Z", "updated_at": "2024-01-01T00:00:00.000Z" }
Publicar um Toolzz Bot
Este endpoint publica o bot para que ele possa ser usado.
URL:
https://api.toolzz.com.br/bots/{bot_id}/publishMétodo:
POSTHeaders:
Content-Type: application/jsonAuthorization: Bearer SEU_API_TOKEN
Body JSON:
{ "status": true }
Tabela de parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
status |
boolean | true para publicar, false para despublicar. |
Code block (JavaScript):
javascript const axios = require('axios');
const botId = 'BOT_ID';
const apiUrl = https://api.toolzz.com.br/bots/${botId}/publish;
const apiKey = 'SEU_API_TOKEN';
axios.post(apiUrl, { status: true }, {
headers: {
'Content-Type': 'application/json',
'Authorization': Bearer ${apiKey}
}
})
.then(response => {
console.log('Bot publicado com sucesso:', response.data);
})
.catch(error => {
console.error('Erro ao publicar o bot:', error);
});
Response JSON:
{ "id": "BOT_ID", "name": "Chatbot de Qualificação de Leads", "description": "Bot para qualificar leads e direcionar para a equipe de vendas.", "workspace_id": "SEU_WORKSPACE_ID", "status": true, "created_at": "2024-01-01T00:00:00.000Z", "updated_at": "2024-01-01T00:00:00.000Z" }
Iniciar um Chat
Este endpoint inicia uma conversa com o bot.
URL:
https://api.toolzz.com.br/chatsMétodo:
POSTHeaders:
Content-Type: application/jsonAuthorization: Bearer SEU_API_TOKEN
Body JSON:
{ "bot_id": "BOT_ID", "channel": "whatsapp", "user_id": "USER_ID" }
Tabela de parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
bot_id |
string | ID do bot a ser usado. |
channel |
string | Canal de comunicação (ex: whatsapp). |
user_id |
string | ID do usuário (opcional, mas recomendado). |
Code block (cURL):
bash
curl -X POST
'https://api.toolzz.com.br/chats'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_API_TOKEN'
-d '{
"bot_id": "BOT_ID",
"channel": "whatsapp",
"user_id": "USER_ID"
}'
Response JSON:
{ "chat_id": "CHAT_ID", "bot_id": "BOT_ID", "channel": "whatsapp", "user_id": "USER_ID", "status": "active", "created_at": "2024-01-01T00:00:00.000Z", "updated_at": "2024-01-01T00:00:00.000Z" }
Testando
Use o recurso Start Preview Chat para testar seu bot antes de publicá-lo. Isso permite simular uma conversa e verificar se o fluxo está funcionando corretamente. Além disso, você pode verificar os resultados coletados na seção de Resultados do Toolzz Bots.
Erros Comuns
- API Token Inválido: Verifique se o API token está correto e se tem as permissões necessárias.
- Workspace ID Incorreto: Certifique-se de que o Workspace ID corresponde ao workspace onde o bot deve ser criado.
- Erros de Validação: Verifique se o corpo da requisição JSON está formatado corretamente e se todos os campos obrigatórios estão presentes.
Conclusão
Automatizar a criação e publicação de chatbots de qualificação de leads com a API do Toolzz Bots oferece flexibilidade e escalabilidade. Ao integrar o Toolzz Bots com suas ferramentas de vendas, você pode otimizar o processo de qualificação e aumentar a eficiência da sua equipe. Experimente a Toolzz Bots e transforme sua estratégia de vendas.
Quer ver na prática?
Comece gratuitamenteCombine Bots + Agentes IA para o máximo poder
O Toolzz Bots cria fluxos visuais incríveis. Mas combine com um agente de IA da Toolzz AI e o resultado é outro nível: o bot coleta dados, o agente processa com IA e responde inteligentemente. Tudo acessível por WhatsApp, Instagram ou voz. Já imaginou?
Configuração do ToolzzVoice
Veja como configurar agentes de voz e ligações telefônicas com IA no Toolzz Voice.


















