Cómo usar el parámetro

Añade updated_within_days como parámetro de consulta a tu solicitud:

GET /v1/contacts?updated_within_days=7

Esto devuelve solo los contactos cuyos datos se han modificado en los últimos 7 días. La ventana es deslizante desde el momento de la solicitud, por lo que 1 equivale a las últimas 24 horas.

Los valores válidos son números enteros del 1 al 365. Si omites el parámetro, el endpoint funciona exactamente igual que antes y devuelve todos los contactos.

La descripción completa del parámetro la encuentras en la especificación OpenAPI a través de GET /v1/openapi.json.

Fiabilidad de `updated_at`

A partir de esta versión, el timestamp updated_at de un contacto solo se actualiza cuando realmente cambia algo en los datos del contacto. Anteriormente, este campo también se modificaba durante la importación nocturna, aunque no hubiera ningún cambio.

Ten en cuenta que el timestamp aún no es completamente fiable en todas las situaciones. Las cancelaciones de suscripción y los cambios en la pertenencia a listas no se reflejan actualmente en updated_at. Por lo tanto, los contactos que solo se hayan dado de baja o se hayan añadido a una lista pueden quedar fuera de tus resultados al filtrar por updated_within_days.

Preguntas frecuentes

Los valores como 0 o superiores a 365 están fuera del rango válido. Consulta la especificación OpenAPI (GET /v1/openapi.json) para ver la respuesta de error exacta que devuelve la API en ese caso.

Si un contacto solo ha cancelado su suscripción y no ha sufrido ningún otro cambio, updated_at aún no se actualiza en ese caso. Ese contacto no aparecerá en los resultados de updated_within_days, aunque haya habido un cambio relevante. Esto también se aplica a los cambios en la pertenencia a listas.

El parámetro está documentado en la especificación OpenAPI de Xendy. Puedes acceder a ella a través de GET /v1/openapi.json.

Joeri Ras

Escrito por

Joeri Ras

Fundador y copropietario @ Xendy

¿Prefieres contacto directo?

Artículos relacionados

Integraciones

Conectar Gravity Forms

Con Gravity Forms puedes crear formularios fácilmente en WordPress. Al conectarlo con Xendy, los envíos llegan automáticamente a un segmento estático, para que puedas usar los nuevos contactos directamente en newsletters o automatizaciones de correo.

Leer más
Integraciones

Conectar tu tienda Lightspeed

Al conectar Lightspeed con Xendy, los datos de clientes, pedidos y productos se sincronizan automáticamente cada noche. Así puedes crear segmentos basados en el comportamiento de compra y mostrar productos directamente en tus emails.

Leer más
Integraciones

Conectar tu tienda Magento 2

Al conectar Magento 2 con Xendy, los datos de clientes, pedidos y productos se sincronizan automáticamente cada noche. Así puedes crear segmentos basados en el comportamiento de compra, mostrar recomendaciones de productos personalizadas y hacer seguimiento de carritos abandonados. Ten en cuenta que los carritos abandonados en Magento 2 solo funcionan para clientes que han iniciado sesión en tu tienda online.

Leer más
Integraciones

Conectar tu tienda Shopify

Al conectar Shopify con Xendy, los datos de clientes, pedidos y productos se actualizan automáticamente cada noche. Así puedes crear segmentos basados en el comportamiento de compra y añadir recomendaciones de productos personalizadas en tus correos electrónicos. Los carritos abandonados funcionan a través de la app de Xendy en Shopify: quien abandona el proceso de pago recibe automáticamente el correo de recordatorio. Si quieres usar esto, ponte en contacto con el soporte.

Leer más