O guia completo de Automação de Atribuição de Conversas para Atendimento em 2026
Aprenda a automatizar a distribuição de conversas com a API do Toolzz Chat e otimize o tempo dos seus agentes.
O guia completo de Automação de Atribuição de Conversas para Atendimento em 2026
24 de abril de 2026
No cenário dinâmico do atendimento ao cliente, a eficiência na distribuição de conversas é crucial para garantir a satisfação do cliente e a produtividade da equipe. A atribuição manual de conversas pode ser lenta, gerar gargalos e levar a tempos de resposta elevados. Este guia detalhado explora como automatizar esse processo utilizando a API do Toolzz Chat, permitindo que você direcione as conversas para os agentes mais adequados de forma inteligente e eficiente.
Pré-requisitos
Para acompanhar este tutorial, você precisará de:
- Uma conta ativa no Toolzz Chat.
- Um token de API. Você pode obtê-lo acessando o painel do Toolzz Chat, navegando até a seção de configurações da API e gerando um novo token.
Como obter o token de API:
- Faça login no chat.toolzz.ai.
- Clique em "Configurações" no menu lateral.
- Selecione "API".
- Clique em "Gerar novo token".
- Copie o token gerado e guarde-o em um local seguro.
Arquitetura
O fluxo de automação da atribuição de conversas com a API do Toolzz Chat segue o seguinte padrão:
Cliente (WhatsApp/Instagram) → Toolzz Chat → Automação (API) → Agente Humano/IA
Quando uma nova mensagem é recebida, a API do Toolzz Chat é acionada para identificar o agente mais adequado para atender à solicitação, levando em consideração critérios como habilidades, disponibilidade e carga de trabalho. A conversa é então atribuída automaticamente, garantindo um tempo de resposta rápido e uma experiência do cliente otimizada.
Configuração no Produto
Antes de implementar a automação via API, é importante configurar alguns elementos básicos no painel do Toolzz Chat:
- Crie as equipes: Defina as equipes de atendimento com base em habilidades ou áreas de especialização (ex: suporte técnico, vendas, financeiro).
- Adicione os agentes: Cadastre os agentes em suas respectivas equipes, informando suas habilidades e disponibilidade.
- Defina as regras de atribuição: Crie regras para determinar como as conversas serão atribuídas. Por exemplo, você pode definir que conversas com determinadas palavras-chave sejam direcionadas para a equipe de suporte técnico.
Quer otimizar a atribuição de conversas?
Solicite uma demonstraçãoImplementação via API
Vamos explorar os principais endpoints da API do Toolzz Chat para automatizar a atribuição de conversas.
1. List Agents In Account
Este endpoint permite listar todos os agentes disponíveis em sua conta. Ele é útil para obter a lista de agentes e suas informações, como ID e nome, para utilizá-la na lógica de atribuição.
URL:
https://api.toolzz.dev/chat/v1/accounts/{account_id}/agentsMétodo HTTP:
GETHeaders:
Authorization:Bearer {seu_token_de_api}
Parâmetros:
Parâmetro Tipo Descrição Obrigatório Exemplo Default account_id string ID da sua conta Toolzz Chat Sim 12345Code Block (Python):
python import requests
account_id = "12345" token = "SEU_TOKEN_AQUI"
headers = { "Authorization": f"Bearer {token}" }
response = requests.get(f"https://api.toolzz.dev/chat/v1/accounts/{account_id}/agents", headers=headers)
if response.status_code == 200: agents = response.json() for agent in agents: print(f"ID: {agent['id']}, Nome: {agent['name']}") else: print(f"Erro: {response.status_code} - {response.text}")
- Response JSON (Exemplo):
[ { "id": "agent_123", "name": "João Silva", "team_id": "team_456", "available": true }, { "id": "agent_456", "name": "Maria Souza", "team_id": "team_789", "available": false } ]
2. Create a Teams
Permite criar uma nova equipe de agentes. É útil para organizar os agentes por especialidade e facilitar a atribuição de conversas.
URL:
https://api.toolzz.dev/chat/v1/accounts/{account_id}/teamsMétodo HTTP:
POSTHeaders:
Authorization:Bearer {seu_token_de_api}Content-Type:application/json
Body JSON:
{ "name": "Suporte Técnico", "description": "Equipe responsável pelo suporte técnico aos clientes." }
- Code Block (JavaScript):
javascript const accountId = "12345"; const token = "SEU_TOKEN_AQUI";
const data = { name: "Suporte Técnico", description: "Equipe responsável pelo suporte técnico aos clientes." };
fetch(https://api.toolzz.dev/chat/v1/accounts/${accountId}/teams, {
method: "POST",
headers: {
"Authorization": Bearer ${token},
"Content-Type": "application/json"
},
body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
- Response JSON (Exemplo):
{ "id": "team_789", "name": "Suporte Técnico", "description": "Equipe responsável pelo suporte técnico aos clientes." }
3. Assign Conversation
Este endpoint é o coração da automação. Ele permite atribuir uma conversa a um agente específico.
URL:
https://api.toolzz.dev/chat/v1/conversations/{conversation_id}/assignMétodo HTTP:
POSTHeaders:
Authorization:Bearer {seu_token_de_api}Content-Type:application/json
Body JSON:
{ "agent_id": "agent_123" }
Webhooks
Para uma automação completa, configure webhooks para receber notificações em tempo real sobre novos eventos, como a chegada de uma nova mensagem. Isso permite que sua aplicação acione a API para atribuir a conversa automaticamente.
Pronto para simplificar a gestão do seu atendimento? Conheça a Toolzz e descubra como a automação pode transformar seus resultados.
Testando a Integração
Após implementar a automação, teste-a cuidadosamente para garantir que as conversas sejam atribuídas corretamente. Utilize diferentes cenários e verifique se a lógica de atribuição está funcionando conforme o esperado.
Erros Comuns e Troubleshooting
- Token de API inválido: Verifique se o token de API está correto e ativo.
- ID da conta incorreto: Certifique-se de que o ID da conta está correto.
- Agente não encontrado: Verifique se o ID do agente existe e está ativo.
- Erros de permissão: Verifique se a conta possui as permissões necessárias para acessar os endpoints da API.
Conclusão
Automatizar a atribuição de conversas com a API do Toolzz Chat pode trazer inúmeros benefícios para o seu negócio, como a redução de custos, o aumento da produtividade e a melhoria da experiência do cliente. Ao implementar este guia, você estará no caminho certo para otimizar o seu atendimento e alcançar resultados ainda melhores. Se você busca uma solução completa para otimizar seu atendimento, veja os planos e preços da Toolzz.
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}
