Code Block (Python):

python import requests

url = "https://api.toolzz.com.br/chat/agents" headers = { "Authorization": "Bearer SEU_TOKEN_DE_API", "Content-Type": "application/json" }

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

if response.status_code == 200: print(response.json()) else: print(f"Erro: {response.status_code} - {response.text}")

Response JSON:

{ "agents": [ { "id": "agent_1", "name": "João Silva", "email": "[email protected]", "status": "online", "team_id": "team_a" }, { "id": "agent_2", "name": "Maria Souza", "email": "[email protected]", "status": "offline", "team_id": "team_b" } ], "total": 2, "page": 1, "limit": 10 }

2. Criar uma Equipe (Create a Teams)

As equipes são cruciais para organizar seus agentes e direcionar as conversas para os grupos certos. Use este endpoint para criar novas equipes.

• URL: https://api.toolzz.com.br/chat/teams
• Método HTTP: POST
• Headers:
  • 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." }

Tabela de Parâmetros:

Code Block (JavaScript):

javascript const axios = require('axios');

const url = 'https://api.toolzz.com.br/chat/teams'; const headers = { 'Authorization': 'Bearer SEU_TOKEN_DE_API', 'Content-Type': 'application/json' }; const data = { name: 'Suporte Técnico', description: 'Equipe responsável pelo suporte técnico aos clientes.' };

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

Response JSON:

{ "id": "team_c", "name": "Suporte Técnico", "description": "Equipe responsável pelo suporte técnico aos clientes." }

3. Atribuir Conversa (Assign Conversation)

Este é o endpoint central para automatizar a atribuição de conversas. Você pode atribuir uma conversa a um agente específico ou a uma equipe.

• URL: https://api.toolzz.com.br/chat/conversations/{conversation_id}/assign
• Método HTTP: POST
• Headers:
  • Authorization: Bearer {seu_token_de_api}
  • Content-Type: application/json

Body JSON:

{ "agent_id": "agent_1" }

Ou, para atribuir a uma equipe:

{ "team_id": "team_c" }

Tabela de Parâmetros:

Code Block (Bash/cURL):

bash curl -X POST
'https://api.toolzz.com.br/chat/conversations/conversa_123/assign'
-H 'Authorization: Bearer SEU_TOKEN_DE_API'
-H 'Content-Type: application/json'
-d '{ "agent_id": "agent_1" }'

Response JSON:

{ "message": "Conversa atribuída com sucesso ao agente agent_1" }

Webhooks: Mantendo Sistemas Externos Sincronizados

Os webhooks permitem que você seja notificado em tempo real sobre eventos importantes que ocorrem na Toolzz Chat, como a criação de uma nova conversa ou a atribuição de uma conversa a um agente. Você pode usar essas notificações para integrar a Toolzz Chat com seus sistemas externos (CRM, helpdesk, etc.) e automatizar fluxos de trabalho.

Para configurar um webhook, utilize o endpoint Add A Webhook (documentação). Você deverá especificar a URL para a qual as notificações serão enviadas e os eventos que deseja monitorar (ex: conversation.created, conversation.assigned).

Testando a Integração: Garantindo o Funcionamento Perfeito

Após implementar a automação de atribuição de conversas via API, é fundamental testar a integração para garantir que tudo esteja funcionando corretamente. Crie cenários de teste que simulem diferentes tipos de interações com o cliente e verifique se as conversas estão sendo atribuídas aos agentes ou equipes corretas. Utilize os logs da API e os webhooks para monitorar o fluxo das conversas e identificar possíveis problemas.

Erros Comuns e Troubleshooting: Resolvendo Problemas Rapidamente

Durante a implementação e o teste da automação de atribuição de conversas, você pode encontrar alguns erros comuns. Aqui estão algumas dicas para resolvê-los:

• Token de API inválido: Verifique se o token de API está correto e se você tem as permissões necessárias para acessar os endpoints da API.
• Erros de validação: Certifique-se de que os dados que você está enviando na requisição estão no formato correto e que todos os campos obrigatórios estão presentes.
• Problemas de rede: Verifique se sua conexão com a internet está estável e se não há firewalls ou proxies bloqueando o acesso à API.
• Webhooks não entregues: Verifique se a URL do seu webhook está correta e se seu servidor está respondendo às notificações da Toolzz Chat.

Se você encontrar algum problema que não consegue resolver, consulte a documentação da API da Toolzz Chat ou entre em contato com o suporte técnico.

Conclusão: O Futuro do Atendimento ao Cliente Automatizado

A automação da atribuição de conversas é uma tendência crescente no mundo do atendimento ao cliente. Ao otimizar a alocação de recursos, reduzir os tempos de espera e melhorar a experiência do cliente, essa tecnologia oferece um retorno significativo para as empresas. Em 2026, espera-se que a automação se torne ainda mais inteligente e integrada, impulsionando a eficiência e a satisfação do cliente a novos patamares. Plataformas como Zendesk, Salesforce Service Cloud e Toolzz Chat já oferecem recursos avançados de automação, mas a Toolzz se destaca pela sua flexibilidade e facilidade de integração via API. A Toolzz Chat permite uma automação customizada, adaptada às necessidades específicas de cada negócio.

Potencialize com agentes de IA da Toolzz

O Toolzz Chat cuida do atendimento humano. Mas e se um agente de IA da Toolzz AI respondesse as primeiras perguntas, qualificasse o lead, e só transferisse para o humano quando necessário? Com Custom Functions, seu agente consulta CRM, agenda reuniões e resolve problemas — tudo por WhatsApp. Já imaginou interagir com essa automação por voz? Saiba mais sobre a Toolzz AI.