Central de Ajuda

Aparência

09/10/2026 - Novo padrão de datas em Webhooks e API ​

🔗 Webhooks e API: Padronização do formato de datas ​

Os campos personalizados de data e horário eram retornados em formatos diferentes nos webhooks e na API.

Nos webhooks, as datas eram enviadas no formato americano (mês/dia/ano), o que fazia o dia e o mês parecerem invertidos. Na API, as datas vinham com barras, os campos de horário podiam vir com as horas e os minutos invertidos, e os campos de data e hora não indicavam o fuso horário. Com isso, os sistemas integrados podiam interpretar as datas de forma incorreta.

✅ O que foi corrigido? ​

Webhooks e API passam a seguir o mesmo padrão para os campos personalizados, no formato ISO 8601:

  • Data: retornada no formato YYYY-MM-DD (ex: 2025-12-31).
  • Data e Hora: retornada no formato YYYY-MM-DDThh:mm:ss.fffffff±hh:mm (ex: 2025-12-31T23:45:00.0000000-03:00).
  • Data e Hora: o valor mantém exatamente o horário preenchido pelo usuário e indica o fuso horário configurado na conta, sem conversão de fuso.
  • Horário: retornado corretamente na API no formato hh:mm (ex: 08:52), sem inversão entre horas e minutos.
  • Campos em intervalo: cada valor do intervalo segue o formato do seu tipo, mantendo a estrutura atual (lista na API e texto separado por vírgula nos webhooks).

Campos personalizados preenchidos no contato.

Os mesmos campos retornados pela API, com o horário preenchido e o fuso da conta.

A mudança vale para: ​

  • Webhooks: Contato alterado; Painel: Card criado, Card alterado e Card movido.
  • API de Contatos: Listar, Filtrar, Obter por ID e Obter por número de telefone.
  • API de Cards: Listar e Obter por ID.

⚠️ O que não muda: os campos padrão da plataforma, como data de criação e data de vencimento, continuam sendo convertidos e retornados em UTC (ex: um vencimento em 15/10/2026 às 23:59, no horário de Brasília, é retornado como 2026-10-16T02:59:41Z). A exibição de datas nas mensagens enviadas ao cliente final também não é afetada.

Card com a data de vencimento (campo padrão) e campos personalizados de data, data e hora e horário.

Na API, o vencimento é convertido para UTC, enquanto os campos personalizados mantêm o valor preenchido.

Como esses campos passam a ser enviados nos webhooks.

Se a sua integração lê ou interpreta campos personalizados de data ou horário, confirme que ela está preparada para o novo formato e para o fuso horário informado nos campos de data e hora.