Por Que Toolzz é Referência em Atribuição de Conversas
Automatize a distribuição de chats com a API Toolzz Chat e otimize o atendimento ao cliente.
Por Que Toolzz é Referência em Atribuição de Conversas
16 de abril de 2026
Em um cenário de atendimento ao cliente cada vez mais dinâmico e multicanal, a eficiência na distribuição de conversas para os agentes certos é crucial. A demora na atribuição, o envio para o agente errado ou a falta de qualificação do contato podem levar à frustração do cliente e à perda de oportunidades de negócio. A Toolzz Chat oferece uma API robusta que permite automatizar esse processo, garantindo que cada interação seja tratada pela equipe mais adequada, no tempo certo.
Pré-requisitos
Para seguir este tutorial, você precisará de:
- Uma conta ativa na Toolzz Chat (https://chat.toolzz.ai).
- Um token de API válido. Você pode obter o token acessando a página de configurações da sua conta Toolzz Chat e gerando uma nova chave.
Para obter um token de API, siga estes passos:
- Faça login na sua conta Toolzz Chat.
- Clique no seu perfil no canto inferior esquerdo.
- Selecione "Configurações".
- Na aba "API", clique em "Gerar Token".
- Copie o token gerado. Guarde-o em um local seguro, pois ele será necessário para autenticar suas requisições.
Arquitetura
O fluxo de trabalho para a automação da atribuição de conversas é o seguinte:
- Cliente: Inicia uma conversa via WhatsApp ou Instagram.
- Toolzz Chat: Recebe a mensagem e a encaminha para a API.
- Automação (API): A lógica de atribuição, implementada através da API, determina o agente ou equipe mais adequada para lidar com a conversa.
- Agente Humano/IA: A conversa é atribuída ao agente ou equipe selecionada, que pode ser um humano ou um agente de IA.
Configuração no Produto
Dentro da interface da Toolzz Chat, você pode configurar equipes e agentes. A API será usada para automatizar a atribuição com base nessas configurações.
- Crie Equipes: Acesse a seção de "Equipes" e crie as equipes de atendimento que você utiliza (ex: "Vendas", "Suporte", "Financeiro").
- Adicione Agentes: Adicione os agentes à respectiva equipe. Defina as habilidades e especialidades de cada agente para otimizar a atribuição.
- Defina Regras de Atribuição: Embora a API permita a lógica de atribuição personalizada, você pode usar as configurações básicas da Toolzz Chat para definir regras simples (ex: atribuir conversas com a palavra-chave "fatura" para a equipe "Financeiro").
Implementação via API
Vamos explorar os endpoints da API para automatizar a atribuição de conversas.
1. List Agents In Account
Este endpoint permite listar todos os agentes associados à sua conta Toolzz Chat.
URL:
https://api.toolzz.dev/chat/v1/accounts/{account_id}/agentsMétodo:
GETHeaders:
Authorization: Bearer {seu_token_de_api}Content-Type: application/json
Parâmetros:
Parâmetro Tipo Descrição Obrigatório Exemplo account_id string ID da sua conta Toolzz Chat Sim your_account_idExemplo (bash):
bash curl -X GET 'https://api.toolzz.dev/chat/v1/accounts/your_account_id/agents' -H 'Authorization: Bearer seu_token_de_api' -H 'Content-Type: application/json'
- Response JSON (exemplo):
[ { "id": "agent_1", "name": "João da Silva", "email": "[email protected]", "team_id": "team_1" }, { "id": "agent_2", "name": "Maria Souza", "email": "[email protected]", "team_id": "team_2" } ]
2. Create a Team
Este endpoint permite criar uma nova equipe de atendimento.
URL:
https://api.toolzz.dev/chat/v1/accounts/{account_id}/teamsMétodo:
POSTHeaders:
Authorization: Bearer {seu_token_de_api}Content-Type: application/json
Body JSON:
{ "name": "Novas Vendas", "description": "Equipe responsável por leads qualificados." }
Parâmetros:
Parâmetro Tipo Descrição Obrigatório Exemplo account_id string ID da sua conta Toolzz Chat Sim your_account_idname string Nome da equipe Sim Novas Vendasdescription string Descrição da equipe Não Equipe responsável por leads qualificadosExemplo (Python):
python import requests import json
url = "https://api.toolzz.dev/chat/v1/accounts/your_account_id/teams" headers = { "Authorization": "Bearer seu_token_de_api", "Content-Type": "application/json" } data = { "name": "Novas Vendas", "description": "Equipe responsável por leads qualificados." }
response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.json())
- Response JSON (exemplo):
{ "id": "team_3", "name": "Novas Vendas", "description": "Equipe responsável por leads qualificados." }
3. Assign Conversation
Este endpoint permite atribuir uma conversa específica a um agente ou equipe.
URL:
https://api.toolzz.dev/chat/v1/conversations/{conversation_id}/assignMétodo:
POSTHeaders:
Authorization: Bearer {seu_token_de_api}Content-Type: application/json
Body JSON:
{ "agent_id": "agent_1", "team_id": "team_1" }
- Parâmetros:
Parâmetro Tipo Descrição Obrigatório Exemplo conversation_id string ID da conversa que será atribuída Sim conversation_123agent_id string ID do agente para o qual a conversa será atribuída Não agent_1team_id string ID da equipe para a qual a conversa será atribuída Não team_1
Quer otimizar ainda mais a gestão das suas conversas e escalar seu atendimento? Conheça a Toolzz Chat e descubra como a automação pode transformar seus resultados.
Webhooks
Você pode configurar webhooks para ser notificado sempre que uma nova conversa for iniciada. Isso permite que sua aplicação acione a lógica de atribuição automaticamente.
Testando a Integração
Após implementar a integração, teste-a enviando mensagens para o seu número do WhatsApp ou Instagram. Verifique se a conversa está sendo atribuída ao agente ou equipe correta com base na sua lógica de atribuição.
Erros Comuns e Troubleshooting
- Erro de Autenticação: Verifique se o token de API está correto e se você tem permissão para acessar o recurso solicitado.
- Erro de Requisição: Verifique se o corpo JSON da requisição está formatado corretamente.
- Agente ou Equipe Não Encontrado: Verifique se o ID do agente ou equipe especificado existe na sua conta Toolzz Chat.
Conclusão
A API da Toolzz Chat oferece um poderoso conjunto de ferramentas para automatizar a atribuição de conversas e otimizar o seu atendimento ao cliente. Ao implementar essa automação, você pode reduzir o tempo de resposta, melhorar a satisfação do cliente e aumentar a eficiência da sua equipe.
Quer ver na prática?
Solicite uma demonstraçãoDemonstração LXP
Experimente uma demonstração interativa da nossa plataforma LXP e descubra como podemos transformar o aprendizado na sua organização.
.webp){kind=small}
