Pular para o conteúdo principal

Changelog

Mudanças que afetam quem integra com a API. Alterações que quebram contrato são marcadas com atenção.

2026-09​

Checkout público, para montar a contratação a partir do seu site​

Um conjunto novo em /api/v1/public_checkout/, sem chave de API, para quem leva o cliente do site até a contratação:

  • POST /link monta a URL do checkout já com o plano, o ciclo, as caixas de entrada adicionais e o cupom, e devolve pronta para publicar. Sua landing page não escreve a query string na mão.
  • GET /plans lista a tabela de preços publicada, para a página desenhar a própria seção de planos sem repetir nomes e valores.
  • POST /coupon valida um cupom antes de mostrar o preço com desconto.
  • POST /subscribe cria a conta e abre a assinatura num passo só.
  • POST /quote recebe um pedido de plano sob medida.

O plano é identificado pelo slug (profissional), nunca pelo id: o id é diferente em cada instalação, então um link com id fixo aponta para o plano errado assim que muda de ambiente.

Dados do cliente não vão na URL. O que você mandar em customer no POST /link fica guardado por 24 horas e o link carrega só um token opaco, que o checkout troca pelos dados e apaga da barra de endereço. Nome, e-mail, telefone e CNPJ numa query string acabariam no histórico do navegador, no log de acesso e no cabeçalho Referer mandado ao provedor de pagamento.

Cupom de desconto na cobrança da conta​

POST /api/v1/accounts/{id}/billing/coupon valida um cupom para a conta que já é cliente, com o mesmo desconto que a fatura vai aplicar.

2026-07​

Documentação da API ganhou site próprio​

A referência saiu de dentro do produto (era um ReDoc embutido em Configurações → API) e passou a viver aqui, em docs.azchat.digital, com guias, exemplos de código em cinco linguagens e console para testar requisições.

O que mudou na prática:

  • Cobertura completa. A referência antiga descrevia 144 operações. Esta cobre todas as ~590 rotas da API, porque é gerada a partir das rotas reais da aplicação. Isso inclui todo o CRM (negociações, funis, tarefas, empresas, produtos), marketing (públicos, disparos, follow-ups) e Captain, que nunca tinham aparecido em documentação nenhuma.
  • Nem tudo foi revisado. Cerca de 1 em cada 6 operações tem descrição escrita à mão; o resto traz caminho, parâmetros e campos do corpo derivados do código, com um aviso indicando que ainda não passaram por revisão. Isso vai melhorar por área, começando pelo CRM.
  • Em português. A referência antiga era herdada do Chatwoot e estava toda em inglês.

Atenção: a rota interna /api-docs foi removida, junto com a configuração API_DOCS_ACCESS_TOKEN. Se você tinha um link salvo para ela, use este site. Nenhum endpoint da API em si foi alterado.