Changelog da API

Versão atual: 1.4.0 (cada resposta de /api/v1 traz o cabeçalho X-NexaChat-API-Version).

Política de versões

Dentro da v1, só acréscimos: novos campos, rotas, eventos de webhook e parâmetros opcionais. Nada é removido nem muda de significado. O seu código deve ignorar campos que não conhece.
Qualquer quebra vai para a v2 (/api/v2), com aviso de, no mínimo, 90 dias e as duas versões no ar juntas por, no mínimo, 90 dias.
O widget segue a mesma regra: /embed/v1.js é estável (o /embed.js é a própria v1). Uma mudança incompatível só sai em /embed/v2.js, com a v1 mantida por, no mínimo, 90 dias.
Avisos: mudanças programadas e manutenções chegam pelo evento de webhook platform.notice e por e-mail aos contatos técnicos cadastrados no painel. O estado atual e os incidentes ficam em /status.
Rotas e campos descontinuados continuam funcionando durante todo o prazo e passam a responder com o cabeçalho Deprecation e a data em Sunset.

Todas as respostas de /api/v1 trazem o cabeçalho X-NexaChat-API-Version (ex.: 1.4.0).
Evento de webhook platform.notice (mudanças programadas, manutenções e incidentes) e contatos técnicos por empresa para avisos por e-mail.
Política de versões publicada: dentro da v1 só acréscimos; quebras só na v2, com aviso e convivência de no mínimo 90 dias.
Webhooks: Enviar teste com o corpo real de qualquer evento e troca de segredo com período de convivência (cabeçalho X-NexaChat-Signature-Previous).
Widget: /embed/v1.js estável (o /embed.js é a mesma v1), identidade do cliente assinada pelo seu servidor e API em JavaScript. Não altera a API REST.

Eventos de webhook area.activated e area.ended (áreas de aviso do mapa; sem coordenadas).
GET /telephony/identify devolve affected_area (id e name, ou null): o cliente mora numa área de aviso ativa. Só acréscimo.
Painel ao vivo, Metas e SLA, Pausas, Reincidências, Mapa e Sugestão de resposta por IA são recursos do painel e não alteram a API além dos itens acima.

Atendimento: novo campo close_reason (motivo do encerramento, observação e quem encerrou: pessoa, robô ou API); POST /conversations/{id}/close aceita close_reason e note.
Webhook conversation.closed agora traz close_reason, close_note e closed_by.
Eventos novos: sla.breached, agent.paused, agent.resumed, agent.pause_exceeded e customer.recurrent (cliente reincidente).
Atendimento: novo campo recurrence (regras de reincidência em que se enquadrou).

Webhooks documentados na especificação (seção webhooks): cabeçalhos, assinatura HMAC-SHA256, política de reenvio e o campo test.
Eventos novos: quality.generated, lead.created, lead.stage_changed, invoice.paid, call.received, call.missed.
Mensagem: novos campos channel e transcript (texto do áudio) e valores documentados de delivery_status (sent, delivered, read, failed).
Atendimento: novos campos tags, department e quality (Nota de Qualidade, somente leitura).
Evento message.received de áudio passa a trazer transcript.

Primeira versão pública: contatos, atendimentos, mensagens, agentes, filas e canais; tokens com escopo; paginação por cursor; Idempotency-Key; limite de 300 requisições por minuto.