info@fleetmailer.com

Documentación sobre API

MANUAL PARA INTEGRADORES

/subscriber/get

Obtiene los datos del suscriptor, el estado y el historial de acciones y eventos.

Parámetros
Nombre Descripción
list_id
string		 ID de la lista. (opcional).
email
string		 Dirección de email del suscriptor.

 

Valores de retorno
status “success”.
data Array con los datos del suscriptor.

name Nombre del suscriptor.
email Email del suscriptor.
status Estado de la suscripción. “pending”, “subscribed”, “invalid”, “blocked”.
subscribed Fecha de suscripción en formato unix.
created Fecha de creación en formato unix.
*custom_fields* Valor de cada campo
log Array con el historial de acciones del suscriptor.

action Nombre de la acción: “subscribe”, “unsubscribe”, “blocked”, “complaint”, “open”, “click”, “event”, “site_track”.
date Fecha en formato unix.
list_id ID de la lista, en caso de que aplique.
message_id ID de la campaña o mensaje, en caso de que aplique.
data Array con información adicional sobre la acción.

 

Códigos de error
S13001L La lista no existe.
S10001D La dirección de email no es válida.
S14002E La dirección no se encuentra en la lista.

 

Fecha de suscripción y fecha de creación

Esta fecha puede diferir según el momento en que el suscriptor confirme su suscripción.

‘subscribed’ define la fecha en que el usuario confirme su suscripción. Si el email fue agregado por el administrador manualmente, esta fecha será la fecha en que fue ingresado a la lista.
‘created’ define la fecha en que el usuario completa el formulario de suscripción. Si el email fue agregado por el administrador manualmente, esta fecha será la fecha en que fue ingresado a la lista.

 

Historial de acciones

Cada acción tendrá información adicional. Por ejemplo, en una desuscripción, se indicara el origen de la desuscripción, que puede ser vía link de desuscripción, vía denuncia o manualmente vía API.

La acción “click” indica que el suscriptor hizo click en un link. En este caso se van a dar datos adiciones sobre el enlace.

La acción “open” indica que el suscriptor abrió un email o campaña. En “data”, se indican datos adicionales de locación (si estuviera disponibles) como país, región, ciudad, y los datos del dispositivo del cliente (si estuviera disponible) como tipo de dispositivo, sistema operativo, cliente de correo o navegador.

La acción “site_track” registra toda la navegación del suscriptor en su sitio web cuando lo visita desde un email. En datos adicionales se indica la URL de cada pagina visitada. Si la acción es “site_track” también se indicara la el nombre de la conversión/objetivo en caso de haber sido alcanzado.