SLA (Service Level Agreement)

Defina políticas de nível de serviço para monitorar tempos de primeira resposta, resolução e acompanhar o cumprimento dos SLAs por equipe e agente.

Disponível em todas as licenças

Os endpoints de SLA estão disponíveis em qualquer licença NooviChat (trial, mensal, semestral, anual; trimestral é legacy/backcompat). Todas as licenças entregam o conjunto completo de funcionalidades — o que muda entre planos é preço, duração e limite de instâncias VPS, não as features.

Políticas SLA

GET/api/v1/accounts/{account_id}/sla_policies

Lista todas as políticas SLA da conta.

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/sla_policies" \
  -H "api_access_token: YOUR_TOKEN" | jq .

200Lista de políticas

json

{
  "payload": [
    {
      "id": 1,
      "name": "SLA Prioritário",
      "description": "Resposta rapida para contas prioritárias",
      "first_response_time_threshold": 300,
      "next_response_time_threshold": 900,
      "resolution_time_threshold": 14400,
      "only_during_business_hours": true,
      "created_at": "2025-06-01T00:00:00Z"
    }
  ]
}

POST/api/v1/accounts/{account_id}/sla_policies

Cria uma nova política SLA.

Body (envolto em objeto sla_policy)

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Sim	Nome da política
`description`	`string`	Nao	Descrição
`first_response_time_threshold`	`integer`	Nao	Tempo max primeira resposta (segundos)
`next_response_time_threshold`	`integer`	Nao	Tempo max respostas seguintes (segundos)
`resolution_time_threshold`	`integer`	Nao	Tempo max resolução (segundos)
`only_during_business_hours`	`boolean`	Nao	Considerar apenas horário comercial

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/sla_policies" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "sla_policy": {
      "name": "SLA Padrao",
      "first_response_time_threshold": 600,
      "next_response_time_threshold": 1800,
      "resolution_time_threshold": 28800,
      "only_during_business_hours": true
    }
  }'

GET/api/v1/accounts/{account_id}/sla_policies/{id}

Retorna detalhes de uma política SLA.

PATCH/api/v1/accounts/{account_id}/sla_policies/{id}

Atualiza uma política SLA.

DELETE/api/v1/accounts/{account_id}/sla_policies/{id}

Remove uma política SLA.

SLAs Aplicados

Acompanhe o cumprimento dos SLAs em conversas individuais.

GET/api/v1/accounts/{account_id}/applied_slas

Lista as conversas que violaram (missed) algum SLA. Endpoint restrito a administradores.

Apenas SLAs violados

Este endpoint retorna somente os SLAs missed (violados). Para a taxa geral de cumprimento, use o endpoint de Métricas. Acesso restrito a administradores da conta.

Parâmetros (query)

Nome	Tipo	Obrigatorio	Descricao
`sla_policy_id`(query)	`integer`	Nao	Filtrar por política SLA
`inbox_id`(query)	`integer`	Nao	Filtrar por inbox
`team_id`(query)	`integer`	Nao	Filtrar por equipe
`assigned_agent_id`(query)	`integer`	Nao	Filtrar por agente atribuído
`label_list`(query)	`string`	Nao	Filtrar por etiquetas (separadas por vírgula)
`page`(query)	`integer`	Nao	Página (25 por página)

Métricas SLA

GET/api/v1/accounts/{account_id}/applied_slas/metrics

Métricas agregadas de cumprimento de SLA.

200Métricas SLA

json

{
  "total_applied_slas": 250,
  "number_of_sla_misses": 40,
  "hit_rate": "84.0%"
}

GET/api/v1/accounts/{account_id}/applied_slas/download

Exporta relatório de SLA como CSV.

Parâmetros

Nome	Tipo	Obrigatorio	Descricao
`start_date`(query)	`string`	Nao	Data início (YYYY-MM-DD)
`end_date`(query)	`string`	Nao	Data fim (YYYY-MM-DD)

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/applied_slas/download?start_date=2026-01-01&end_date=2026-01-31" \
  -H "api_access_token: YOUR_TOKEN" -o sla_report.csv