Introducción:

Este artículo habla del endpoint web-form, que permite registrar un contacto en Fideltour desde cualquier formulario instalado en la web del cliente.

Endpoint: https://app.hoteldatahub.io/api/v1/contacts/web-form/

Swagger: https://app.hoteldatahub.io/swagger/#/contacts/contacts_web_form

Tabla de parámetros:

Ejemplo:

A continuación, se muestra un ejemplo de petición y respuesta correcta.

Petición POST:

En el siguiente ejemplo se muestra una petición para dar de alta al contacto pablo@hdh.com.

PROTOCOLO: HTTP/1.1

METODO: POST

HOST/ENDPOINT:  https://app.hoteldatahub.io/api/v1/contacts/web-form/

HEADERS: Content-type: application/json

BODY: se añade un ejemplo a continuación.

28. {
29.    "hotel_chain": "6NOK",
30.    "api_user": "hoteldatahub_fideltour_web_form",
31.    "email": "pablo@hdh.com",
32.    "birthday": "1976-04-18",
33.    "phone1": "651442233",
34.    "phone2": "12323",
35.    "gender": 2,
36.    "address": "Calle los olivos",
37.    "province": "Madrid",
38.    "town": "Madrid",
39.    "zone": "Sol",
40.    "post_code": "28013",
41.    "language": "es",
42.    "country": "ES",
43.    "name": "Pablo",
44.    "surname": "Mir",
45.    "identification_document_type": 1,
46.    "identification_number": "01234567Z",
47.    "source": 6,    
48.    "custom_tags":  ["Cliente VIP",  "Turista"],
49.    "accept_terms": true,
50.    "accept_commercial_communications": true,
51.    "accept_personalized_commercial_communications": false,
52.    "custom_fields": {"Campo personalizado 1": valor,  "Campo personalizado 2": valor}
53. }

Nota: los valores Booleanos true y false, también se pueden enviar como Integers 1 y 0.

Respuesta:

En caso de una respuesta 200 o 201, el json que se recibe tiene la siguiente estructura.

47. {
48.    "id": 9999999,
49.    "business_name": null,
50.    "work_place": "Madrid",
51.    "business_address": null,
52.    "fiscal_address": "Calle de las soluciones industriales 25",
53.    "language": "ES",
54.    "country": "ES",
55.    "created_at": "2022-01-01T12:12:12.654321",
56.    "level_name": "",
57.    "loyalty_card_number": null,
58.    "name": "Pablo",
59.    "surname": "Mir",
60.    "email": "pablo@hdh.com",
61.    "email_status": 0,
62.    "phone1": "651442233",
63.    "phone2": "12323",
64.    "gender": 2,
65.    "identification_document_type": 1,
66.    "identification_number": "01234567Z",
67.    "birthday": "1976-04-18",
68.    "address": "Calle los olivos",
69.    "post_code": "07006",
70.    "source": 1,
71.    "notes": "Muy exigente",
72.    "photo": null,
73.    "subscribed": false,
74.    "unsubscribe_reason": null,
75.    "date_subscribed": "2022-01-01T12:12:12.654321",
76.    "modification_date_subscribed": null,
77.    "is_active": true,
78.    "points": 0,
79.    "value": 0,
80.    "review": null,
81.    "total_bookings": 0,
82.    "level_points": 0,
83.    "loyalty_custom_tag_timestamp": null,
84.    "is_profile_completed": false,
85.    "last_level_review": null,
86.    "kicked_out_loyalty": null,
87.    "province": 1,
88.    "town": 2,
89.    "zone": 3,
90.    "level": null,
91.    "custom_tags": [4, 5],
92.    "hotels": []
93. }

Ejemplo real de formulario

A continuación, se muestra un ejemplo de uso de formulario sincronizado con Fideltour, en concreto un formulario de suscripción a newsletter. La información que se recoge del contacto en este ejemplo no es toda la posible. Para conocer toda la información posible del contacto que se puede enviar a Fideltour, leer este artículo. 

Formulario de suscripción a newsletter:

A continuación, se muestra el código HTML y Javascript necesario para generar un ejemplo de formulario de suscripción a newsletter integrado con Fideltour, además, posteriormente se adjunta el fichero html para poder ejecutarlo.

<form id="fideltour-newsletter-form" method="POST">

    <input type="hidden" name="hotel_chain" value="SOLICITAR A FIDELTOUR"> 

    <input type="hidden" name="api_user" value="SOLICITAR A FIDELTOUR">

    <div>

        <label for="name">Nombre</label>

        <input id="name" type="text" name="name">

    </div>

    <div>

        <label for="surname">Apellidos</label>

        <input id="surname" type="text" name="surname">

    </div>

    <div>

        <label for="email">Email</label>

        <input id="email" type="text" name="email" required>

    </div>

    <div>

        <input id="accept" type="checkbox" name="accept_commercial_communications" required>

        <label for="accept">

            Acepto suscribirme a la newsletter para recibir comunicaciones comerciales

        </label>

    </div>

    <button type="submit">Enviar</button>

</form>

<script type="text/javascript">

    const endpoint = "https://app.hoteldatahub.io/api/v1/contacts/web-form/";

    const form = document.getElementById("fideltour-newsletter-form");

    form.addEventListener("submit", function(e) {

        e.preventDefault();

        const xhr = new XMLHttpRequest();

        xhr.open("POST", endpoint, true);

        xhr.setRequestHeader("Content-type", "application/json");

        const formData = new FormData(form);

        const data = {};

        formData.forEach((value, key) => {

            if (value) {

                if (value === "on") value = true;

                data[key] = value;

            }

        });

        xhr.send(JSON.stringify(data));

        xhr.onreadystatechange = function() {

            if (xhr.readyState === 4 ) {

                if (xhr.status === 200) {

                    // La solicitud se completó exitosamente

                    console.log('Respuesta recibida:', xhr.responseText);

                } else {

                    // Hubo un problema con la solicitud

                    console.error('Error en la solicitud:', xhr.statusText);

                }

            }

        };

    });

</script>