HotelDataHub - Añadir contactos desde hotspot

Tabla de contenidos¶

Introducción
Aspectos a tener en cuenta
¿Cómo funciona?
Ejemplo

Introducción¶

En este artículo, se muestran los aspectos a tener en cuenta para indicar el hotel en el que un cliente ha hecho wifi login, para ello, el Hotel Data Hub crea internamente en Fideltour un movimiento.

¿Por qué crear estos movimientos?¶

La necesidad de crear este tipo de movimientos, surge de la importancia que puede tener el producto o servicio consumido por cada contacto, a la hora de segmentarlos. El ejemplo más claro es el siguiente: si un contacto se ha alojado en el hotel, ya cumple las condiciones para recibir encuestas o comunicaciones relacionadas con su estancia. En cambio si el contacto solo ha consumido algún servicio del hotel (piscina, spa, restaurante, etc.) no se considera apto para cierto tipo de encuestas o comunicaciones.

Aspectos a tener en cuenta¶

Este servicio de la HotelDataHub API.V1, es exclusivamente para portales cautivos Wi-Fi externos, por tanto es indispensable indicar el origen del contacto correctamente (source=1), de lo contrario no se crea el movimiento. Además, existe otra restricción que hay que tener en cuenta, si no se indica el hotel, o este no está vinculado con el usuario de la API que hace la petición, tampoco se crea el movimiento.

¿Cómo funciona?¶

El proveedor debe realizar una petición POST o PATCH a contacts/, dependiendo si es un contacto nuevo o uno existente, y el body de dicha petición debe incluir, como mínimo, el atributo "hotel", donde se indica el ID del hotel en Fideltour.

Atributos opcionales del movimiento¶

Atributo	Tipo	Descripción	Valor por defecto
`booking_type`	Integer	Ver valores en tabla de parámetros	1 (Stay)
`entrance`	String	Fecha de entrada (YYYY-MM-DD)	Fecha de creación del movimiento
`departure`	String	Fecha de salida (YYYY-MM-DD)	Fecha de creación del movimiento
`room_number`	String	Número de habitación	-
`localizer`	String	Localizador de reserva	-

⚠️ Importante¶

El nombre del atributo es "hotel", NO "hotel_id"
El booking_type debe ser 1 si la persona que usa el wifi está alojada en el hotel, sino, usar el valor 2 (visitante)

Ejemplo¶

Se quiere dar de alta un contacto que ha hecho wifi login en el hotel, con id=1234. En el formulario de wifi se ha especificado la siguiente información:

Campo	Valor
Nombre	Juan
Apellidos	Serrano López
Email	juanserranolopez@gmail.com
Fecha de nacimiento	21/11/1990
Género	Hombre
Check-in	05/03/2024
Check-out	10/03/2024
Localizador	ABC1234
Habitación	300

Request¶

POST https://app.hoteldatahub.io/api/v1/contacts/ HTTP/1.1
Content-Type: application/json

{
    "email": "juanserranolopez@gmail.com",
    "name": "Juan",
    "surname": "Serrano López",
    "birthday": "1990-11-21",
    "gender": 1,
    "hotel": 1234,
    "booking_type": 1,
    "entrance": "2024-03-05",
    "departure": "2024-03-10",
    "localizer": "ABC1234",
    "room_number": "300",
    "source": 1
}

Response¶

En caso de una respuesta 200 o 201, se recibe un JSON con toda la información del contacto creado.