Zapier

Tabla de contenidos¶

• Introducción
• Primeros pasos
• Acciones
• Gestión de contactos
• Gestión de movimientos
• Webhooks disponibles
• Triggers de segmentos / audiencias
• Triggers de contactos
• Triggers de movimientos
• Suscripción REST hooks
• Casos de uso
• Sincronización con Google Ads
• Sincronización con Meta (Facebook Ads)

Introducción¶

La app de Fideltour en Zapier permite automatizar flujos sin desarrollo a medida. Ofrece dos tipos de capacidades:

• Triggers: Fideltour notifica a Zapier cuando ocurre un evento (contacto creado, audiencia activada, etc.). HDH actúa como intermediario recibiendo el evento de Fideltour y reenviándolo al Zap.
• Acciones: Zapier envía datos a Fideltour para crear o actualizar contactos y movimientos a través de la API de HDH.

Primeros pasos¶

Para utilizar la app de Fideltour en Zapier se necesita:

• Una cuenta de Fideltour.
• Una cuenta de Zapier.
• Credenciales específicas para conectar Fideltour desde Zapier. Deben solicitarse a hoteldatahub@fideltour.com. Junto con las credenciales se proporciona el código de cadena y los identificadores de hotel necesarios para las acciones de contactos y movimientos.

Para los casos de uso de sincronización de audiencias, el módulo Social de Fideltour debe estar contratado.

Acciones¶

Las acciones permiten enviar datos desde Zapier a Fideltour para crear o actualizar registros.

Gestión de contactos¶

Métodos disponibles¶

Importante: Fideltour considera únicos el email y el identification_number. Si se intenta crear un contacto con un email o número de documento ya existente, se recibirá un error. Se recomienda verificar que el contacto no existe (con Get contact by Email) antes de crearlo.

Casos de uso habituales¶

Actualización de un contacto:

1. Usar Get contact by Email para obtener el ID del contacto.

2. Zapier devuelve la información del contacto, incluyendo el ID.

3. Usar Update contact con el ID obtenido para modificar los datos.

Tabla de parámetros — contacto¶

Gestión de movimientos¶

Importante: un movimiento siempre pertenece a un contacto. Para crear un movimiento es obligatorio tener el ID del contacto en Fideltour (obtenido previamente con los métodos Get contact).

Métodos disponibles¶

Casos de uso habituales¶

Actualización de un movimiento:

1. Usar Get movements list con filtros (p. ej. localizer + input_channel) para localizar el movimiento.

2. Zapier devuelve la información del movimiento, incluyendo el ID.

3. Usar Update movement con el ID obtenido para modificar los datos.

Tabla de parámetros — movimiento¶

Webhooks disponibles¶

Los triggers permiten que Zapier reaccione a eventos de Fideltour en tiempo real mediante REST hooks.

Triggers de segmentos / audiencias¶

Estos triggers se activan sobre las audiencias configuradas en el módulo Social de Fideltour.

Activate Audience Segment (tipo 1)¶

Se dispara cada vez que se activa una audiencia en Fideltour.

Datos recibidos en el Zap:

Deactivate Audience Segment (tipo 2)¶

Se dispara cada vez que se desactiva una audiencia en Fideltour.

Datos recibidos en el Zap:

Add Contact to Audience Segment (tipo 3)¶

Se dispara cada vez que se añade un contacto al segmento de una audiencia activa en Fideltour.

Datos recibidos en el Zap:

Remove Contact from Audience Segment (tipo 4)¶

Se dispara cada vez que se elimina un contacto del segmento de una audiencia activa en Fideltour.

Datos recibidos en el Zap: idénticos a los de Add Contact to Audience Segment.

Triggers de contactos¶

Payloads:

• Creado / actualizado: ficha completa del contacto más hotel_chain.
• Cambio de nivel: { hotel_chain, contact, email, level, level_name, event: "level_updated" }.
• Desuscrito: { hotel_chain, contact, email, event: "unsubscribe" }.
• Loyalty actualizado: payload de Fideltour más hotel_chain y event: "loyalty_updated".
• Email inválido: payload de Fideltour más hotel_chain y event: "email_invalid".

El permiso requerido en el ApiUser para estos triggers es contacts.

Triggers de movimientos¶

Payload: datos del movimiento más hotel_chain.

El permiso requerido en el ApiUser para estos triggers es movements.

Suscripción REST hooks¶

Zapier gestiona las suscripciones contra HDH usando el ApiUser del cliente:

Alta (al activar un Zap):

POST https://app.hoteldatahub.io/api/v1/webhooks/zapier-webhooks-subscriptions/
Authorization: Token <jwt>
Content-Type: application/json

{
  "url": "https://hooks.zapier.com/hooks/standard/...",
  "type": 5
}

Baja (al desactivar el Zap):

DELETE https://app.hoteldatahub.io/api/v1/webhooks/zapier-webhooks-subscriptions/{id}/
Authorization: Token <jwt>

Cada ApiUser solo puede ver y gestionar sus propias suscripciones. Los permisos requeridos según el tipo: segments (tipos 1–4), contacts (tipos 5–10), movements (tipos 11–12).

Para que los triggers de contactos y movimientos funcionen, Fideltour debe estar configurado para enviar sus webhooks a los endpoints genéricos de HDH del cliente:

Casos de uso¶

Sincronización con Google Ads¶

Sincronización de audiencias configuradas en Fideltour con listas de clientes de Google Ads.

Requisitos adicionales: módulo Social de Fideltour contratado y cuenta de Google Ads.

1. Crear lista de clientes en Google Ads¶

Al activar una audiencia en Fideltour, crear automáticamente una lista de clientes en Google Ads usando el trigger Activate Audience Segment.

Se recomienda usar la plantilla de Zapier específica para ello.

Observaciones

• Si ya existe una lista de Google Ads con el mismo nombre que la audiencia, Zapier devolverá error (Google Ads no permite nombres duplicados).
• Al activar una audiencia que ya tiene histórico de contactos, Google Ads crea la lista pero no transfiere el histórico. Ver Exportación e importación del histórico.

2. Añadir contacto a una lista de Google Ads¶

Cuando se añade un contacto a una audiencia activa de Fideltour, añadirlo también a la lista de Google Ads correspondiente usando el trigger Add Contact to Audience Segment.

Se recomienda usar la plantilla de Zapier específica.

Observación: el Zap incluye una acción intermedia para buscar la lista de Google Ads por nombre antes de añadir el contacto.

3. Quitar contacto de una lista de Google Ads¶

Cuando se quita un contacto de una audiencia activa de Fideltour, quitarlo también de la lista de Google Ads usando el trigger Remove Contact from Audience Segment.

Se recomienda usar la plantilla de Zapier específica.

Observación: igual que en el caso anterior, el Zap incluye una acción intermedia para localizar la lista por nombre.

Exportación e importación del histórico (Google Ads)¶

Cuando una audiencia ya tiene histórico al activarse por primera vez, transferirlo uno a uno por Zapier es costoso. El proceso gratuito es:

1. Ir al apartado de contactos del módulo CRM de Fideltour.
2. Filtrar por el segmento de la audiencia.
3. Seleccionar todos y exportar a Excel.
4. En pocos minutos se recibe la exportación por email.
5. Adaptar la estructura del Excel al formato requerido por Google Ads.
6. Importar en la lista de Google Ads. Hay dos vías:

Lista de clientes nueva:

En el Gestor de audiencias, pulsar + y seleccionar Lista de clientes.

En la pantalla siguiente, seleccionar Subir un archivo manualmente como fuente de datos.

Asignar un nombre al segmento, subir el archivo CSV con los contactos exportados de Fideltour y guardar.

Editar lista existente:

En el Gestor de audiencias, localizar la lista correspondiente y pulsar Editar lista.

En el formulario de edición, seleccionar Añadir más clientes y subir el archivo CSV.

Sincronización con Meta (Facebook Ads)¶

Sincronización de audiencias configuradas en Fideltour con audiencias de Facebook Business Manager.

Requisitos adicionales: módulo Social de Fideltour contratado y cuenta de Facebook Business Manager.

1. Crear audiencia en Facebook¶

Al activar una audiencia en Fideltour, crear automáticamente una audiencia en Facebook usando el trigger Activate Audience Segment.

Se recomienda usar la plantilla de Zapier específica.

Observación: si la audiencia activada ya tiene histórico de contactos, Facebook crea la audiencia pero no transfiere el histórico. Ver Exportación e importación del histórico.

2. Añadir contacto a una audiencia de Facebook¶

Cuando se añade un contacto a una audiencia activa de Fideltour, añadirlo también a la audiencia de Facebook usando el trigger Add Contact to Audience Segment.

Se recomienda usar la plantilla de Zapier específica.

Observación: a diferencia de Google Ads, Facebook no tiene en Zapier una acción para encontrar audiencias por nombre. Esto implica que se necesita un Zap independiente por cada audiencia. Si hay 3 audiencias activas, se necesitan 3 Zaps.

3. Quitar contacto de una audiencia de Facebook¶

Cuando se quita un contacto de una audiencia activa de Fideltour, quitarlo también de la audiencia de Facebook usando el trigger Remove Contact from Audience Segment.

Se recomienda usar la plantilla de Zapier específica.

Observación: igual que en el caso de añadir, se necesita un Zap por audiencia.

Exportación e importación del histórico (Meta)¶

El proceso es equivalente al de Google Ads, sustituyendo el destino final por Facebook:

1. Ir al apartado de contactos del módulo CRM de Fideltour.
2. Filtrar por el segmento de la audiencia.
3. Seleccionar todos y exportar a Excel.
4. En pocos minutos se recibe la exportación por email.
5. Adaptar la estructura del Excel al formato requerido por Facebook.
6. Importar en la audiencia de Facebook. Hay dos vías:

Audiencia nueva:

En el Gestor de audiencias, pulsar Crear una audiencia personalizada.

Seleccionar Lista de clientes como origen de la audiencia.

Preparar el archivo siguiendo el formato requerido. Se puede descargar la plantilla oficial desde este paso.

Subir el archivo CSV con los contactos exportados de Fideltour.

Editar audiencia existente:

En el Gestor de audiencias, seleccionar la audiencia y pulsar Acciones.

Seleccionar Añadir clientes y subir el archivo CSV.