{ "name": "SLA de Prioridade Alta", "description": "SLA para clientes VIP", "first_response_time": 300, // Tempo em segundos (5 minutos) "resolution_time": 7200, // Tempo em segundos (2 horas) "violation_alert": { "type": "email", "recipients": ["[email protected]"] } }

Tabela de parâmetros:

• Code Block (Python):

python import requests import json

url = "https://api.toolzz.dev/slas" headers = { "Content-Type": "application/json", "Authorization": "Bearer SEU_TOKEN_DE_API" } data = { "name": "SLA de Prioridade Alta", "description": "SLA para clientes VIP", "first_response_time": 300, "resolution_time": 7200, "violation_alert": { "type": "email", "recipients": ["[email protected]"] } }

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

print(response.json())

• Response JSON:

{ "id": "6507a0a4e5b9a64d4a5d6c7e", "name": "SLA de Prioridade Alta", "description": "SLA para clientes VIP", "first_response_time": 300, "resolution_time": 7200, "violation_alert": { "type": "email", "recipients": ["[email protected]"] } }

2. Listar SLAs

Este endpoint retorna uma lista de todos os SLAs configurados na sua conta.

javascript const axios = require('axios');

const url = 'https://api.toolzz.dev/slas'; const headers = { 'Authorization': 'Bearer SEU_TOKEN_DE_API' };

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

• Response JSON:

[ { "id": "6507a0a4e5b9a64d4a5d6c7e", "name": "SLA de Prioridade Alta", "description": "SLA para clientes VIP", "first_response_time": 300, "resolution_time": 7200, "violation_alert": { "type": "email", "recipients": ["[email protected]"] } }, { "id": "6507a0a4e5b9a64d4a5d6c7f", "name": "SLA Padrão", "description": "SLA para todos os clientes", "first_response_time": 600, "resolution_time": 14400, "violation_alert": { "type": "email", "recipients": ["[email protected]"] } } ]

3. Obter Relatório de Métricas de SLA

Este endpoint fornece um relatório detalhado das métricas de SLA, permitindo analisar o desempenho do atendimento ao cliente.

bash curl -H "Authorization: Bearer SEU_TOKEN_DE_API"
"https://api.toolzz.dev/slas/report?start_date=2024-01-01&end_date=2024-01-31"

• Response JSON:

{ "total_conversations": 150, "sla_met": 120, "sla_violated": 30, "average_first_response_time": 240, "average_resolution_time": 6000 }

Webhooks para Notificações em Tempo Real

Além da API, o Toolzz Chat oferece webhooks que permitem receber notificações em tempo real sobre eventos relacionados ao SLA. Por exemplo, você pode configurar um webhook para ser notificado quando um SLA é violado. Para configurar um webhook, siga os passos abaixo:

1. Acesse as configurações de webhook no Toolzz Chat.
2. Adicione um novo webhook.
3. Selecione o evento "SLA Violado".
4. Informe a URL para onde a notificação deve ser enviada.
5. Salve as configurações.

A notificação enviada para a URL configurada terá o seguinte formato:

{ "event": "sla.violated", "data": { "sla_id": "6507a0a4e5b9a64d4a5d6c7e", "conversation_id": "6507a0a4e5b9a64d4a5d6c80", "violated_metric": "first_response_time", "violated_value": 650, // Tempo real de resposta em segundos "sla_limit": 300 // Limite definido no SLA em segundos } }

Com essas informações, você pode implementar ações corretivas, como alertar um gerente ou priorizar a conversa para um agente mais experiente.

Testando a Integração

Após implementar a integração via API e configurar os webhooks, é fundamental testar o funcionamento da solução. Simule diferentes cenários, como:

• Conversas com tempo de resposta dentro do SLA.
• Conversas com tempo de resposta fora do SLA.
• Conversas com tempo de resolução dentro e fora do SLA.

Verifique se os alertas estão sendo enviados corretamente e se os dados estão sendo exibidos no dashboard customizado. Utilize as ferramentas de debug do seu navegador ou Postman para inspecionar as requisições e respostas da API.

Erros Comuns e Troubleshooting

Ao implementar o monitoramento de SLA via API, alguns erros são comuns. Aqui estão algumas dicas para solucionar problemas:

• Erro de Autenticação: Verifique se o token de API está correto e se possui as permissões necessárias.
• Erro de Formato do JSON: Certifique-se de que o corpo da requisição está no formato JSON correto. Utilize um validador JSON para verificar a sintaxe.
• Erro de Endpoint Não Encontrado: Verifique se a URL do endpoint está correta. Consulte a documentação da API para obter a lista de endpoints disponíveis.
• Webhooks Não Disparados: Verifique se o webhook está configurado corretamente e se a URL de destino está acessível.

Conclusão

Automatizar o monitoramento de SLA com a API do Toolzz Chat é uma estratégia inteligente para otimizar o atendimento ao cliente, economizar tempo e tomar decisões mais assertivas. Ao integrar a API com um dashboard customizado e utilizar webhooks para notificações em tempo real, você terá uma visão completa do desempenho do seu atendimento e poderá agir proativamente para garantir a satisfação do cliente. A implementação pode parecer complexa inicialmente, mas os benefícios a longo prazo compensam o investimento.

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? Descubra como a Toolzz AI pode transformar seu atendimento.