Chatbots e inovação: como se conectam
Aprenda a criar um chatbot de qualificação de leads com a API do Toolzz Bots e automatize seu funil de vendas.

Chatbots e inovação: como se conectam
17 de abril de 2026
Em um cenário empresarial cada vez mais competitivo, a capacidade de qualificar leads de forma eficiente é crucial para o sucesso. Chatbots visuais, como os criados com a Toolzz Bots, oferecem uma solução inovadora para automatizar esse processo, liberando sua equipe de vendas para se concentrar em oportunidades de maior valor.
Pré-requisitos
Para seguir este tutorial, você precisará de:
- Uma conta na Toolzz Bots.
- Um workspace criado dentro da plataforma.
- Um token de API válido. Para obter um token, acesse as configurações do seu workspace na Toolzz Bots e gere um novo token. Guarde-o em um local seguro.
Exemplo de como obter o token:
- Faça login no Toolzz Bots.
- Vá para “Configurações” (geralmente no canto inferior esquerdo).
- Selecione “API Tokens”.
- Clique em “Gerar novo token”.
- Dê um nome descritivo ao token (ex: “Lead Qualification Bot API”).
- Copie o token gerado. Ele será usado nas chamadas da API.
Arquitetura
O fluxo de funcionamento do chatbot de qualificação de leads pode ser descrito da seguinte forma:
- Usuário: Inicia uma conversa com o chatbot através de um canal (ex: WhatsApp, Telegram, website).
- Canal: Envia a mensagem do usuário para a API da Toolzz Bots.
- Toolzz Bot: Recebe a mensagem e a direciona para o fluxo visual configurado na plataforma.
- Lógica visual: O fluxo visual determina as perguntas que serão feitas ao usuário, as respostas esperadas e as ações a serem executadas com base nessas respostas.
- Resultado: O chatbot coleta as informações do lead e armazena os resultados.
- Integração: Os resultados podem ser integrados a um CRM externo (ex: Salesforce, HubSpot) para dar continuidade ao processo de vendas.
Pronto para automatizar a qualificação de leads? Conheça a Toolzz Bots e veja como chatbots visuais podem transformar seu processo de vendas.
Configuração no produto
Antes de implementar a API, é importante configurar o fluxo visual do chatbot na Toolzz Bots.
- Crie um novo bot: Dê um nome ao bot (ex: “Qualificação de Leads”) e selecione um template adequado (ex: “Qualificação de Leads”).
- Defina as perguntas: Adicione as perguntas que você deseja fazer aos leads (ex: “Qual o seu cargo?”, “Qual o tamanho da sua empresa?”, “Qual o seu principal desafio?”).
- Configure as respostas: Defina as opções de resposta para cada pergunta (ex: múltipla escolha, texto livre).
- Crie as condições: Utilize as condições para direcionar o fluxo da conversa com base nas respostas do usuário.
- Defina as ações: Configure as ações que serão executadas com base nas respostas do usuário (ex: salvar as informações em um CRM, enviar um e-mail, agendar uma demonstração).
Implementação via API
Para criar e publicar o chatbot de qualificação de leads via API, você precisará utilizar os seguintes endpoints:
- Create a Toolzz Bot
- Publish Toolzz Bot
- Start Chat
Criar um Bot (Create a Toolzz Bot)
URL: https://api.toolzz.ai/bots
Método: POST
Headers:
Content-Type: application/json Authorization: Bearer SEU_TOKEN_API
Body JSON:
{ "name": "Lead Qualification Bot", "description": "Chatbot para qualificar leads", "workspace_id": "SEU_WORKSPACE_ID", "template_id": "6543210abcdefg" }
Parâmetros:
| Parâmetro | Tipo | Descrição | Obrigatório | Exemplo |
|---|---|---|---|---|
name |
string | Nome do bot | Sim | "Lead Qualification Bot" |
description |
string | Descrição do bot | Não | "Chatbot para qualificar leads" |
workspace_id |
string | ID do workspace | Sim | "SEU_WORKSPACE_ID" |
template_id |
string | ID do template a ser utilizado | Sim | "6543210abcdefg" |
Response JSON:
{ "id": "NOVO_ID_DO_BOT", "name": "Lead Qualification Bot", "workspace_id": "SEU_WORKSPACE_ID", "created_at": "2024-10-27T14:00:00Z", "updated_at": "2024-10-27T14:00:00Z" }
Exemplo em Python: python import requests import json
url = "https://api.toolzz.ai/bots" headers = { "Content-Type": "application/json", "Authorization": "Bearer SEU_TOKEN_API" } data = { "name": "Lead Qualification Bot", "description": "Chatbot para qualificar leads", "workspace_id": "SEU_WORKSPACE_ID", "template_id": "6543210abcdefg" }
response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.json())
Publicar um Bot (Publish Toolzz Bot)
URL: https://api.toolzz.ai/bots/{bot_id}/publish
Método: POST
Headers:
Content-Type: application/json Authorization: Bearer SEU_TOKEN_API
Body JSON:
{ "channel": "whatsapp" }
Parâmetros:
| Parâmetro | Tipo | Descrição | Obrigatório | Exemplo |
|---|---|---|---|---|
channel |
string | Canal de publicação | Sim | "whatsapp" |
Response JSON:
{ "id": "ID_DO_BOT", "published": true }
Iniciar um Chat (Start Chat)
URL: https://api.toolzz.ai/chats
Método: POST
Headers:
Content-Type: application/json Authorization: Bearer SEU_TOKEN_API
Body JSON:
{ "bot_id": "ID_DO_BOT", "user_id": "ID_DO_USUARIO", "message": "Olá! Gostaria de saber mais sobre seus serviços." }
Parâmetros:
| Parâmetro | Tipo | Descrição | Obrigatório | Exemplo |
|---|---|---|---|---|
bot_id |
string | ID do bot | Sim | "ID_DO_BOT" |
user_id |
string | ID do usuário | Sim | "ID_DO_USUARIO" |
message |
string | Primeira mensagem do usuário | Sim | "Olá..." |
Response JSON:
{ "id": "ID_DO_CHAT", "bot_id": "ID_DO_BOT", "user_id": "ID_DO_USUARIO", "created_at": "2024-10-27T14:00:00Z" }
Testando
Após implementar a API, você pode testar o chatbot utilizando o Preview Chat na Toolzz Bots para simular a conversa e verificar se o fluxo está funcionando corretamente. Verifique os resultados no painel da Toolzz Bots para garantir que as informações dos leads estão sendo coletadas e armazenadas corretamente.
Quer elevar a automação ao próximo nível?
Solicitar demo Toolzz AIErros comuns
- Token de API inválido: Verifique se o token de API está correto e se possui as permissões necessárias.
- Workspace ID inválido: Verifique se o ID do workspace está correto.
- Template ID inválido: Verifique se o ID do template está correto.
- Erros de JSON: Verifique se o JSON está formatado corretamente.
Conclusão
Com a API da Toolzz Bots, você pode criar e publicar chatbots de qualificação de leads de forma rápida e fácil, automatizando seu funil de vendas e liberando sua equipe para se concentrar em oportunidades de maior valor. A flexibilidade e a facilidade de uso da Toolzz Bots a tornam a escolha ideal para empresas que buscam inovar e otimizar seus processos de vendas. Se você busca soluções completas de IA para o seu negócio, a Toolzz oferece uma gama de produtos que podem te ajudar a alcançar resultados incríveis.
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.


















