Changelog e versionamento

Como a API do CRM evolui sem quebrar a sua integração, e o que mudou em cada data.

Versionamento

A versão faz parte da URL (/v1). Dentro de uma versão só entram mudanças compatíveis: rota nova, campo novo na resposta, parâmetro opcional novo, valor novo num enum de resposta, evento novo. Remover ou renomear rota ou campo, mudar tipo ou tornar obrigatório um parâmetro opcional só acontece numa nova versão. Ignore campos que você não conhece.

Depreciação

Rota ou campo depreciado continua funcionando por pelo menos 90 dias depois do anúncio aqui. Uma versão anterior continua no ar por pelo menos 12 meses depois do lançamento da seguinte. Correções de segurança podem mudar comportamento imediatamente e sempre aparecem aqui.

Disponibilidade

Ainda não há página de status pública do CRM. Para monitorar do seu lado, uma chamada autenticada leve (como GET /v1/contacts?pageSize=1) por minuto é suficiente.

Histórico

01/10/2026

• Correção API key funciona só com X-API-Key (antes exigia também X-Tenant-Slug e respondia 400); o tenant vem da credencial. Chave de outro tenant e chamada sem credencial respondem 401.
• Novo Webhooks: os 12 eventos passam a disparar (contact.updated, deal.created, survey.responded, campaign.completed, journey.enrolled, journey.completed eram aceitos mas nunca enviados), score.rule_fired é assinável, payload ganha id e o cabeçalho X-AllyOne-Event traz o tipo do evento.
• Segurança Rate limit por usuário (sessão) ou por IP — não depende mais de cabeçalho enviado pelo cliente. A listagem de webhooks mostra o secret mascarado.
• Docs Novas páginas: Webhooks, Erros e limites e este Changelog. Corrigidos o caminho do Embedded Signup (/v1/waba-accounts/...) e o local dos dados (União Europeia).

28/09/2026

• Segurança Bloqueio de login por e-mail + IP após tentativas erradas; senhas que constam em vazamentos públicos são recusadas.

24/09/2026

• Novo Consentimento e descadastro por canal em formulários e no link de descadastro.
• Mudança Eliminação LGPD de um contato propaga para o AllyOneMail e apaga as mídias; a exportação do titular inclui conversas, mensagens, tickets, notas e pedidos.

21 a 23/09/2026

• Segurança Proteção contra SSRF e DNS rebinding na entrega de webhooks e nas ações send_webhook; redirecionamentos deixaram de ser seguidos. Exportação de dados de contato passou a exigir a permissão lgpd.*.

22/09/2026

• Novo WhatsApp via BSPs terceiros (360dialog, Infobip, Gupshup, Blip), além da Cloud API.

16/09/2026

• Mudança Todo envio de e-mail do CRM passa pelo AllyOneMail (o CRM deixou de falar SMTP direto).

09/09/2026

• Novo Papel agent (atendente só vê as conversas atribuídas a ele), atribuição automática e prioridade de conversa; Instagram DM, comentários e menções no Chat Flow.