Esto es lo que necesita saber:

  • En este artículo profundizamos y le mostramos cómo hacer personalizaciones que brinden resultados realmente impresionantes. Le proporcionamos el script que necesita para hacer cosas como cambiar el color de la superposición de su widget, preseleccionar un servicio o completar previamente los detalles del cliente.


Así es como está estructurado el artículo:

  1. Opciones de personalización para la superposición de un widget de reserva

    1.1 Atributos generales y relacionados con el diseño

    1.2 Atributos relacionados con el servicio

    1.3 Atributos relacionados con los recursos

    1.4 Atributos relacionados con la fecha

    1.5 Atributos relacionados con el cliente

    1.6 Atributos relacionados con la personalización

    1.7 Activar la reprogramación de una reserva específica

    1.8 Mostrar espacios de reserva ocultos de una reserva previa

    1.9 Seguimiento de conversiones de campañas de marketing

  2. Opciones de personalización para un iFrame de widget de reserva

    2.1 Parámetros generales y relacionados con el diseño

    2.2 Parámetros relacionados con el servicio
    2.3 Parámetros relacionados con los recursos

    2.4 Parámetros relacionados con la fecha

    2.5 Parámetros relacionados con el cliente

    2.6 Parámetros relacionados con las personalizaciones

    2.7 Activar la reprogramación de una reserva específica

    2.8 Mostrar espacios de reserva ocultos de una reserva previa

    2.9 Seguimiento de conversiones de campañas de marketing

  3. Opciones de personalización usando nuestra REST API



1. Opciones de personalización para la superposición de un widget de reserva

PASO 1:

En TIMIFY, vaya a IntegraciónWidget de ReservaBotón de reserva / Superposición y seleccione "Botón posición Flexible".

PASO 2:


La posición flexible no incluye el atributo "data-id", ya que su ID de reserva se encuentra dentro del elemento HTML que acaba de definir como su botón de reserva.

Como va a editar la apariencia y la posición del botón, el parámetro "data-position" debe tener el valor "flexible".

Pegue el código del fragmento justo antes de la etiqueta </head> o </body> de su plantilla.


PASO 3:


Ahora definamos el elemento HTML en su sitio web que permite que el navegador abra el widget. Por lo general, tiene uno de los siguientes elementos HTML:

Sin embargo, puede elegir cualquier otra etiqueta HTML para su botón. Tenga en cuenta siempre que debe:

  • agregue una clase "timify-button" para el elemento al que se refiere el fragmento

  • agregue el atributo "data-account-id=" con su ID de reserva TIMIFY dentro de ""

Atributos que puede agregar a su código para personalizar el widget y/o el flujo de trabajo de reserva

Use la siguiente lista de atributos (¡hemos agregado explicaciones útiles!) Para ajustar su widget, de modo que pueda hacer que se vea exactamente como lo desea. Los atributos se pueden integrar en botones existentes de la siguiente manera.

Supongamos que le gustaría preseleccionar un servicio cuando se hace clic en un determinado botón de reserva en su página. En este caso, tendría que poner el atributo data-service-id="5f6cbdb98e434611ef5bbf73" en su elemento de botón:

<div class="timify-button" data-account-id="5f6cbd042e148e11ac2acaad" data-service-id="5f6cbdb98e434611ef5bbf73">Book a massage</div>

Si desea preseleccionar un servicio globalmente para todos sus botones a través de su código JavaScript, simplemente agregue el atributo al fragmento TIMIFY JS:

<script async
src="//book.timify.com/widget/widget.min.js"
id="timify-widget"
data-position="flexible"
data-account-id="5f6cbd042e148e11ac2acaad"
data-service-id="5f6cbdb98e434611ef5bbf73">
</script>

A continuación, se muestra una lista con todos los atributos admitidos para la integración del widget de reserva TIMIFY como superposición:

1.1 Atributos generales y relacionados con el diseño

Attributes

Description

Example

data-account-id

Use esto para cargar su cuenta o una rama específica al widget.

data-account-id="5f6cbd042e148e11ac2acaad"

data-is-external-id
O
data-company-external-id

Use esto para cargar una rama específica desde su Gerente de Sucursal al widget usando una identificación externa predefinida.
Nota: funciona solo en combinación con el atributodata-enterprise-id .

data-is-external-id="branch07"

data-enterprise-id

Use esto para cargar el buscador de ubicación como primer paso de su widget. Funciona solo si tiene una cuenta de TIMIFY Branch Manager con más de una ubicación.

Nota: Si desea cargar el buscador de ubicación, no debe incluir el atributo data-account-id

data-enterprise-id="5c79487bed89503cfac758b3"

data-hide-close-button

Use esto para ocultar el botón de cierre del widget. Este es un 'boolean'. El valor solo puede ser true o false.

data-hide-close-button="true"

O

data-hide-close-button="false"

data-fullscreen

Use esto para abrir el widget en modo de pantalla completa. Este es un 'booleano'. El valor solo puede ser true o false.

data-fullscreen="true"

O

data-fullscreen="false"

data-overlay-color

Use esto para cambiar el color de fondo de la superposición que cubre su sitio web cuando se activa el widget (el color de fondo detrás del widget).

Nota: Utilice siempre códigos de color HEX. Si no conoce su código HEX, puede generar uno desde aquí.

data-overlay-color="#F09368"

data-overlay-opacity

Use esto para cambiar la opacidad del color de fondo de la superposición.

data-overlay-opacity="0.2"

data-locale

Use esto para preseleccionar un idioma específico para el widget de reserva.

Códigos de idioma disponibles:
Alemán: de-de
Inglés:en-gb

Francés: fr-fr

Italiano: it-it

Español: es-es
catalán:ca-es

Holandés: nl-nl

Danés: da-dk
Noruego: nn-no
Finlandés: fi-fi
Sueco:sv-se

Búlgaro: bg-bg
Polaco: pl-pl
Estonio: et-ee
Cymraeg (escocés):cy-gb

data-locale="fr-fr"

data-position

Utilice esto para permitir que se coloquen varios botones en la misma página.

data-position="multiple"

data-custom-button-image

Use esto para reemplazar el botón TIMIFY estándar que aparece en el lado derecho o izquierdo de su sitio web con un gráfico de botón individual de su elección.

Nota: El gráfico debe cargarse en un servidor FTP y la URL debe agregarse como un valor a este atributo.

data-custom-button-image="https://www.yourwebsite.com/images/button.jpg"

data-button-attribute

Use this to allow the attribute data-account-id to be re-named. For example you can replace data-account-id=“your-TIMIFY-Company-ID" with timify-id="your-TIMIFY-Company-ID”

data-button-attribute="data-account-id"

data-show-company-name-in-header

Use esto si tiene varias cuentas / ubicaciones a través del Administrador de sucursales de TIMIFY para mostrar el nombre de la ubicación seleccionada en el Buscador de ubicaciones. Este es un booleano.

data-show-company-name-in-header=“true”

1.2 Atributos relacionados con el servicio

Atributos

Descripción

Ejemplo

data-show-services

Use esto para mostrar solo una cantidad de servicios predefinidos en el primer paso del widget de reserva.
Asegúrese de utilizar el ID del servicio respectivo; puede encontrarlo en la página de detalles del servicio. Puede usar múltiples ID de servicio, solo asegúrese de separarlos con comas.

data-show-services="5f6cbdb98e434611ef5bbf73"

O

data-show-services="5f6cbdb98e434611ef5bbf73,5f6cc872471ac511d7e7afe4"

data-show-services-external-ids

Este atributo cumple la misma función que data-show-services, pero utilizando el Id externo de los servicios en su lugar.

data-show-services-external-ids="service01,service03"

data-hide-services

Use esto para ocultar algunos servicios predefinidos en el primer paso del widget de reserva. Asegúrese de utilizar el ID del servicio respectivo; puede encontrarlo en la página de detalles del servicio. Puede utilizar varios ID de servicio, solo asegúrese de separarlos con comas.

data-hide-services="5f6cbdb98e434611ef5bbf73"

OR

data-hide-services="5f6cbdb98e434611ef5bbf73,5f6cc872471ac511d7e7afe4"

data-hide-services-external-ids

Este atributo cumple la misma función que data-hide-services, pero utilizando el Id externo de los servicios en su lugar.

data-hide-services-external-ids="service01,service03"

data-service-id

Use esto para preseleccionar un servicio de su elección y omitir el primer paso del widget usando el ID del servicio en TIMIFY

data-service-id="5f6cbdb98e434611ef5bbf73"

data-service-external-ids

Use esto para preseleccionar un servicio de su elección y omitir el primer paso del widget usando el ID externo que ha definido para él.

data-service-external-ids="service03"

data-course-id

Use esto para preseleccionar un servicio grupal de su elección y omitir el primer paso del widget usando el ID del grupo.

data-course-id="5f6d9ceeda9f6046487ed20b"

1.3 Atributos relacionados con los recursos

Atributos

Descripción

Ejemplo

data-resource-id

Use esto para preseleccionar automáticamente un recurso de su elección usando su ID.
Nota: Si usa esto en combinación con el atributo, data-service-id asegúrese de que el recurso preseleccionado esté realmente asignado a ese servicio.

data-resource-id="5f6ebc35533f6711c4c2e545"

data-resource-externalids

Use esto para preseleccionar automáticamente un recurso de su elección usando el ID externo que ha definido para él.
Nota: Si usa esto en combinación con el atributo, data-service-id asegúrese de que el recurso preseleccionado esté realmente asignado a ese servicio.

data-resource-externalids="room1"

data-filter-resources

Use esto para filtrar los recursos en el widget de reserva y solo mostrar los recursos seleccionados usando sus ID de TIMIFY.

data-filter-resources="5f72f486cfaace11d20d64bd,5f6cbe07d07c8611aae6b1dd"

data-filter-resources-by-external-id

Use esto para filtrar los recursos en el widget de reserva y solo mostrar los recursos seleccionados usando la ID externa que ha definido para ellos.

data-filter-resources-by-external-id="room01,room03"

data-show-selected-resource-only

Utilice esto para mostrar solo el recurso preseleccionado en la descripción general del recurso. Este es un booleano.

Nota: funciona solo en combinación con data-resource-id y data-resource-externalids

data-show-selected-resource-only="true"

data-show-resources

Use esto para sobrescribir la configuración del widget que oculta los recursos de forma predeterminada. Para que esto funcione, primero debe ir a ConfiguraciónReservas → Widget de reservas y desde allí activar el cuadro de interruptores en la sección Visualización de recursos. Esto conducirá a ocultar sus recursos de forma predeterminada a todos los clientes que vean su widget. Cuando utiliza este atributo, puede sobrescribir esta configuración y mostrar el componente de selección de recursos en algunos casos a sus clientes.
Este es un booleano.

data-show-resources="true"

1.4 Atributos relacionados con la fecha

Atributos

Descripción

Ejemplo

data-date

Use esto para pre-llenar y mostrar automáticamente los espacios libres en una fecha específica.
Nota: el formato de fecha es AAAA-MM-DD

data-date="2021-05-17"

data-date-range

Use esto para filtrar un período predefinido para la selección de fecha y mostrar SÓLO los espacios disponibles dentro de este período.
Nota: El formato de fecha es AAAA-MM-DD: AAAA-MM-DD.

data-date-range="2021-05-17:2021-05-23"

data-disable-other-dates

Use esto para impedir que el usuario seleccione cualquier otra fecha que no sea la precargada. Este es un booleano.

data-disable-other-dates="true"

1.5 Atributos relacionados con el cliente

Atributos

Descripción

Ejemplo

data-show-guest-booking-form

Úselo para mostrar solo la reserva del Invitado como método de autenticación para sus clientes. Este es un booleano.

data-show-guest-booking-form="true"

data-skip-customerfields-section

Use esto para omitir mostrar el formulario de reserva de Invitado y mostrar directamente la vista de confirmación de reserva.
Nota: Esto solo funciona si ha completado previamente todos los campos de datos necesarios en el formulario utilizando los parámetros a continuación. Si alguno de los campos de datos no está pre completado (incluso si no es obligatorio), se mostrará el formulario de reserva y se le pedirá al cliente antes que complete la información.

data-skip-customerfields-section="true"

data-hide-filled-fields

Utilice esta opción para ocultar los campos de datos pre-rellenados en el resumen de la reserva.

Nota: Esto funciona para todos los campos de datos excepto para los campos de datos de casillas de verificación.

data-hide-filled-fields="true"

data-external-customer-id

Use esto para preseleccionar un cliente ya existente en TIMIFY proporcionando su ID externo.

data-external-customer-id="CONT-19991882-CRM2"

data-guest-firstname

Utilice esta opción para rellenar automáticamente el nombre de la persona que realizó la reserva en el formulario de invitado.

data-guest-firstname="Max"

data-guest-lastname

Use esto para pre-completar el apellido del reserva automáticamente en el formulario de invitado.

data-guest-lastname="Smith"

data-guest-email

Use esto para completar automáticamente el correo electrónico de la persona que realizó la reserva en el formulario de invitado.

data-guest-email="maxsmithdemotest@gmail.com"

data-guest-phone

Úselo para completar automáticamente el número de teléfono del reservante en el formulario de invitado.
Nota: No incluya 0, + o espacios vacíos, solo el número sin el código de país. Si tiene un código de operador local / móvil, por ejemplo, 0179 77 88 99, el valor debería verse así 179778899

data-guest-phone="1786655322"

data-guest-phonecountry

Úselo para completar automáticamente el código de país del teléfono de la persona que realizó la reserva en el formulario de invitado.

Estos son los valores del código alfa-2 ISO 3166-1 permitidos actualmente:

'fi', 'ae', 'ar', 'at', 'au', 'be', 'bn', 'br', ' bg ',' ca ',' us ',' ch ',' cn ',' cz ',' de ',' dk ',' eg ',' es ',' ee ',' fr ',' gb ' , 'gr', 'hk', 'hr', 'hu', 'id', 'ie', 'in', 'il', 'it', 'jp', 'kr', 'lu', ' mo ',' mt ',' mx ',' my ',' nl ',' no ',' ph ',' pl ',' pt ',' ro ',' ru ',' sa ',' sg ' , 'sk', 'se', 'th', 'tr', 'tw', 'co', 'cl'

Puede encontrar más información sobre los valores de código de país ISO 3166-1 aquí.

data-guest-phonecountry="de"

data-customer-field-1
data-customer-field-2
data-customer-field-N

Use esto para completar previamente cualquier campo de datos personalizado que haya habilitado en el formulario de reserva.

El formato es data-customer-field-1="<ID>-<VALUE>" donde <ID> es el id de su campo de datos en TIMIFY y <VALUE> es el valor precargado para ese campo. Supongamos que tiene un campo de identificación de miembro VIP y desea completarlo previamente. En este caso, el código se verá así:

data-customer-field-1="5f6cbe62587de011ff6c68f7-MemberID9998881"

Si tiene varios campos de datos personalizados que desea completar previamente, es importante que asigne a cada uno de ellos un nombre de atributo único. Entonces, en el ejemplo anterior, si ahora quiero rellenar previamente otro campo, donde le pregunto a mi reserva qué comida prefieren, ya que ya usamos el nombre del atributo data-customer-field-1 ,simplemente tendremos que reemplazar el número al final por data-customer-field-2.

Si utiliza como campo de datos, escriba una casilla de verificación, el valor debe reemplazarse simplemente por true.

data-customer-field-1="5f6cbe62587de011ff6c68f7-MemberID9998881"

data-customer-field-2="5f6cbd052e148e11ac2acac1-vegetarian"

data-customer-field-3="5f6cbd052e148e11ac2acab9-true"

1.6 Atributos relacionados con la personalización

Atributos

Descripción

Ejemplo

data-customisation-id

Úselo para sobrescribir la empresa predeterminada o la personalización del widget empresarial. Por ejemplo, puede activar una personalización de widget especial cuando se completa previamente un servicio o recurso específico.

data-customisation-id="5dd6a2fcfefe8710f1d45ba6"

data-template-customisation-id

Utilice esta opción para sobreescribir la personalización predeterminada de la plantilla de correo electrónico empresarial o de la empresa. Por ejemplo, puede activar una personalización especial de la plantilla de correo electrónico cuando un servicio específico está precargado o está activando el widget desde un medio diferente; digamos que tiene un widget personalizado para su sitio web y otro diferente para su aplicación móvil.

data-template-customisation-id="5de4f70480e1ae10f731a56c"

1.7 Activar la reprogramación de una reserva específica

Si está utilizando TIMIFY REST API y digamos que desea mostrar todas las citas reservadas que tendrán lugar en el futuro en la sección del cliente de su aplicación o sitio web para que sus clientes puedan reprogramar fácilmente una reserva en particular desde allí. Puede activar un proceso de reprogramación para una reserva específica proporcionando tanto el data-event-id y el data-secret de la reserva. Por lo general, los obtendría si se suscribió para recibir un webhook con el alcance EVENT-CREATED. El secreto para la cancelación o reprogramación solo se puede obtener a través de un webhook y se puede encontrar en el archivo metadata.

Atributos

Descripción

Ejemplo

data-event-id

Este es el id de la reserva en TIMIFY.

data-event-id="5f748b0296782111e4eed9e9"

data-secret

Este es el secreto de la reserva en TIMIFY.

data-secret="5e1c4da96456f911e04bc18c-xx991882owks00921ms0923109381872m8dn3872nmds983kksiahdhd"

1.8 Mostrar espacios de reserva ocultos de una reserva previa


En TIMIFY, actualmente disponible solo a través de la aplicación Booking Links, puede reservar con anticipación un espacio específico o un rango de espacios dentro de un rango de fechas y hacer que estén disponibles solo para los clientes que tienen un acceso especial a su widget que los revela por analizar una clave secreta de esa reserva previa. Con el data-pre-reservation-key, puede analizar este secreto en el widget y revelar las ranuras ocultas. Supongamos que desea que el lunes 25 de octubre de 2021 entre las 15:00 y las 17:00 esté disponible SOLO para algunos de sus clientes seleccionados. Puedes crear una pre-reserva para ese día y rango de tiempo y la bloquearás para todos tus clientes habituales. Luego, al analizar la clave secreta de la pre-reserva en su widget de reserva, puede hacer que esta fecha y franjas horarias sean visibles solo para los pocos clientes seleccionados.

Atributos

Descripción

Ejemplo

data-pre-reservation-key

La clave secreta para la pre-reserva.

data-pre-reservation-key="882owks00921ms0923109381872m8dn3872nmds983kksi"

1.9 Seguimiento de conversiones de campañas de marketing

Si desea rastrear de qué fuente, medio o campaña proviene una reserva, puede hacerlo analizando sus parámetros UTM en el widget de reserva. Los datos se mostrarán en las Estadísticas de reserva de su cuenta o si utiliza nuestra herramienta Branch Manager en el Panel de estadísticas. Aquí hay una lista con los atributos admitidos actualmente:

Atributos

Descripción

Ejemplo

data-meta-utmcontent

Utilice este atributo para analizar y guardar el contenido UTM con la reserva. Suele ser un campo opcional. Si tiene varios enlaces en la misma campaña, como dos enlaces en el mismo correo electrónico, puede completar este valor para poder diferenciarlos.

data-meta-utmcontent="HeaderLink"

data-meta-utmsource

Utilice este atributo para analizar y guardar la fuente UTM con la reserva. Este suele ser un parámetro obligatorio y se utiliza para identificar qué sitio envió el tráfico y realizó la conversión.

data-meta-utmsource="Google"

data-meta-utmmedium

Utilice este atributo para analizar y guardar el medio UTM con la reserva. Suele utilizarse para identificar qué tipo de enlace se utilizó, como el coste por clic o el correo electrónico.

data-meta-utmmedium="cpc"

data-meta-utmcampaign

Utilice este atributo para analizar y guardar la campaña UTM con la reserva. Suele utilizarse para identificar una promoción de producto específica o una campaña estratégica.

data-meta-utmcampaign="spring_promotion"

data-meta-utmterm

Utilice este atributo para analizar y guardar el término de búsqueda UTM con la reserva. Suele utilizarse para identificar el término de búsqueda en Google Ads.

data-meta-utmterm="contact lenses+consultation"

-------------------------------------------------- -------------------------------------------------- -----------------------

2. Opciones de personalización para un iFrame de widget de reserva

Para ver un ejemplo en vivo de cómo un usuario ha personalizado su widget iFrame, haga clic aquí

El fragmento de código del iFrame debería verse así:

<iframe src="https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&hideCloseButton=true" style="border:0px #ffffff none;" name="myTimifyWidget" scrolling="no" frameborder="0" marginheight="0px" marginwidth="0px" height="800px" width="700px" allowfullscreen></iframe>


Copie y pegue este código en el HTML de la página donde desea que aparezca el widget en su página. No olvide ajustar la URL en el atributo "src" de acuerdo con su cuenta utilizando la persona accountId para su cuenta TIMIFY. También puede cambiar la altura y el ancho del iFrame cambiando los valores de los parámetros ("alto" o "ancho") en el código anterior.

Con los siguientes parámetros puedes realizar más personalizaciones en tu widget y adaptar el proceso de reserva perfectamente a tus necesidades.

Un parámetro siempre se agrega con un " &" a la URL del widget existente. Digamos que le gustaría ocultar el botón de cierre del widget cuando un cliente suyo abre el enlace del widget. En este caso, debe agregar el parámetro &hideCloseButton=true. Así es como se vería su enlace:

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&hideCloseButton=true

2.1 Parámetros generales y relacionados con el diseño

Parámetros

Descripción

Ejemplo

accountId

Use esto para cargar su cuenta o una rama específica al widget.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad

companyExternalId

OR

iscompanyExternalId (deprecated)

Use esto para cargar una rama específica desde su cuenta de Branch Manager al widget usando una identificación externa predefinida.
Nota: Debe estar siempre en combinación con el parámetro 'enterpriseId'.

https://book.timify.com/services?enterpriseId=5c79487bed89503cfac758b3&companyExternalId=branch07

enterpriseId

Use esto para cargar el buscador de ubicación como primer paso de su widget. Funciona solo si tiene una cuenta de TIMIFY Branch Manager con más de una ubicación.

Nota: Si desea cargar el buscador de ubicación, no debe incluir el atributo data-account-id

https://book.timify.com/locations?enterpriseId=5c79487bed89503cfac758b3

showLocations

Utilícelo para cargar ubicaciones específicas en la búsqueda de ubicaciones del widget.

https://book.timify.com/locations?enterpriseId=5c79487bed89503cfac758b3&showLocations=62e7ea9e9756ea5f1dca6176,62e7eb09dd179083b9030a30

hideCloseButton

Use esto para ocultar el botón de cierre del widget. Este es un 'booleano'. El valor solo puede ser verdadero o falso.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&hideCloseButton=true

fullscreen

Use esto para abrir el widget en modo de pantalla completa. Este es un 'booleano'. El valor solo puede ser verdadero o falso.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&fullscreen=true

overlayColor

Use esto para cambiar el color de fondo detrás del widget.

Nota: Utilice siempre códigos de color HEX. Si no conoce su código HEX, puede generar uno desde aquí.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&overlayColor=#F09368

overlayOpacity

Use esto para cambiar la opacidad del color de fondo detrás del widget.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&overlayColor=#F09368&overlayOpacity=0.2

locale

Use esto para preseleccionar un idioma específico para el widget de reserva.

Códigos de idioma disponibles:
Alemán: de-de
Inglés: en-gb

Francés: fr-fr

Italiano: it-it

Español: es-es
catalán: ca-es

Holandés: nl-nl

Danés: da-dk
Noruego: nn-no
Finlandés: fi-fi
Sueco: sv-se

Búlgaro: bg-bg
Polaco: pl-pl
Estonio: et-ee
Cymraeg (escocés): cy-gb

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&locale=da-dk

showCompanyNameInHeader

Use esto si tiene varias cuentas / ubicaciones a través del Administrador de sucursales de TIMIFY para mostrar el nombre de la ubicación seleccionada en el Buscador de ubicaciones. Este es un booleano.

https://book.timify.com/locations?enterpriseId=5c79487bed89503cfac758b3&showCompanyNameInHeader=true

2.2 Parámetros relacionados con el servicio

Parámetros

Descripción

Ejemplo

showServices

Use esto para mostrar solo una cantidad de servicios predefinidos en el primer paso del widget de reserva.
Asegúrese de utilizar el ID del servicio respectivo; puede encontrarlo en la página de detalles del servicio. Puede usar múltiples ID de servicio, solo asegúrese de separarlos con comas.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&showServices=5f6cbdb98e434611ef5bbf73

O

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&showServices=5f6cbdb98e434611ef5bbf73,5f6cc872471ac511d7e7afe4

showServicesExternalIds

Este atributo cumple la misma función que showServices, pero utilizando el Id externo de los servicios en su lugar.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&overlayColor=#F09368&overlayOpacity=0.2&showServicesExternalIds=service01,service03

hideServices

Use esto para ocultar algunos servicios predefinidos en el primer paso del widget de reserva. Asegúrese de utilizar el ID del servicio respectivo; puede encontrarlo en la página de detalles del servicio. Puede utilizar varios ID de servicio, solo asegúrese de separarlos con comas.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&hideServices=5f6d9ceeda9f6046487ed20b

O

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&hideServices=5f6d9ceeda9f6046487ed20b,5f6cbdb98e434611ef5bbf73

hideServicesExternalIds

Este atributo cumple la misma función que hideServices, pero utilizando el Id externo de los servicios en su lugar.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&overlayColor=#F09368&overlayOpacity=0.2&hideServicesExternalIds=service01,service03

serviceId

Use esto para preseleccionar un servicio de su elección y omitir el primer paso del widget.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&serviceId=5f6cbdb98e434611ef5bbf73

serviceExternalIds

Use esto para preseleccionar un servicio de su elección y omitir el primer paso del widget usando el ID externo que ha definido para él.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&serviceExternalIds=service03

courseId

Use esto para preseleccionar un servicio grupal de su elección y omitir el primer paso del widget usando el ID del grupo.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&courseId=5f6d9ceeda9f6046487ed20b

2.3 Parámetros relacionados con los recursos

Parameters

Description

Example

resourceId

Use esto para preseleccionar automáticamente un recurso de su elección.
Nota: Si usa esto en combinación con el atributo, data-service-id asegúrese de que el recurso preseleccionado esté realmente asignado a ese servicio.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&resourceId=5f6ebc35533f6711c4c2e545

resourceExternalIds

Use esto para preseleccionar automáticamente un recurso de su elección usando el ID externo que ha definido para él.
Nota: Si usa esto en combinación con el atributo, data-service-id asegúrese de que el recurso preseleccionado esté realmente asignado a ese servicio.

https://book.timify.com/conflict?accountId=5f6cbd042e148e11ac2acaad&resourceExternalIds=room02

filterResources

Use esto para filtrar los recursos en el widget de reserva y solo mostrar los recursos seleccionados usando sus ID de TIMIFY.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&filterResources=5f72f486cfaace11d20d64bd,5f6cbe07d07c8611aae6b1dd

filterResourcesbyExternalId

Use esto para filtrar los recursos en el widget de reserva y solo mostrar los recursos seleccionados usando la ID externa que ha definido para ellos.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&filterResourcesbyExternalId=room01,room03

showSelectedResourcesOnly

Utilice esto para mostrar solo el recurso preseleccionado en la descripción general del recurso. Este es un booleano.

Nota: funciona solo en combinación con data-resource-id y data-resource-externalids.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&showSelectedResourcesOnly=true&resourceId=5f6ebc35533f6711c4c2e545

showResources

Use esto para sobrescribir la configuración del widget que oculta los recursos de forma predeterminada. Para que esto funcione, primero debe ir a Configuración> Reservas> Widget de reservas y desde allí activar el cuadro de interruptores en la sección Visualización de recursos. Esto conducirá a ocultar sus recursos de forma predeterminada a todos los clientes que vean su widget. Cuando utiliza este atributo, puede sobrescribir esta configuración y mostrar el componente de selección de recursos en algunos casos a sus clientes.
Este es un booleano.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&showResources=true

2.4 Parámetros relacionados con la fecha

Parámetros

Descripción

Ejemplo

date

Use esto para pre-llenar y mostrar automáticamente los espacios libres en una fecha específica.
Nota: el formato de fecha es AAAA-MM-DD

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&date=2021-08-17

dateRange

Use esto para filtrar un período predefinido para la selección de fecha y mostrar SÓLO los espacios disponibles dentro de este período.
Nota: El formato de fecha es AAAA-MM-DD: AAAA-MM-DD.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&dateRange=2021-08-05:2021-08-09

disableOtherDates

Use esto para impedir que el usuario seleccione cualquier otra fecha que no sea la precargada. Este es un booleano.

https://book.timify.com/auth?accountId=5f6cbd042e148e11ac2acaad&date=2021-08-17&disableOtherDates=true

2.5 Parámetros relacionados con el cliente

Parámetros

Descripción

Ejemplo

showGuestBookingForm

Úselo para mostrar solo la reserva del invitado como método de autenticación para sus reservantes. Este es un booleano.

https://book.timify.com/customer-fields?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true

skipCustomerFieldsSection

Use esto para omitir mostrar el formulario de reserva de invitado y mostrar directamente la vista de confirmación de reserva.
Nota: Esto solo funciona si ha completado previamente todos los campos de datos necesarios en el formulario usando los parámetros a continuación y usa el parámetro showGuestBookingForm. Si alguno de los campos de datos no está pre-llenado (incluso si no es obligatorio), se mostrará el formulario de reserva y se le pedirá al reservante que complete la información.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestFirstName=Max&guestLastName=Smith&guestEmail=maxsmithdemo@gmail.com&guestPhone=1765544321&guestPhoneCountry=de&customerField[5f6cbe62587de011ff6c68f7]=MemberID999888777&skipCustomerFieldsSection=true

hideFilledFields

Utilice esta opción para ocultar los campos de datos pre-rellenados en el resumen de la reserva.

Nota: Esto funciona para todos los campos de datos excepto para los campos de datos de casillas de verificación.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&guestFirstName=Max&=hideFilledFields

externalCustomerId

Use esto para preseleccionar un cliente ya existente en TIMIFY proporcionando su ID externo.

https://book.timify.com/success?accountId=5f6cbd042e148e11ac2acaad&externalCustomerId=customer-123

hideExternalCustomerFields

Puede utilizar este parámetro para ocultar campos de datos de su formulario de reserva.

Formato:

hideExternalCustomerFields=idExterno1,idExterno2,...

Puede utilizar la separación por comas para listar todos los IDs de campos de datos externos que desea ocultar.

Los campos de datos activados como obligatorios en el formulario de reserva no se ocultarán.

https://book.timify.com/accountId=5f6cbd042e148e11ac2acaad&hideExternalCustomerFields=memberid&externalCustomerField[memberid]=MemberID999888777&skipCustomerFieldsSection=true

guestFirstName

Utilice esta opción para rellenar automáticamente el nombre de la persona que realizó la reserva en el formulario de invitado.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestFirstName=Max

guestLastName

Use esto para pre-completar el apellido del reserva automáticamente en el formulario de invitado.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestLastName=Smith

guestEmail

Use esto para completar automáticamente el correo electrónico de la persona que realizó la reserva en el formulario de invitado.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestEmail=maxsmithdemo@gmail.com

guestPhone

Úselo para completar automáticamente el número de teléfono del reservante en el formulario de invitado.
Nota: No incluya 0 o + o espacios vacíos, solo el número sin el código de país. Si tiene un código de operador local / móvil, por ejemplo, 0179 77 88 99, el valor debería verse así 179778899

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestPhone=1765544321&guestPhoneCountry=de

guestPhoneCountry

Úselo para completar automáticamente el código de país del teléfono de la persona que realizó la reserva en el formulario de invitado.

Estos son los valores del código alfa-2 ISO 3166-1 permitidos actualmente:

'fi', 'ae', 'ar', 'at', 'au', 'be', 'bn', 'br', ' bg ',' ca ',' us ',' ch ',' cn ',' cz ',' de ',' dk ',' eg ',' es ',' ee ',' fr ',' gb ' , 'gr', 'hk', 'hr', 'hu', 'id', 'ie', 'in', 'il', 'it', 'jp', 'kr', 'lu', ' mo ',' mt ',' mx ',' my ',' nl ',' no ',' ph ',' pl ',' pt ',' ro ',' ru ',' sa ',' sg ' , 'sk', 'se', 'th', 'tr', 'tw', 'co', 'cl'

Puede encontrar más información sobre los valores de código de país ISO 3166-1 aquí.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&guestPhone=1765544321&guestPhoneCountry=de

customerField[ID]

Use esto para completar previamente cualquier campo de datos personalizado que haya habilitado en el formulario de reserva.

El formato es customerField[ID]=VALUE donde <ID> es el id de su campo de datos en TIMIFY y el VALUE es el valor pre llenado para ese campo. Supongamos que tiene un campo de identificación de miembro VIP y desea completarlo previamente. En este caso, el código se verá así:

customerField[5f6cbe62587de011ff6c68f7]=MemberID999888777

Si usa como campo de datos, escriba una casilla de verificación, el valor debe reemplazarse simplemente con true.

https://book.timify.com/confirm?accountId=5f6cbd042e148e11ac2acaad&showGuestBookingForm=true&customerField[5f6cbe62587de011ff6c68f7]=MemberID999888777&skipCustomerFieldsSection=true

hideCustomerFields

Puede utilizar este parámetro para ocultar campos de datos de su formulario de reserva.

Formato:

hideCustomerFields=ID1,ID2,...

Puede utilizar la separación por comas para listar todos los IDs de los campos de datos que desea ocultar.

Los campos de datos activados como obligatorios en el formulario de reserva no se ocultarán.

https://book.timify.com/accountId=5f6cbd042e148e11ac2acaad&hidelCustomerFields=5f6cbe62587de011ff6c68f7&customerField[5f6cbe62587de011ff6c68f7]=MemberID999888777&skipCustomerFieldsSection=true

2.6 Parámetros relacionados con las personalizaciones

Parámetros

Descripción

Ejemplo

customisationId

Úselo para sobrescribir la empresa predeterminada o la personalización del widget empresarial. Por ejemplo, puede activar una personalización de widget especial cuando se completa previamente un servicio o recurso específico.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&customisationId=5dd3b016a5c46410e5568fac

templatesCustomisationId

Utilice esta opción para sobrescribir la personalización predeterminada de la plantilla de correo electrónico empresarial o de la empresa. Por ejemplo, puede activar una personalización especial de la plantilla de correo electrónico cuando un servicio específico está pre cargado o está activando el widget desde un medio diferente; digamos que tiene un widget personalizado para su sitio web y otro diferente para su aplicación móvil.

https://book.timify.com/success?accountId=5f6cbd042e148e11ac2acaad&templatesCustomisationId=5de4f70480e1ae10f731a56c

2.7 Activar la reprogramación de una reserva específica

Si está utilizando TIMIFY REST API y digamos que desea mostrar todas las citas reservadas que tendrán lugar en el futuro en la sección del cliente de su aplicación o sitio web para que sus clientes puedan reprogramar fácilmente una reserva en particular desde allí. Puede activar un proceso de reprogramación para una reserva específica proporcionando tanto el eventId y el secret de la reserva. Por lo general, los obtendría si se suscribió para recibir un webhook con el alcance EVENT-CREATED. El secreto para la cancelación o reprogramación solo se puede obtener a través de un webhook y se puede encontrar en el archivo metadata.

Parámetros

Descripción

Ejemplo

eventId

Este es el id de la reserva en TIMIFY. Este parámetro solo funciona en combinación con secret.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&eventId=5f75e3295b3aa811f85822e9&secret=3fcd6975-3620-4874-a314-e07d7dd4dd71

secreto

Este es el secreto de la reserva en TIMIFY. Este parámetro solo funciona en combinación con eventId.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&eventId=5f75e3295b3aa811f85822e9&secret=3fcd6975-3620-4874-a314-e07d7dd4dd71

2.8 Mostrar espacios de reserva ocultos de una reserva previa

En TIMIFY, actualmente disponible solo a través de la aplicación Booking Links, puede reservar con anticipación un espacio específico o un rango de espacios dentro de un rango de fechas y hacer que estén disponibles solo para los clientes que tienen un acceso especial a su widget que los revela por analizar una clave secreta de esa reserva previa. Con el preReservationKey, puede analizar este secreto en el widget y revelar las ranuras ocultas. Supongamos que desea que el lunes 25 de octubre de 2021 entre las 15:00 y las 17:00 esté disponible SOLO para algunos de sus clientes seleccionados. Puedes crear una pre-reserva para ese día y rango de tiempo y la bloquearás para todos tus clientes habituales. Luego, al analizar la clave secreta de la pre-reserva en su widget de reserva, puede hacer que esta fecha y franjas horarias sean visibles solo para los pocos clientes seleccionados.

2.9 Seguimiento de conversiones de campañas de marketing

Si desea rastrear de qué fuente, medio o campaña proviene una reserva, puede hacerlo analizando sus parámetros UTM en el widget de reserva. Los datos se mostrarán en las Estadísticas de reserva de su cuenta o si utiliza nuestra herramienta Branch Manager en el Panel de estadísticas. Aquí hay una lista con los atributos admitidos actualmente:

Parámetros

Descripción

Ejemplo

meta[utmcontent]

Utilice este atributo para analizar y guardar el contenido UTM con la reserva. Suele ser un campo opcional. Si tiene varios enlaces en la misma campaña, como dos enlaces en el mismo correo electrónico, puede completar este valor para poder diferenciarlos.

https://book.timify.com/availability?accountId=5f6cbd042e148e11ac2acaad&meta[utmcontent]=HeaderLink

meta[utmsource]

Utilice este atributo para analizar y guardar la fuente UTM con la reserva. Este suele ser un parámetro obligatorio y se utiliza para identificar qué sitio envió el tráfico y realizó la conversión.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&meta[utmsource]=Google

meta[utmmedium]

Utilice este atributo para analizar y guardar el medio UTM con la reserva. Suele utilizarse para identificar qué tipo de enlace se utilizó, como el coste por clic o el correo electrónico.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&meta[utmmedium]=cpc

meta[utmcampaign]

Utilice este atributo para analizar y guardar la campaña UTM con la reserva. Suele utilizarse para identificar una promoción de producto específica o una campaña estratégica.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&meta[utmcampaign]=spring-promotion

meta [utmTerm]

Utilice este atributo para analizar y guardar el término de búsqueda UTM con la reserva. Suele utilizarse para identificar el término de búsqueda en Google Ads.

https://book.timify.com/services?accountId=5f6cbd042e148e11ac2acaad&meta[utmterm]=contactlenses+consultation

-------------------------------------------------- -------------------------------------------------- -----------------------


3. Opciones de personalización usando nuestra REST API

Si desea tener una experiencia de reserva en línea que incorpore su marca corporativa y flujos de trabajo de reserva específicos, esto es para usted. Profundizamos en su infraestructura de TI existente, desglosamos nuestro widget y lo reconstruimos para que se convierta en una extensión perfecta de su API e interfaz. Tenemos en cuenta las necesidades y preferencias de sus clientes, para qué la reserva en línea se convierta en una parte integral de su experiencia omnicanal.

Esta opción implica acceder a nuestra plataforma para desarrolladores y un poco de capacitación con un especialista técnico dedicado. Para obtener más información, comuníquese con nuestro servicio de atención al cliente a través de la burbuja de chat en la esquina inferior derecha de su navegador cuando se autentique con su cuenta TIMIFY.