{ "name": "SLA Padrão", "description": "SLA para todos os canais de atendimento", "target_response_time": 300, // Tempo em segundos (5 minutos) "target_resolution_time": 7200, // Tempo em segundos (2 horas) "channel_ids": [1, 2, 3], // IDs dos canais (WhatsApp, Chat, Email) "priority": "high" // Prioridade do SLA }

Tabela de Parâmetros:

Exemplo em 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 Padrão", "description": "SLA para todos os canais de atendimento", "target_response_time": 300, "target_resolution_time": 7200, "channel_ids": [1, 2, 3], "priority": "high" }

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

print(response.json())

Response JSON:

{ "id": 123, "name": "SLA Padrão", "description": "SLA para todos os canais de atendimento", "target_response_time": 300, "target_resolution_time": 7200, "channel_ids": [1, 2, 3], "priority": "high", "created_at": "2026-01-01T00:00:00Z", "updated_at": "2026-01-01T00:00:00Z" }

2. Listando SLAs

Para listar todos os SLAs configurados, use o endpoint List SLAs:

• URL: /slas
• Método: GET
• Headers:
  • Authorization: Bearer SEU_TOKEN_DE_API

Exemplo em Bash (cURL):

bash curl -X GET
'https://api.toolzz.dev/slas'
-H 'Authorization: Bearer SEU_TOKEN_DE_API'

Response JSON:

[ { "id": 123, "name": "SLA Padrão", "description": "SLA para todos os canais de atendimento", "target_response_time": 300, "target_resolution_time": 7200, "channel_ids": [1, 2, 3], "priority": "high", "created_at": "2026-01-01T00:00:00Z", "updated_at": "2026-01-01T00:00:00Z" }, { "id": 124, "name": "SLA Prioritário", "description": "SLA para clientes VIP", "target_response_time": 60, "target_resolution_time": 3600, "channel_ids": [1], "priority": "high", "created_at": "2026-01-02T00:00:00Z", "updated_at": "2026-01-02T00:00:00Z" } ]

3. Obtendo Métricas do SLA

Para obter um relatório de métricas do SLA, use o endpoint Get SLA Metrics Report:

• URL: /slas/{sla_id}/metrics
• Método: GET
• Headers:
  • Authorization: Bearer SEU_TOKEN_DE_API

Parâmetros na URL:

• sla_id: ID do SLA que você deseja obter as métricas.

Exemplo em JavaScript:

javascript const sla_id = 123; const url = https://api.toolzz.dev/slas/${sla_id}/metrics;

fetch(url, { method: 'GET', headers: { 'Authorization': 'Bearer SEU_TOKEN_DE_API' } }) .then(response => response.json()) .then(data => console.log(data));

Response JSON:

{ "sla_id": 123, "response_rate": 0.95, "resolution_rate": 0.90, "average_response_time": 250, "average_resolution_time": 6800, "breached_count": 5 }

Tabela de Parâmetros:

Webhooks: Recebendo Notificações em Tempo Real

Para ser notificado em tempo real quando um SLA é violado, você pode configurar webhooks. O Toolzz Chat enviará uma requisição HTTP para a URL que você especificar sempre que um evento de violação de SLA ocorrer.

1. Crie um Endpoint: Configure um endpoint na sua aplicação para receber as notificações do Toolzz Chat.
2. Registre o Webhook: Use o endpoint Add A Webhook para registrar o webhook no Toolzz Chat.

• URL: /webhooks
• Método: POST
• Headers:
  • Content-Type: application/json
  • Authorization: Bearer SEU_TOKEN_DE_API

Body JSON:

{ "name": "Notificação de Violação de SLA", "url": "https://sua-aplicacao.com/webhook", "event": "sla.breached", "active": true }

Tabela de Parâmetros:

Testando a Integração

Para testar a integração, siga estes passos:

1. Crie um Cenário de Teste: Inicie uma conversa no Toolzz Chat e deixe o tempo de resposta ou resolução exceder o limite definido no SLA.
2. Verifique os Alertas: Verifique se os alertas foram enviados para os canais configurados (email, painel, etc.).
3. Analise as Métricas: Use o endpoint Get SLA Metrics Report para verificar se as métricas do SLA foram atualizadas corretamente.
4. Monitore os Webhooks: Se você configurou webhooks, verifique se sua aplicação recebeu a notificação de violação de SLA.

Erros Comuns e Troubleshooting

• Token de API Inválido: Verifique se o token de API está correto e se você tem as permissões necessárias.
• Erros de Validação: Verifique se os dados que você está enviando para a API estão no formato correto.
• Problemas de Conexão: Verifique se sua aplicação consegue se conectar à API do Toolzz Chat.
• Webhooks Não Disparados: Verifique se o webhook está ativo e se a URL está correta. Verifique também os logs da sua aplicação para identificar possíveis erros.

Conclusão

Monitorar o SLA de atendimento via API do Toolzz Chat é uma estratégia poderosa para garantir a qualidade do seu suporte e a satisfação dos seus clientes. Ao automatizar o processo, você economiza tempo, obtém dados em tempo real e identifica gargalos, permitindo que você tome decisões informadas e implemente melhorias contínuas. A API do Toolzz Chat oferece flexibilidade e controle total sobre o monitoramento do SLA, permitindo que você adapte a solução às suas necessidades específicas.

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? Conheça a Toolzz.