bash curl -X POST
'https://api.toolzz.com.br/bots'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_TOKEN_API'
-d '{ "name": "Chatbot de Qualificação de Leads", "description": "Chatbot para qualificar leads no varejo", "workspace_id": "ID_DO_SEU_WORKSPACE" }'

javascript const axios = require('axios');

const data = { name: 'Chatbot de Qualificação de Leads', description: 'Chatbot para qualificar leads no varejo', workspace_id: 'ID_DO_SEU_WORKSPACE' };

axios.post('https://api.toolzz.com.br/bots', data, { headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_API' } }) .then(response => { console.log(response.data); }) .catch(error => { console.error(error); });

python import requests import json

url = 'https://api.toolzz.com.br/bots' headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_API' } data = { 'name': 'Chatbot de Qualificação de Leads', 'description': 'Chatbot para qualificar leads no varejo', 'workspace_id': 'ID_DO_SEU_WORKSPACE' } response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.json())

Response JSON:

{ "id": "ID_DO_BOT", "name": "Chatbot de Qualificação de Leads", "description": "Chatbot para qualificar leads no varejo", "workspace_id": "ID_DO_SEU_WORKSPACE", "created_at": "2024-01-01T00:00:00.000Z", "updated_at": "2024-01-01T00:00:00.000Z" }

2. Publicar Toolzz Bot

Este endpoint permite publicar o bot para que ele possa ser utilizado.

• URL: https://api.toolzz.com.br/bots/{bot_id}/publish
• Método: POST
• Headers:
  • Authorization: Bearer SEU_TOKEN_API

bash curl -X POST
'https://api.toolzz.com.br/bots/ID_DO_BOT/publish'
-H 'Authorization: Bearer SEU_TOKEN_API'

javascript const axios = require('axios');

axios.post('https://api.toolzz.com.br/bots/ID_DO_BOT/publish', null, { headers: { 'Authorization': 'Bearer SEU_TOKEN_API' } }) .then(response => { console.log(response.data); }) .catch(error => { console.error(error); });

python import requests

url = 'https://api.toolzz.com.br/bots/ID_DO_BOT/publish' headers = { 'Authorization': 'Bearer SEU_TOKEN_API' } response = requests.post(url, headers=headers) print(response.json())

Response JSON:

{ "message": "Bot publicado com sucesso" }

3. Iniciar Chat

Este endpoint permite iniciar uma conversa com o bot.

• URL: https://api.toolzz.com.br/bots/{bot_id}/chat
• Método: POST
• Headers:
  • Content-Type: application/json
  • Authorization: Bearer SEU_TOKEN_API

{ "channel": "whatsapp", "user_id": "+5511999999999", "message": "Olá, gostaria de saber mais sobre seus produtos" }

Tabela de parâmetros:

bash curl -X POST
'https://api.toolzz.com.br/bots/ID_DO_BOT/chat'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_TOKEN_API'
-d '{ "channel": "whatsapp", "user_id": "+5511999999999", "message": "Olá, gostaria de saber mais sobre seus produtos" }'

javascript const axios = require('axios');

const data = { channel: 'whatsapp', user_id: '+5511999999999', message: 'Olá, gostaria de saber mais sobre seus produtos' };

axios.post('https://api.toolzz.com.br/bots/ID_DO_BOT/chat', data, { headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_API' } }) .then(response => { console.log(response.data); }) .catch(error => { console.error(error); });

python import requests import json

url = 'https://api.toolzz.com.br/bots/ID_DO_BOT/chat' headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_API' } data = { 'channel': 'whatsapp', 'user_id': '+5511999999999', 'message': 'Olá, gostaria de saber mais sobre seus produtos' } response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.json())

Response JSON:

{ "chat_id": "ID_DO_CHAT", "message": "Olá! Bem-vindo ao nosso chatbot de qualificação de leads. Para começarmos, qual o seu interesse em nossos produtos?" }

4. Listar Resultados

Este endpoint permite listar os resultados das conversas com o bot.

• URL: https://api.toolzz.com.br/bots/{bot_id}/results
• Método: GET
• Headers:
  • Authorization: Bearer SEU_TOKEN_API

bash curl -X GET
'https://api.toolzz.com.br/bots/ID_DO_BOT/results'
-H 'Authorization: Bearer SEU_TOKEN_API'

javascript const axios = require('axios');

axios.get('https://api.toolzz.com.br/bots/ID_DO_BOT/results', { headers: { 'Authorization': 'Bearer SEU_TOKEN_API' } }) .then(response => { console.log(response.data); }) .catch(error => { console.error(error); });

python import requests

url = 'https://api.toolzz.com.br/bots/ID_DO_BOT/results' headers = { 'Authorization': 'Bearer SEU_TOKEN_API' } response = requests.get(url, headers=headers) print(response.json())

Response JSON:

[ { "id": "ID_DO_RESULTADO", "chat_id": "ID_DO_CHAT", "user_id": "+5511999999999", "data": { "interesse": "Alto", "orcamento": "R$1000", "prazo": "1 semana" }, "created_at": "2024-01-01T00:00:00.000Z" } ]

Com estes endpoints, você pode criar um fluxo completo de qualificação de leads, desde a criação do bot até a análise dos resultados.

Testando o Chatbot

Antes de colocar o chatbot em produção, é fundamental testá-lo para garantir que ele está funcionando corretamente. A Toolzz Bots oferece a funcionalidade de Preview Chat, que permite simular uma conversa com o bot e verificar se o fluxo está correto e se as perguntas estão sendo feitas da forma esperada. Além disso, você pode utilizar os endpoints da API para iniciar conversas de teste e verificar os resultados.

Erros Comuns e Soluções

Ao implementar a API da Toolzz Bots, alguns erros são comuns. Aqui estão alguns exemplos e suas soluções:

• Erro de autenticação: Verifique se o seu token de API está correto e se você está incluindo o header Authorization em todas as requisições.
• Erro de validação: Verifique se os dados que você está enviando no body da requisição estão no formato correto e se todos os campos obrigatórios estão presentes.
• Erro de permissão: Verifique se o seu usuário tem permissão para acessar o endpoint que você está tentando utilizar.

💡 Dica: Consulte a documentação da API da Toolzz Bots para obter informações detalhadas sobre os erros e suas soluções.

A Toolzz Bots vs. Concorrentes

No mercado de plataformas para criação de chatbots, existem diversas opções, como ManyChat, Chatfuel e Dialogflow. No entanto, a Toolzz Bots se destaca por oferecer uma combinação única de interface visual intuitiva, API poderosa e integração com os agentes de IA da Toolzz, permitindo criar soluções de atendimento ao cliente e qualificação de leads altamente personalizadas e eficientes. Enquanto concorrentes podem focar em nichos específicos ou exigir maior conhecimento técnico, a Toolzz Bots oferece uma solução completa e acessível para empresas de todos os portes.

Conclusão

A implementação de um chatbot de qualificação de leads utilizando a API da Toolzz Bots pode trazer resultados significativos para o seu negócio, como o aumento das vendas, a otimização da experiência do cliente e a redução dos custos operacionais. Ao automatizar a qualificação de leads, você libera sua equipe de vendas para se concentrar em oportunidades mais promissoras, aumentando a eficiência e o retorno sobre o investimento.

Combine 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?