Tendências emergentes de chatbots de qualificação de leads via API em 2026
Descubra como criar e publicar chatbots de qualificação de leads via API com Toolzz Bots para automatizar vendas em 2026.
Tendências emergentes de chatbots de qualificação de leads via API em 2026
7 de agosto de 2026
1. Introdução
O funil de vendas moderno exige velocidade e personalização na qualificação de leads, mas processos manuais não escalam. Chatbots visuais surgem como aliados estratégicos, oferecendo interações inteligentes 24/7 para coletar dados e classificar potenciais clientes com base em critérios como orçamento, autoridade, necessidade e urgência (BANT). A verdadeira revolução, porém, acontece quando essa automação é impulsionada por APIs, permitindo criar, publicar e gerenciar bots de forma programática e integrada a CRMs e outras ferramentas. Neste tutorial, você aprenderá a dominar a API do Toolzz Bots para construir um chatbot de qualificação de leads do zero, com exemplos práticos em cURL, JavaScript e Python.
Comece agora — crie seu primeiro chatbot de qualificação de leads na Toolzz Bots e veja como é simples automatizar seu funil.
2. Pré‑requisitos
Antes de começar, certifique-se de ter o seguinte:
- Conta ativa no Toolzz Bots: acesse Toolzz Bots e crie um workspace. A plataforma oferece um plano gratuito para testes.
- Workspace configurado: seu workspace deve estar ativo, e você precisa ter permissões de administrador para gerar tokens de API.
- Token de API: no painel do Toolzz Bots, vá em Configurações > API Keys e gere um token. Guarde-o em local seguro – ele será usado em todas as chamadas.
- Ferramentas de desenvolvimento:
- Terminal com cURL para testes rápidos.
- Node.js ou Python para scripts de integração.
3. Arquitetura
A arquitetura de um bot de qualificação de leads via API segue um fluxo bem definido:
- Usuário → inicia a conversa por um canal (site, WhatsApp, Instagram).
- Canal → encaminha a mensagem para o Toolzz Bot via webhook ou integração nativa.
- Toolzz Bot → executa o fluxo visual construído no builder, fazendo perguntas de qualificação e tomando decisões lógicas.
- Resultado → os dados do lead e o status de qualificação são armazenados no histórico do bot.
- Integração (API) → a API permite criar, publicar e iniciar chats programaticamente, além de extrair resultados para um CRM externo.
4. Configuração no Produto
Antes de mergulhar na API, é importante entender como o fluxo visual é montado na interface do Toolzz Bots. Siga estes passos:
- Acesse seu workspace e clique em Novo Bot.
- No builder, arraste os blocos de Mensagem, Pergunta e Condição para montar o fluxo de qualificação.
- Configure perguntas baseadas no modelo BANT:
- Orçamento: “Qual o investimento disponível para essa solução?”
- Autoridade: “Você é o responsável pela decisão de compra?”
- Necessidade: “Qual o principal desafio que deseja resolver?”
- Urgência: “Qual o prazo para implementação?”
- Use blocos de condição para classificar o lead: se atender a todos os critérios, marcar como quente; caso contrário, como morno ou frio.
- No final do fluxo, adicione um bloco Salvar Resultado para armazenar as respostas.
5. Implementação via API
Agora vamos automatizar todo o ciclo de vida do bot usando os três endpoints principais da API do Toolzz Bots.
5.1 Criando um Bot via API
Endpoint: POST https://api.toolzz.bots/v1/bots
Headers:
Authorization: Bearer SEU_TOKENContent-Type: application/json
Parâmetros do Body
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name |
string | Sim | Nome do bot (ex.: "Qualificador de Leads") |
workspaceId |
string | Sim | ID do workspace onde o bot será criado |
flow |
object | Não | Objeto com a definição do fluxo visual (opcional na criação) |
channels |
array | Não | Lista de canais onde o bot será ativado |
Exemplo de Requisição
bash
curl -X POST https://api.toolzz.bots/v1/bots
-H "Authorization: Bearer SEU_TOKEN"
-H "Content-Type: application/json"
-d '{
"name": "Qualificador de Leads",
"workspaceId": "ws_abc123"
}'
javascript const axios = require('axios');
const createBot = async () => { const response = await axios.post('https://api.toolzz.bots/v1/bots', { name: "Qualificador de Leads", workspaceId: "ws_abc123" }, { headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } }); console.log(response.data); };
createBot();
python import requests
url = "https://api.toolzz.bots/v1/bots" headers = { "Authorization": "Bearer SEU_TOKEN", "Content-Type": "application/json" } data = { "name": "Qualificador de Leads", "workspaceId": "ws_abc123" }
response = requests.post(url, json=data, headers=headers) print(response.json())
Response de Sucesso (201)
{ "id": "bot_xyz789", "name": "Qualificador de Leads", "workspaceId": "ws_abc123", "status": "draft", "createdAt": "2026-01-15T10:30:00Z" }
5.2 Publicando o Bot
Após criar e configurar o fluxo visualmente (ou via API enviando o objeto flow), é necessário publicar o bot para ativá-lo nos canais.
Endpoint: POST https://api.toolzz.bots/v1/bots/{botId}/publish
Headers:
Authorization: Bearer SEU_TOKENContent-Type: application/json
Parâmetros de URL
| Parâmetro | Tipo | Descrição |
|---|---|---|
botId |
string | ID do bot retornado na criação |
Exemplo de Requisição
bash
curl -X POST https://api.toolzz.bots/v1/bots/bot_xyz789/publish
-H "Authorization: Bearer SEU_TOKEN"
javascript
const publishBot = async (botId) => {
const response = await axios.post(https://api.toolzz.bots/v1/bots/${botId}/publish, {}, {
headers: {
'Authorization': 'Bearer SEU_TOKEN'
}
});
console.log(response.data);
};
publishBot('bot_xyz789');
python import requests
bot_id = "bot_xyz789" url = f"https://api.toolzz.bots/v1/bots/{bot_id}/publish" headers = {"Authorization": "Bearer SEU_TOKEN"}
response = requests.post(url, headers=headers) print(response.json())
Response de Sucesso (200)
{ "id": "bot_xyz789", "status": "published", "publishedAt": "2026-01-15T10:45:00Z", "publicUrl": "https://chat.toolzz.io/bot_xyz789" }
5.3 Iniciando um Chat
Para iniciar uma conversa com um lead de forma programática, utilize o endpoint de chat. Isso é útil para disparar mensagens proativas.
Endpoint: POST https://api.toolzz.bots/v1/bots/{botId}/chats
Headers:
Authorization: Bearer SEU_TOKENContent-Type: application/json
Parâmetros do Body
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
userId |
string | Sim | Identificador único do lead no seu sistema |
channel |
string | Sim | Canal utilizado (ex.: whatsapp, web) |
initialMessage |
string | Não | Mensagem inicial opcional enviada pelo bot |
Exemplo de Requisição
bash
curl -X POST https://api.toolzz.bots/v1/bots/bot_xyz789/chats
-H "Authorization: Bearer SEU_TOKEN"
-H "Content-Type: application/json"
-d '{
"userId": "lead_123",
"channel": "whatsapp"
}'
javascript
const startChat = async (botId, userId, channel) => {
const response = await axios.post(https://api.toolzz.bots/v1/bots/${botId}/chats, {
userId,
channel
}, {
headers: {
'Authorization': 'Bearer SEU_TOKEN',
'Content-Type': 'application/json'
}
});
console.log(response.data);
};
startChat('bot_xyz789', 'lead_123', 'whatsapp');
python import requests
bot_id = "bot_xyz789" url = f"https://api.toolzz.bots/v1/bots/{bot_id}/chats" headers = { "Authorization": "Bearer SEU_TOKEN", "Content-Type": "application/json" } data = { "userId": "lead_123", "channel": "whatsapp" }
response = requests.post(url, json=data, headers=headers) print(response.json())
Response de Sucesso (201)
{ "chatId": "chat_abc456", "botId": "bot_xyz789", "userId": "lead_123", "channel": "whatsapp", "welcomeMessage": "Olá! Sou o assistente virtual da empresa. Posso fazer algumas perguntas?", "createdAt": "2026-01-15T11:00:00Z" }
Você pode usar esse mesmo endpoint para disparar mensagens proativas. E se quiser ver essas integrações funcionando em um ambiente real, solicite uma demonstração gratuita da Toolzz Bots — nossa equipe mostra como configurar tudo em poucos minutos.
6. Testando
Antes de colocar o bot em produção, é essencial testar o fluxo. A API do Toolzz Bots oferece um endpoint de Preview Chat, que simula a interação sem precisar de um canal externo.
Endpoint: POST https://api.toolzz.bots/v1/bots/{botId}/preview
bash
curl -X POST https://api.toolzz.bots/v1/bots/bot_xyz789/preview
-H "Authorization: Bearer SEU_TOKEN"
-H "Content-Type: application/json"
-d '{
"userId": "test_user"
}'
A resposta retorna um chatId de
Demo Bots
Explore a demo interativa do Toolzz Bots, uma poderosa plataforma no-code que permite a criação de chatbots que operam 24 horas por dia, 7 dias por semana.
.webp){kind=small}
