Integración Fleetio

En este articulo:

• ¿Qué hace la integración?
• Cómo configurar la integración
  • Recupere 3 identificadores de la configuración de su cuenta Fleetio:
    • Clave API
    • Ficha de cuenta
    • Clave secreta del webhook
  • Vincula tu cuenta Fleetio con tu cuenta Keycafe
  • Pruebe la integración mediante:
    • Vincular una llave a un vehículo Fleetio
    • Métodos de notificación
    • Crear una reserva para ese vehículo

 

¿Qué hace la integración?

Al integrar su cuenta Fleetio con Keycafe, puede conectar rápidamente todo su inventario de vehículos Fleetio con la llave de cada vehículo en Keycafe. Cuando se asigna un vehículo a un conductor en Fleetio, se crea automáticamente una reserva única para la llave en Keycafe y se envían instrucciones de acceso al conductor. Luego, el conductor utilizará un código único para recuperar la llave del vehículo en el SmartBox. Las reservas de llaves de vehículos Fleetio aparecerán en Keycafe con un indicador Fleetio, y las instrucciones y el código de acceso a las llaves de Keycafe se muestran en la asignación del vehículo en Fleetio.

Los conductores con cuentas de Keycafe pueden usar su número de teléfono (y, si está habilitado, su PIN) para acceder a las llaves del vehículo que les han asignado en lugar de usar un nuevo código de un solo uso cada vez.

Después de la configuración inicial, esta integración permite la gestión y automatización de las asignaciones de vehículos utilizando solo Fleetio.

 

 

Cómo configurar la integración

Configurar su integración Fleetio y Keycafe implica recuperar 3 tokens de su cuenta Fleetio, luego vincular sus cuentas y probar la integración.

 

Recuperación de la clave API de Fleetio, el token de cuenta y la clave secreta del webhook

Le recomendamos que copie y pegue cada uno de estos en un documento temporal, como preparación para el siguiente paso.

 

Cree una nueva clave API en Fleetio

Una clave API permite que un sistema de terceros se conecte y permita transferencias de datos. Necesitarás generar una clave API en Fleetio que formará parte de la configuración de la integración con Keycafe.

1. Inicie sesión en su cuenta Fleetio, seleccione el nombre de su cuenta en la parte superior izquierda de la página, luego seleccione Configuración de la cuenta.

2. Seleccionar Administrar claves API.

3. Seleccione + Agregar clave API.
   

4. Escriba "Keycafe" para Etiqueta y luego haga clic en Generar clave API. Debería ver el nuevo API Token en la tabla.

 

Obtenga su token de cuenta Fleetio

Un token de cuenta es el identificador principal de un sistema de terceros en una integración API y se combina con la clave API para una identificación completa. El token de la cuenta Fleetio se encuentra en la página Claves API en la configuración de su cuenta Fleetio.

En la sección Tokens de cuenta, copie el token de cuenta en su totalidad y péguelo en el mismo documento temporal en el que colocó la clave API. Deberá agregar este token de cuenta en la configuración de integración de Keycafe.

 

Crear un webhook Fleetio

Un webhook le brinda la posibilidad de enviar una POST HTTP a una o más URL cada vez que ocurren tipos específicos de eventos en su cuenta Fleetio. Todos los eventos del webhook de Fleetio contienen datos serializados como JSON.

1. Inicie sesión en su cuenta Fleetio, seleccione el nombre de su cuenta en la parte superior izquierda de la página, luego seleccione Configuración de la cuenta.

2. Seleccionar Webhooks.

3. En la esquina superior derecha de la página, seleccione + Agregar webhook.

4. En la página Nuevo Webhook, copie y pegue lo siguiente en el campo URL:
   

https://www.keycafe.com/webhooks/fleetio

5. Ingrese "Keycafe" para Descripción.

6. Haga clic en Seleccionar eventos, luego desplácese hasta la parte inferior de la página y marque cada una de estas casillas: Asignación de vehículo creada, Asignación de vehículo eliminaday Asignación de vehículo actualizada. Haga clic en Guardar.

7. De vuelta en la página de Webhooks, haga clic en el botón de acciones pequeñas para que el nuevo Webhook muestre un menú emergente y luego haga clic en Ver secreto.

8. Copie la clave secreta en su totalidad y péguela en su documento temporal, que también contiene la clave API y el token de cuenta.

Ahora debería haber tres elementos en su documento temporal: la clave API , el token de cuenta y la clave secreta . Los agregará a la configuración de su cuenta de Keycafe.

 

Vincula tu cuenta Fleetio con tu cuenta Keycafe

Configurar la integración en Keycafe implica principalmente agregar los tres identificadores capturados en la tarea descrita anteriormente.

1. Inicie sesión en su cuenta de Keycafe.
2. En la esquina superior izquierda, seleccione + Agregar.
   
3. SeleccioneIntegración.
4. SeleccioneFleetio.
5. Ingrese la clave API, el token de la cuenta y la clave secreta de su documento temporal.

6. Seleccione Conéctese con Fleetio. Después de unos momentos, haga clic en la pestaña Integraciones en Keycafe para ver la integración.

 

Personalizado Campos

A continuación, debe agregar tres campos personalizados en la configuración de su sistema Fleetio.

1. Navegue a la página de Configuración de su cuenta Fleetio y ubique el elemento de menú Campos personalizados en la sección Configuración del sistema del menú del lado izquierdo.

2. Seleccione + Agregar campo personalizado en la esquina superior derecha de la página. En la página Nuevo campo personalizado, establezca Tipo de registro en Asignación de vehículoy establezca Tipo de datos en Texto.
3. Seleccione el botón Guardar campo personalizado para crear el campo personalizado.

4. Repita los pasos anteriores para crear dos campos personalizados más. El objetivo es crear estos tres campos personalizados:

Tipo de registro	Tipo de datos	Etiqueta
Asignación de vehículos	Texto	Instrucciones de acceso a Keycafé
Asignación de vehículos	Texto	Enlace de acceso a Keycafé
Asignación de vehículos	Texto	Código de acceso a Keycafé

 

Para ver los campos personalizados en la configuración de Fleetio, navegue hasta la página Campos personalizados y, en el menú desplegable Tipo de registro — elija Asignación de vehículo en el menú desplegable.

 

Vincular una llave a un vehículo Fleetio

Ahora es el momento de vincular un vehículo Fleetio a una llave.

1. La pestaña Integraciones en Keycafe ahora debería contener un elemento para la integración. Haga clic en ese elemento para mostrar los subelementos Vehículos y Acerca de .

2. Para ver una lista de sus vehículos Fleetio, haga clic en Vehículos para explorar la lista en el lado derecho.
3. Elija un vehículo y haga clic en el ícono de llave pequeña.

4. Escriba el nombre de su clave de Keycafe y selecciónela de la lista desplegable de nombres de claves coincidentes.

5. Seleccione Vincular para confirmar que desea vincular esta llave a este vehículo.
6. Puede elegir Automático o Aviso, lo que cambiará la forma en que se notifica a un usuario cuando se le asigna un vehículo, lo que hará que aparezca un aviso cada vez que un huésped solicite acceso a las llaves. Haga clic en Actualizar para cerrar la ventana emergente.

 

Métodos de notificación

Automático

Cada vez que se crea una asignación de vehículo en Fleetio, se envía automáticamente un correo electrónico al conductor con instrucciones sobre cómo acceder a las llaves.

1. Al crear una asignación de vehículo en Fleetio, verá tres campos vacíos para Instrucciones de acceso a Keycafe, Enlace de acceso a Keycafey Código de acceso a Keycafe. Déjelos en blanco, ya que se completarán automáticamente cuando se cree la tarea.
   

2. Una vez creada la asignación, consulte los detalles para ver los valores completados para Instrucciones de acceso a Keycafe, Enlace de acceso a Keycafey Código de acceso a Keycafe.

3. La tarea también aparecerá en la pestaña Reservas en Keycafe.

 

Inmediato

Con la configuración Aviso, el administrador de la cuenta de Keycafe recibe un correo electrónico con un recordatorio para crear la clave de acceso cada vez que se asigna un vehículo en Fleetio. Esto permite la personalización del acceso clave.

1. Una vez que se haya asignado un vehículo en Fleetio, busque ese vehículo dentro de la integración de Fleetio en Keycafe y seleccione el ícono de calendario .

2. Seleccione la reserva a la que le gustaría asignar una clave de acceso.

3. Confirme la fecha , el conductor y el correo electrónico de contacto para la tarea y seleccione Crear reserva.

4. Personaliza los detalles de la reserva como desees y confírmala seleccionando Añadir.

5. Navegue a la pestaña Reservas en Keycafe para confirmar.

El conductor asignado recibirá un correo electrónico o un SMS (según el método de contacto que acaba de seleccionar) con instrucciones sobre cómo acceder a la llave.