{ "name": "Pesquisa de Satisfação", "description": "Chatbot para coletar feedback de clientes", "workspace_id": "SEU_WORKSPACE_ID" }

• 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": "Pesquisa de Satisfação", "description": "Chatbot para coletar feedback de clientes", "workspace_id": "SEU_WORKSPACE_ID" }

response = requests.post(url, headers=headers, data=json.dumps(data))

print(response.json())

• Tabela de Parâmetros:

• Response JSON:

{ "id": "ID_DO_BOT_CRIADO", "name": "Pesquisa de Satisfação", "description": "Chatbot para coletar feedback de clientes", "workspace_id": "SEU_WORKSPACE_ID", "created_at": "2024-01-01T00:00:00Z", "updated_at": "2024-01-01T00:00:00Z" }

Publicar um Toolzz Bot

Após criar o bot, é necessário publicá-lo para que ele possa ser acessado pelos usuários.

{}

• Code Block (JavaScript):

javascript const axios = require('axios');

const botId = 'ID_DO_BOT'; const url = https://api.toolzz.com.br/bots/${botId}/publish; const headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_API_TOKEN' };

axios.post(url, {}, { headers }) .then(response => { console.log(response.data); }) .catch(error => { console.error(error); });

• Tabela de Parâmetros:

• Response JSON:

{ "id": "ID_DO_BOT_PUBLICADO", "status": "published", "published_at": "2024-01-01T00:00:00Z" }

Iniciar um Chat

Para iniciar uma conversa com o bot, utilize o endpoint de início de chat.

{ "channel": "whatsapp", "user_id": "USUARIO_ID", "message": "Iniciar pesquisa de satisfação" }

• Code Block (Bash):

bash curl -X POST
https://api.toolzz.com.br/bots/ID_DO_BOT/chat
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_API_TOKEN'
-d '{ "channel": "whatsapp", "user_id": "USUARIO_ID", "message": "Iniciar pesquisa de satisfação" }'

• Tabela de Parâmetros:

• Response JSON:

{ "chat_id": "ID_DO_CHAT", "message": "Olá! Bem-vindo à pesquisa de satisfação.", "status": "active" }

Obter Estatísticas do Chatbot

Para obter estatísticas sobre o desempenho do chatbot, utilize o endpoint de estatísticas.

python import requests

url = "https://api.toolzz.com.br/bots/ID_DO_BOT/stats" headers = { "Content-Type": "application/json", "Authorization": "Bearer SEU_API_TOKEN" }

response = requests.get(url, headers=headers)

print(response.json())

• Tabela de Parâmetros:

• Response JSON:

{ "total_chats": 100, "completed_chats": 80, "average_rating": 4.5 }

Listar Resultados

Para acessar os resultados da pesquisa, utilize o endpoint de listagem de resultados.

javascript const axios = require('axios');

const botId = 'ID_DO_BOT'; const url = https://api.toolzz.com.br/bots/${botId}/results; const headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_API_TOKEN' };

axios.get(url, { headers }) .then(response => { console.log(response.data); }) .catch(error => { console.error(error); });

• Tabela de Parâmetros:

• Response JSON:

[ { "id": "ID_DO_RESULTADO_1", "user_id": "USUARIO_ID_1", "answers": { "satisfaction": "5", "improvement": "Melhor atendimento" } }, { "id": "ID_DO_RESULTADO_2", "user_id": "USUARIO_ID_2", "answers": { "satisfaction": "4", "improvement": "Mais opções de pagamento" } } ]

Obter um Resultado Específico

Para obter um resultado específico, utilize o endpoint de detalhe de resultado.

bash curl -X GET
https://api.toolzz.com.br/bots/ID_DO_BOT/results/ID_DO_RESULTADO
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_API_TOKEN'

• Tabela de Parâmetros:

• Response JSON:

{ "id": "ID_DO_RESULTADO", "user_id": "USUARIO_ID", "answers": { "satisfaction": "5", "improvement": "Melhor atendimento" } }

Listar Logs em Resultados

Para obter os logs de interação em um resultado específico, utilize o endpoint de listagem de logs.

python import requests

url = "https://api.toolzz.com.br/bots/ID_DO_BOT/results/ID_DO_RESULTADO/logs" headers = { "Content-Type": "application/json", "Authorization": "Bearer SEU_API_TOKEN" }

response = requests.get(url, headers=headers)

print(response.json())

• Tabela de Parâmetros:

• Response JSON:

[ { "timestamp": "2024-01-01T00:00:00Z", "message": "Olá! Bem-vindo à pesquisa de satisfação.", "type": "bot" }, { "timestamp": "2024-01-01T00:00:05Z", "message": "Qual a sua satisfação com nosso produto?", "type": "bot" }, { "timestamp": "2024-01-01T00:00:10Z", "message": "5", "type": "user" } ]

Testando o Chatbot

Para testar o chatbot antes de publicá-lo, utilize o recurso de Preview Chat disponível na interface do Toolzz Bots. Além disso, após a publicação, verifique os resultados da pesquisa através da API para garantir que os dados estão sendo coletados corretamente.

Erros Comuns

Ao implementar o chatbot de pesquisa de satisfação, alguns erros comuns podem ocorrer:

• Token de API Inválido: Certifique-se de que o token de API está correto e válido.
• ID do Workspace Incorreto: Verifique se o ID do workspace está correto.
• Formato JSON Inválido: Verifique se o corpo da requisição JSON está no formato correto.
• Permissões Insuficientes: Verifique se a sua conta tem permissões para acessar os endpoints da API.

Conclusão

A criação de um chatbot de pesquisa de satisfação com analytics utilizando a API do Toolzz Bots oferece uma maneira eficiente e automatizada de coletar feedback e obter insights valiosos sobre a satisfação dos seus clientes. Ao seguir os passos descritos neste artigo, você poderá implementar um chatbot personalizado e integrado com suas ferramentas de analytics, otimizando seus processos e aprimorando seus produtos e serviços. Plataformas como RD Station e HubSpot oferecem soluções de CRM e automação de marketing que podem ser integradas com o Toolzz Bots para maximizar o impacto das suas pesquisas de satisfação. No entanto, o Toolzz Bots se destaca pela sua facilidade de uso e flexibilidade na criação de fluxos visuais complexos, tornando-o uma excelente escolha para empresas de todos os portes. Ferramentas como o Dialogflow da Google também são opções, mas a Toolzz se sobressai ao oferecer uma solução mais intuitiva e focada em automação visual.

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?