A revolução da automação de atendimento nos negócios
Descubra como automatizar o roteamento de conversas com a API Toolzz Chat e otimizar o atendimento ao cliente.
A revolução da automação de atendimento nos negócios
16 de abril de 2026
Com a crescente demanda por atendimento ao cliente eficiente e personalizado, as empresas buscam constantemente soluções inovadoras para otimizar seus processos. A automação, impulsionada pela inteligência artificial, surge como uma resposta eficaz, permitindo o roteamento inteligente de conversas, a redução de custos e a melhoria da experiência do cliente. Neste artigo, exploraremos como a API do Toolzz Chat pode ser utilizada para automatizar a atribuição de conversas a agentes, elevando o atendimento ao próximo nível.
Pré-requisitos
Para acompanhar este tutorial, você precisará de:
- Uma conta ativa no Toolzz Chat.
- Um token de API válido. Você pode obter seu token acessando o painel de controle do Toolzz Chat e navegando até a seção de configurações da API. Para gerar um token, vá em 'Configurações' -> 'API' e clique em 'Gerar Token'.
- Um cliente REST como Postman, Insomnia ou cURL para interagir com a API.
Arquitetura
O fluxo de automação de roteamento de conversas com a API Toolzz Chat pode ser descrito da seguinte forma:
- O cliente inicia uma conversa através de um canal como WhatsApp ou Instagram.
- A mensagem é recebida pelo Toolzz Chat.
- A API é acionada para determinar o agente mais adequado para atender à conversa.
- A conversa é automaticamente atribuída ao agente selecionado.
- O agente recebe uma notificação sobre a nova conversa e inicia o atendimento.
Configuração no produto
Antes de implementar a automação via API, é fundamental configurar alguns elementos na interface do Toolzz Chat.
- Criação de Equipes: Acesse a seção 'Equipes' e crie as equipes que representarão os grupos de agentes especializados em diferentes áreas de atendimento. Por exemplo, 'Equipe de Vendas', 'Equipe de Suporte Técnico', etc.
- Criação de Agentes: Adicione os agentes ao Toolzz Chat e atribua-os às equipes correspondentes. Defina as habilidades e especialidades de cada agente para otimizar o roteamento.
- Definição de Regras de Roteamento: Embora a API permita implementar regras complexas, o Toolzz Chat oferece algumas opções básicas de roteamento na interface. Utilize-as para definir critérios iniciais, como atribuição por palavra-chave ou horário de atendimento.
Implementação via API
Listar Agentes em uma Conta
Este endpoint permite obter a lista de agentes disponíveis em sua conta do Toolzz Chat. Ele é essencial para identificar os agentes que podem ser atribuídos às conversas.
URL: https://api.toolzz.ai/chat/v1/accounts/{account_id}/agents
Método: GET
Headers:
Authorization: Bearer {seu_token_api} Content-Type: application/json
Parâmetros:
| Parâmetro | Tipo | Descrição | Obrigatório | Exemplo |
|---|---|---|---|---|
| account_id | string | ID da sua conta no Toolzz Chat | Sim | sua_conta_id |
Exemplo de requisição (cURL): bash curl -X GET 'https://api.toolzz.ai/chat/v1/accounts/sua_conta_id/agents' -H 'Authorization: Bearer seu_token_api' -H 'Content-Type: application/json'
Response JSON:
{ "data": [ { "id": "agente_id_1", "name": "João da Silva", "email": "[email protected]", "team_id": "equipe_id_1" }, { "id": "agente_id_2", "name": "Maria Souza", "email": "[email protected]", "team_id": "equipe_id_2" } ] }
Criar uma Equipe
Caso precise criar novas equipes para segmentar seus agentes, você pode utilizar este endpoint.
URL: https://api.toolzz.ai/chat/v1/accounts/{account_id}/teams
Método: POST
Headers:
Authorization: Bearer {seu_token_api} Content-Type: application/json
Body JSON:
{ "name": "Equipe de Suporte Nível 2", "description": "Agentes especializados em problemas complexos." }
Exemplo de requisição (JavaScript): javascript const response = await fetch('https://api.toolzz.ai/chat/v1/accounts/sua_conta_id/teams', { method: 'POST', headers: { 'Authorization': 'Bearer seu_token_api', 'Content-Type': 'application/json' }, body: JSON.stringify({ "name": "Equipe de Suporte Nível 2", "description": "Agentes especializados em problemas complexos." }) });
Atribuir uma Conversa a um Agente
Este é o endpoint central para a automação do roteamento. Ele permite atribuir uma conversa específica a um agente com base em critérios predefinidos.
URL: https://api.toolzz.ai/chat/v1/conversations/{conversation_id}/assign
Método: POST
Headers:
Authorization: Bearer {seu_token_api} Content-Type: application/json
Body JSON:
{ "agent_id": "agente_id_1" }
Parâmetros:
| Parâmetro | Tipo | Descrição | Obrigatório | Exemplo |
|---|---|---|---|---|
| conversation_id | string | ID da conversa que será atribuída | Sim | conversa_id |
| agent_id | string | ID do agente a quem a conversa será atribuída | Sim | agente_id_1 |
Exemplo de requisição (Python): python import requests
url = 'https://api.toolzz.ai/chat/v1/conversations/conversa_id/assign' headers = { 'Authorization': 'Bearer seu_token_api', 'Content-Type': 'application/json' } data = { 'agent_id': 'agente_id_1' }
response = requests.post(url, headers=headers, json=data) print(response.json())
Quer otimizar o atendimento da sua empresa?
Solicitar demonstraçãoWebhooks
Para otimizar a automação, você pode configurar webhooks para receber notificações sobre eventos relevantes, como a criação de uma nova conversa ou a mudança de status de uma conversa. Isso permite que sua aplicação reaja em tempo real e execute ações específicas, como acionar a API para atribuir a conversa ao agente mais adequado.
Testando a integração
Após implementar a integração, é crucial testá-la cuidadosamente para garantir que a automação esteja funcionando corretamente. Envie mensagens de teste através dos canais configurados e verifique se as conversas estão sendo atribuídas aos agentes corretos. Monitore os logs da API para identificar possíveis erros ou problemas.
Erros comuns e troubleshooting
- Token de API inválido: Verifique se o token de API está correto e ativo.
- ID de agente inválido: Certifique-se de que o ID do agente especificado na requisição existe na sua conta.
- Problemas de conexão: Verifique a conectividade de rede e se a API do Toolzz Chat está acessível.
- Erros de permissão: Confira se a conta utilizada possui as permissões necessárias para acessar os endpoints da API.
Conclusão
A automação do roteamento de conversas com a API do Toolzz Chat é uma estratégia poderosa para otimizar o atendimento ao cliente, reduzir custos e aumentar a eficiência da sua equipe. Implementando as dicas e exemplos apresentados neste artigo, você estará pronto para transformar a experiência do seu cliente e impulsionar seus resultados. Se você busca uma solução completa e integrada, conheça a Toolzz e descubra como podemos te ajudar a alcançar seus objetivos.
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}
