A evolução da pesquisa de satisfação ao longo de 7 anos: de formulários a chatbots

Lucas (CEO Toolzz)
18 de abril de 2026

A pesquisa de satisfação é crucial para entender e melhorar a experiência do cliente. Ao longo dos anos, as metodologias evoluíram, e hoje os chatbots se destacam como ferramentas eficazes para coletar feedback e gerar insights valiosos. Este artigo explora essa evolução e demonstra como criar um chatbot de pesquisa de satisfação com analytics usando a API da Toolzz Bots.

Pré-requisitos

Antes de começar, você precisará de:

• Uma conta na Toolzz Bots. Se ainda não tiver, crie uma gratuitamente.
• Um workspace ativo na plataforma Toolzz Bots.
• Um token de API válido. Para obter seu token, acesse as configurações do seu workspace.

Arquitetura do Chatbot de Pesquisa de Satisfação

A arquitetura do nosso chatbot de pesquisa de satisfação segue o seguinte fluxo:

1. Usuário: Interage com o chatbot através de um canal (WhatsApp, site, etc.).
2. Canal: Encaminha a interação para o Toolzz Bot.
3. Toolzz Bot: Executa a lógica visual definida no fluxo do chatbot.
4. Lógica Visual: Apresenta perguntas de satisfação e coleta as respostas do usuário.
5. Resultado: Armazena as respostas coletadas.
6. Integração: (Opcional) Envia os resultados para um CRM ou ferramenta de análise.

Configuração do Fluxo no Toolzz Bots

Para configurar o fluxo do chatbot na interface visual do Toolzz Bots, siga estas etapas:

1. Acesse o painel da Toolzz Bots e crie um novo bot.
2. Utilize os nós visuais para construir o fluxo conversacional. Comece com uma mensagem de boas-vindas.
3. Adicione nós de pergunta para coletar feedback. Por exemplo, uma pergunta sobre a satisfação geral (escala de 1 a 5) e um campo de texto para comentários adicionais.
4. Configure os nós para armazenar as respostas em variáveis.
5. Adicione um nó de encerramento para agradecer ao usuário.
6. Opcionalmente, configure integrações para enviar os dados coletados para outras plataformas.

Pronto para automatizar a coleta de feedback? Conheça a Toolzz Bots e comece a construir chatbots inteligentes sem precisar de código.

Implementação via API

Agora, vamos implementar a criação e análise do chatbot de pesquisa de satisfação via API da Toolzz Bots.

Criar um Toolzz Bot

Este endpoint permite criar um novo bot.

• URL: https://api.toolzz.com.br/bots
• Método: POST
• Headers:
  • Content-Type: application/json
  • Authorization: Bearer SEU_TOKEN_DE_API

bash curl -X POST
'https://api.toolzz.com.br/bots'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_TOKEN_DE_API'
-d '{ "name": "Pesquisa de Satisfação", "description": "Chatbot para coletar feedback de clientes", "folder_id": null }'

javascript const axios = require('axios');

const data = { name: 'Pesquisa de Satisfação', description: 'Chatbot para coletar feedback de clientes', folder_id: null, };

const config = { headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_DE_API' } };

axios.post('https://api.toolzz.com.br/bots', data, config) .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_DE_API' } data = { 'name': 'Pesquisa de Satisfação', 'description': 'Chatbot para coletar feedback de clientes', 'folder_id': None }

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

print(response.json())

{ "id": "64e6c2a9-1234-4567-89ab-cdef01234567", "name": "Pesquisa de Satisfação", "description": "Chatbot para coletar feedback de clientes", "created_at": "2024-10-24T14:30:00.000Z", "updated_at": "2024-10-24T14:30:00.000Z", "workspace_id": "5d1a4b2c-1234-4567-89ab-cdef01234567", "user_id": "7e9b0c1a-1234-4567-89ab-cdef01234567", "folder_id": null, "status": "draft" }

Publicar um Toolzz Bot

Após criar o bot, você precisa publicá-lo para que ele fique disponível.

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

bash curl -X POST
'https://api.toolzz.com.br/bots/64e6c2a9-1234-4567-89ab-cdef01234567/publish'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_TOKEN_DE_API'

javascript const axios = require('axios');

const botId = '64e6c2a9-1234-4567-89ab-cdef01234567';

const config = { headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_DE_API' } };

axios.post(https://api.toolzz.com.br/bots/${botId}/publish, null, config) .then(response => { console.log(response.data); }) .catch(error => { console.error(error); });

python import requests

url = 'https://api.toolzz.com.br/bots/64e6c2a9-1234-4567-89ab-cdef01234567/publish' headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_DE_API' }

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

print(response.json())

{ "id": "64e6c2a9-1234-4567-89ab-cdef01234567", "name": "Pesquisa de Satisfação", "description": "Chatbot para coletar feedback de clientes", "created_at": "2024-10-24T14:30:00.000Z", "updated_at": "2024-10-24T14:35:00.000Z", "workspace_id": "5d1a4b2c-1234-4567-89ab-cdef01234567", "user_id": "7e9b0c1a-1234-4567-89ab-cdef01234567", "folder_id": null, "status": "published" }

Iniciar um Chat

Para iniciar uma conversa com o bot, use o endpoint Start Chat da Toolzz Chat.

• URL: https://api.toolzz.com.br/chat/start
• Método: POST
• Headers:
  • Content-Type: application/json
  • Authorization: Bearer SEU_TOKEN_DE_API

bash curl -X POST
'https://api.toolzz.com.br/chat/start'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_TOKEN_DE_API'
-d '{ "bot_id": "64e6c2a9-1234-4567-89ab-cdef01234567", "channel": "whatsapp", "contact_id": "5511999999999" }'

javascript const axios = require('axios');

const data = { bot_id: '64e6c2a9-1234-4567-89ab-cdef01234567', channel: 'whatsapp', contact_id: '5511999999999' };

const config = { headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_DE_API' } };

axios.post('https://api.toolzz.com.br/chat/start', data, config) .then(response => { console.log(response.data); }) .catch(error => { console.error(error); });

python import requests import json

url = 'https://api.toolzz.com.br/chat/start' headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_DE_API' } data = { 'bot_id': '64e6c2a9-1234-4567-89ab-cdef01234567', 'channel': 'whatsapp', 'contact_id': '5511999999999' }

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

print(response.json())

{ "chat_id": "8b2a9c3d-4567-1234-abcd-ef0123456789", "bot_id": "64e6c2a9-1234-4567-89ab-cdef01234567", "channel": "whatsapp", "contact_id": "5511999999999", "status": "active", "created_at": "2024-10-24T14:40:00.000Z" }

Obter Estatísticas do Bot

Para analisar os resultados da pesquisa de satisfação, utilize o endpoint Get Stats.

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

bash curl -X GET
'https://api.toolzz.com.br/bots/64e6c2a9-1234-4567-89ab-cdef01234567/stats'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_TOKEN_DE_API'

javascript const axios = require('axios');

const botId = '64e6c2a9-1234-4567-89ab-cdef01234567';

const config = { headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_DE_API' } };

axios.get(https://api.toolzz.com.br/bots/${botId}/stats, config) .then(response => { console.log(response.data); }) .catch(error => { console.error(error); });

python import requests

url = 'https://api.toolzz.com.br/bots/64e6c2a9-1234-4567-89ab-cdef01234567/stats' headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_DE_API' }

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

print(response.json())

{ "total_interactions": 150, "average_satisfaction": 4.2, "completion_rate": 0.85 }

Listar Resultados da Pesquisa

Para obter os resultados detalhados, utilize o endpoint List Results.

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

bash curl -X GET
'https://api.toolzz.com.br/bots/64e6c2a9-1234-4567-89ab-cdef01234567/results'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer SEU_TOKEN_DE_API'

javascript const axios = require('axios');

const botId = '64e6c2a9-1234-4567-89ab-cdef01234567';

const config = { headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_DE_API' } };

axios.get(https://api.toolzz.com.br/bots/${botId}/results, config) .then(response => { console.log(response.data); }) .catch(error => { console.error(error); });

python import requests

url = 'https://api.toolzz.com.br/bots/64e6c2a9-1234-4567-89ab-cdef01234567/results' headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer SEU_TOKEN_DE_API' }

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

print(response.json())

[ { "id": "9c8b7a6f-5678-9012-bcde-f0123456789a", "bot_id": "64e6c2a9-1234-4567-89ab-cdef01234567", "chat_id": "8b2a9c3d-4567-1234-abcd-ef0123456789", "answers": { "satisfaction_level": "5", "comments": "Excelente atendimento!" }, "created_at": "2024-10-24T14:45:00.000Z" }, { "id": "a1b2c3d4-6789-0123-fedc-ba9876543210", "bot_id": "64e6c2a9-1234-4567-89ab-cdef01234567", "chat_id": "8b2a9c3d-4567-1234-abcd-ef0123456789", "answers": { "satisfaction_level": "4", "comments": "Poderia ser um pouco mais rápido." }, "created_at": "2024-10-24T14:50:00.000Z" } ]

Testando

Para testar o chatbot antes de publicar, utilize o Start Preview Chat. Para verificar os resultados, consulte os logs e as estatísticas na plataforma da Toolzz Bots.

Erros Comuns

• Token de API inválido: Verifique se o token está correto.
• Bot não publicado: Certifique-se de publicar o bot antes de iniciar um chat.
• Erros de formatação no JSON: Valide o JSON antes de enviar a requisição.
• ID do bot incorreto: Verifique se o ID do bot está correto.

Conclusão

Chatbots de pesquisa de satisfação representam uma evolução significativa na coleta de feedback, oferecendo uma maneira mais interativa e eficiente de entender as necessidades dos clientes. Com a API da Toolzz Bots, você pode automatizar a criação, publicação e análise desses chatbots, obtendo insights valiosos para aprimorar seus produtos e serviços. Plataformas como Typebot e Landbot também oferecem funcionalidades similares, mas a Toolzz Bots se destaca pela facilidade de uso e integração com outros produtos da Toolzz.