Webhooks
La misión de Actito es proporcionarte una gran conectividad en tu enfoque de marketing. Por lo tanto, prestamos especial atención a habilitar intercambios de datos entre Actito y otros sistemas específicos de tu negocio.
Varias soluciones te permiten interactuar directamente con Actito sin tener que pasar por la interfaz. La API pública de Actito ya te permite recuperar datos de Actito y enviar datos a Actito.
Los webhooks ofrecen el servicio inverso de los servicios web. Ya no es necesario hacer una llamada cada vez que necesites información. De hecho, los webhooks escuchan información. Al suscribirte a los webhooks, te permiten recibir notificaciones directamente de los eventos que ocurren en un perfil o una entrada en una tabla morada. Estos eventos se comunicarán a una URL que hayas proporcionado.
Esta sección de la documentación de la plataforma tiene como objetivo brindarte una perspectiva empresarial sobre lo que es posible a través de la plataforma de integración de Actito.
Para obtener detalles de implementación, los desarrolladores siempre deben consultar las especificaciones en el Portal de Desarrolladores.
Contexto
Eventos de interés
Los webhooks te permiten recibir notificaciones de eventos relacionados con las tablas de perfiles y las tablas personalizadas en el modelo de datos.
Estos eventos son de la siguiente naturaleza:
-
CREATE: Esto te permite recibir notificaciones cuando se crea un nuevo perfil o un nuevo registro de datos.
-
UPDATE: Esto te permite recibir notificaciones de cualquier cambio en un perfil o un registro de datos. Es posible especificar exactamente qué campos de la tabla deben tenerse en cuenta.
-
DELETE: Esto te permite recibir notificaciones cuando se elimina un perfil o un registro.
-
UPDATED_SEGMENT y UPDATED_SUBSCRIPTION: Estos eventos son específicos de las tablas de perfiles. Te permiten recibir notificaciones cuando hay un cambio en la suscripción o segmentación.
Para las tablas personalizadas del modelo en estrella, es necesario especificar los eventos en el archivo JSON de definición de la tabla (en el parámetro "eventToTrigger").
Siempre existe un evento CREATE por defecto en las tablas personalizadas, pero los eventos de UPDATE deben ser definidos (especialmente para definir qué campos actualizados desencadenan un evento).
No dude en contactar a su administrador de cuenta si necesita ayuda para configurar eventos en sus tablas.
Además de recuperar información de sus tablas, los webhooks también pueden obtener el estado de sus ETL y sincronización de archivos, o conectar sus escenarios con sistemas externos mediante acciones personalizadas.
Protocolo
Cada vez que se registra un evento que coincide con la definición de suscripción del webhook en Actito, el webhook enviará la información a la URL que ha proporcionado.
Para ayudarlo a manejar volúmenes más grandes, las llamadas pueden realizarse en modo unitario o en modo masivo. El modo masivo es útil cuando varios elementos se ven afectados al mismo tiempo (como en una importación por archivo), para agrupar las actualizaciones en una sola llamada. Sin embargo, los webhooks siempre obtienen la información en tiempo real: incluso en modo masivo, si se registra un evento y no se registra un segundo evento en los segundos siguientes, se enviará la notificación por webhook.
Acceso
Para recibir notificaciones cada vez que ocurre uno de los eventos en la tabla monitoreada, es necesario crear una suscripción a un webhook. Se debe crear una suscripción de webhook por evento monitoreado y por tabla monitoreada.
La creación y gestión de estas suscripciones se realiza a través de las APIs de Actito. Su definición está disponible en la documentación técnica.