Alterações nos dados de webhook do calendário: o que você precisa saber
Neste artigo, vamos abordar:
- O que estamos mudando e por quê
- O que verificar antes da atualização
- Alterações nos dados dos webhooks do calendário
- Um exemplo de antes e depois
- O que permanece igual
- O que vem a seguir para a API do calendário
O que está mudando e por quê
Estamos alinhando os dados dos webhooks do calendário ao formato da API aberta do Flowlu. Isso nos ajudará a manter a consistência do formato dos dados e facilitará o desenvolvimento e a manutenção de futuras integrações.
Todos os webhooks do calendário passarão a usar o novo formato em 19 de outubro de 2026. O formato antigo não estará mais disponível.
O que verificar antes da atualização
Se suas integrações lidam com a criação, atualização ou exclusão de eventos do calendário, verifique o seguinte:
- Tipos de dados: Certifique-se de que seus manipuladores de eventos aceitam números e valores
nullem vez de strings. - Nomes dos campos: Atualize as referências aos campos renomeados ou removidos.
- Campos ausentes: Verifique se seu código não pressupõe que todos os campos estejam presentes.
- Datas: Se os fusos horários forem importantes, use os novos campos
*_f_atom.
Você não poderá testar o novo formato com dados reais de webhooks antes do lançamento. Use os exemplos abaixo para se preparar e, depois, verifique as primeiras entregas de webhooks assim que a atualização entrar em vigor.
Alterações nos dados dos webhooks do calendário
1. Tipos de dados
Anteriormente, todos os valores eram enviados como strings:
"id": "965848", "status": "1"
Após a atualização, os números continuarão sendo números, e os valores vazios poderão ser enviados como null:
"id": 965849, "status": 1, "deleted_at": null
Revise as comparações estritas ou conversões de strings no seu código.
2. Campos incluídos
Anteriormente, os dados dos webhooks continham todos os campos da entidade, incluindo os vazios, como deadline, priority, cost e time_estimate.
Após a atualização, apenas os campos com valores e os principais atributos do evento serão incluídos.
Verifique se um campo existe antes de utilizá-lo.
3. Campos renomeados e removidos
| Campo anterior | Novo campo |
created |
created_date |
created_by |
owner_id |
changed |
updated_date |
changed_by |
updated_by |
crm_company_id |
crm_account_id |
status_changed_date |
status_updated_date |
status_changed_by |
status_updated_by |
Os campos author_id e crm_contact_id não serão mais enviados.
Se você usava author_id anteriormente, passe a usar owner_id, que identifica o organizador do evento.
4. Datas no formato ISO 8601
Cada campo de data terá um campo adicional com o sufixo _f_atom, contendo o deslocamento do fuso horário do portal.
Por exemplo:
"plan_start_date_f_atom": "2026-10-15T11:08:00+05:00"
Recomendamos usar esses campos ao trabalhar com datas e fusos horários.
Exemplo: criação de um evento no calendário
Antes:
{
"current": {
"id": "965849",
"name": "Meeting with a client",
"status": "1",
"all_day": "1",
"responsible_id": "2002",
"created": "2026-10-08 11:09:04",
"deadline": "",
"priority": "2",
"time_estimate": ""
}
}
Depois:
{
"current": {
"id": 965849,
"name": "Meeting with a client",
"status": 1,
"all_day": 1,
"responsible_id": 2002,
"created_date": "2026-10-08 11:09:04",
"created_date_f_atom": "2026-10-08T11:09:04+05:00",
"plan_start_date_f_atom": "2026-10-15T11:08:00+05:00"
}
}
Os exemplos mostram o bloco current. A estrutura meta permanece inalterada.
O que permanece igual
- O mecanismo de entrega dos webhooks e a estrutura
meta(module,model,action). - Os campos de data originais sem o sufixo
_f_atom. Eles mantêm o formatoYYYY-MM-DD HH:MM:SSno fuso horário do portal. - O bloco
previouspara atualizações de eventos, embora seus dados sigam as novas regras de formatação.
O que vem a seguir
Com esta atualização, estamos preparando o calendário para sua API aberta.
A futura API permitirá listar, consultar, criar, atualizar e excluir eventos, além de oferecer operações separadas para eventos recorrentes. Ela também incluirá filtros por calendário e data, com documentação para cada método.
Compartilharemos mais detalhes quando a API do calendário estiver pronta.
Enquanto isso, se você tiver alguma dúvida sobre a atualização ou precisar de ajuda para preparar suas integrações, entre em contato conosco pelo e-mail [email protected].
