Conexiones de entrada

Conexiones de entrada

Introducción

Este endpoint del Webservice permite incorporar en Fideltour movimientos de conexión realizados desde plataformas de terceros.


Casos de uso

En muchas ocasiones un hotel dispone de servicios digitales a los que sus clientes pueden acceder y que no se engloban dentro de la categoría de reservas o estancias, movimientos habituales con los que trabaja Fideltour. No obstante estas conexiones pueden ser de utilidad para recuperar nueva información sobre un contacto y/o para enviarle comunicaciones según nos interese.

  1. Portales cautivos: Fideltour dispone de un servicio de portal cautivo que el usuario puede configurarse e integrar en la infraestructura de redes de su hotel. No obstante existen otros muchos servicios de este tipo y en ocasiones no podemos o no nos interesa prescindir de estos servicios, y aun así queremos que la información de estas conexiones quede registrada en Fideltour. Con este endpoint podemos enviar la información básica de dicha conexión y la información de sus contactos asociados para la automatización de campañas de email marketing.
  2. Plataformas de contenidos digitales: En las habitaciones de algunos hoteles existen unos servicios de contenido multimedia a los cuales los huéspedes pueden acceder registrándose en dichas plataformas. Gracias a la integración de estas plataformas con Fideltour podemos recuperar los datos de contacto de estos huéspedes y utilizarlos para la automatización de nuestras campañas.

Métodos disponibles

  1. POST: Inserción de una nueva entrada

Tabla de parámetros

Campo

Tipo

Obl.

Descripción

email

Cadena de caracteres

Si

Email del contacto, campo único, usado como identificador del contacto.

checkin

Date DD/MM/YYYY

Si

Fecha de entrada

checkout

Date DD/MM/YYYY

Si

Fecha de salida

hotel

Cadena de caracteres

Si

Código del hotel

contact_first_name

Cadena de caracteres

No

Nombre del contacto

contact_last_name

Cadena de caracteres

No

Apellido del contacto

contact_email

Cadena de caracteres

No

Email del contacto

contact_phone

Cadena de caracteres

No

Teléfono del contacto

room_number

Cadena de caracteres

No

Número de habitación


Se pueden mandar campos adicionales en el JSON que se manda a la petición. Todos los datos adicionales se guardarán bajo un atributo "data" en la base de datos.

Ejemplo

En el siguiente ejemplo se muestra una solicitud para insertar una nueva entrada del cliente mmir@customia.com.


Petición (POST)

POST: /api/3rd-party/entries/ HTTP/1.1

HOST:
 backend.fideltour.com
content-type: application/json
authorization: Token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
content-length: 203
{
"hotel": "YYY",
"email": "mmir@customia.com",
                  "checkin": "2020-07-09",
                  "checkout": "2020-07-10",
}

Respuesta (POST)

{
    "status": 1,
    "items_count": null,
    "extra": null,
    "page_count": null,
    "results": {
        "id": 296175,
        "checkin": "2020-07-09",
        "checkout": "2020-07-10",
        "hotel": "YYY",
        "contact_email": "mmir@customia.com",
        "contact_phone": null,
        "room_number": null,
  "data": "{\"checkin\": \"2020-07-09\", \"hotel\": \"YYY\", \"checkout\": \"2020-07-10\", \"email\": \"mmir@customia.com\", \"contact\": 1146286}",
        "hc": "XXXXXX",
        "contact": 119946286,
        "date": "2020-07-09",
        "input_channel": 5
    },
    "msg": "Created"
}

    • Related Articles

    • Gestión de reservas

      Introducción Este endpoint del Webservice permite la creación y actualización de reservas asociadas a contactos en Fideltour de forma externa. La URL de este Webservice es:  https://backend.fideltour.com/api/3rd-party/bookings/ Casos de uso Las ...
    • Programa de fidelización

      Introducción Este endpoint del Webservice permite, desde plataformas externas, realizar la consulta y gestión de los miembros del programa de fidelización, su membresía, sus puntos, productos y canjeos realizados. Para el uso de este endpoint es ...
    • Introducción

      Presentación Bienvenido a la documentación de la API pública de Fideltour, una API para la comunicación entre Fideltour y otras aplicaciones como motores de reservas, PMS, plataformas de gestión de contenidos, portales WiFi, etc. Esta guía se centra ...
    • Gestión de contactos

      Introducción Este endpoint del Webservice permite la creación y actualización de fichas de contacto en Fideltour de forma externa. La URL de este Webservice es: https://backend.fideltour.com/api/3rd-party/contacts/ Casos de uso El endpoint para la ...
    • Formularios de suscripción

      Introducción En el presente documento se describen los pasos a seguir para la implementación del formulario de suscripción de contactos de Fideltour en su página web. Es esencial el cumplimiento minucioso de las especificaciones que se describen para ...