Cambios en los datos de webhook del calendario: lo que necesitas saber
En este artículo, abordaremos:
- Qué estamos cambiando y por qué
- Qué comprobar antes de la actualización
- Cambios en los datos de los webhooks del calendario
- Un ejemplo del antes y el después
- Qué permanece igual
- Qué viene después para la API del calendario
Qué está cambiando y por qué
Estamos adaptando los datos de los webhooks del calendario al formato de la API abierta de Flowlu. Esto nos ayudará a mantener la coherencia del formato de los datos y facilitará el desarrollo y el mantenimiento de futuras integraciones.
Todos los webhooks del calendario pasarán al nuevo formato el 19 de octubre de 2026. El formato anterior dejará de estar disponible.
Qué comprobar antes de la actualización
Si tus integraciones gestionan la creación, actualización o eliminación de eventos del calendario, comprueba lo siguiente:
- Tipos de datos: Asegúrate de que tus controladores admitan números y valores
nullen lugar de cadenas de texto. - Nombres de los campos: Actualiza las referencias a los campos renombrados o eliminados.
- Campos ausentes: Comprueba que tu código no dé por hecho que todos los campos están presentes.
- Fechas: Si las zonas horarias son importantes, utiliza los nuevos campos
*_f_atom.
No podrás probar el nuevo formato con datos reales de webhooks antes del lanzamiento. Utiliza los ejemplos a continuación para prepararte y, después, comprueba las primeras entregas de webhooks en cuanto entre en vigor la actualización.
Cambios en los datos de los webhooks del calendario
1. Tipos de datos
Anteriormente, todos los valores se enviaban como cadenas de texto:
"id": "965848", "status": "1"
Después de la actualización, los números seguirán siendo números y los valores vacíos podrán enviarse como null:
"id": 965849, "status": 1, "deleted_at": null
Revisa las comparaciones estrictas o las conversiones de cadenas de texto en tu código.
2. Campos incluidos
Anteriormente, los datos de los webhooks contenían todos los campos de la entidad, incluidos los vacíos, como deadline, priority, cost y time_estimate.
Después de la actualización, solo se incluirán los campos con valores y los atributos principales del evento.
Comprueba si un campo existe antes de utilizarlo.
3. Campos renombrados y eliminados
| Campo anterior | Nuevo 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 |
Los campos author_id y crm_contact_id dejarán de enviarse.
Si antes utilizabas author_id, empieza a usar owner_id, que identifica al organizador del evento.
4. Fechas en formato ISO 8601
Cada campo de fecha tendrá un campo adicional con el sufijo _f_atom, que contendrá el desplazamiento de la zona horaria del portal.
Por ejemplo:
"plan_start_date_f_atom": "2026-10-15T11:08:00+05:00"
Recomendamos utilizar estos campos al trabajar con fechas y zonas horarias.
Ejemplo: creación de un evento en el calendario
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": ""
}
}
Después:
{
"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"
}
}
Los ejemplos muestran el bloque current. La estructura meta permanece sin cambios.
Qué permanece igual
- El mecanismo de entrega de los webhooks y la estructura
meta(module,model,action). - Los campos de fecha originales sin el sufijo
_f_atom. Mantienen el formatoYYYY-MM-DD HH:MM:SSen la zona horaria del portal. - El bloque
previouspara las actualizaciones de eventos, aunque sus datos seguirán las nuevas reglas de formato.
Qué viene después
Con esta actualización, estamos preparando el calendario para su API abierta.
La próxima API permitirá listar, consultar, crear, actualizar y eliminar eventos, además de ofrecer operaciones independientes para eventos recurrentes. También incluirá filtros por calendario y fecha, con documentación para cada método.
Compartiremos más detalles cuando la API del calendario esté lista.
Mientras tanto, si tienes alguna pregunta sobre la actualización o necesitas ayuda para preparar tus integraciones, no dudes en contactarnos en [email protected].
