SLA (Service Level Agreement)

Defina politicas de nivel de servico para monitorar tempos de primeira resposta, resolucao e acompanhar o cumprimento dos SLAs por equipe e agente.

Disponivel em todas as licencas

Os endpoints de SLA estao disponiveis em qualquer licenca NooviChat (trial, mensal, trimestral, anual). Todas as licencas entregam o conjunto completo de funcionalidades — o que muda entre planos e preco, duracao e limite de instancias VPS, nao as features.

Politicas SLA

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

Lista todas as politicas 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 politicas

json

{
  "payload": [
    {
      "id": 1,
      "name": "SLA Premium",
      "description": "Resposta rapida para contas prioritarias",
      "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 politica SLA.

Body (envolto em objeto sla_policy)

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Sim	Nome da politica
`description`	`string`	Nao	Descricao
`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 resolucao (segundos)
`only_during_business_hours`	`boolean`	Nao	Considerar apenas horario 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 politica SLA.

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

Atualiza uma politica SLA.

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

Remove uma politica 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 Metricas. Acesso restrito a administradores da conta.

Parametros (query)

Nome	Tipo	Obrigatorio	Descricao
`sla_policy_id`(query)	`integer`	Nao	Filtrar por politica 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 atribuido
`label_list`(query)	`string`	Nao	Filtrar por etiquetas (separadas por virgula)
`page`(query)	`integer`	Nao	Pagina (25 por pagina)

Metricas SLA

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

Metricas agregadas de cumprimento de SLA.

200Metricas 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 relatorio de SLA como CSV.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`start_date`(query)	`string`	Nao	Data inicio (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