Integración Fleetio

En este articulo:

 

¿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.

Característica prémium

Para los usuarios empresariales, las integraciones de terceros son una función que solo está disponible en el plan Premium.

 

 

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.

1.png

  1. Seleccionar Administrar claves API.

2.jpg

  1. Seleccione + Agregar clave API.

api.jpg

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

4.png

 

Obtenga su token de cuenta Fleetio

Un token de cuenta es el identificador principal de un sistema de terceros en una integración de API y se combina con la clave de 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.

5.png

 

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.

1.png

  1. Seleccionar Webhooks.

imagenedit_2_6778732161.jpg

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

7.png

  1. En la página Nuevo Webhook, copie y pegue lo siguiente en el campo URL:
https://www.keycafe.com/webhooks/fleetio
  1. Ingrese "Keycafe" para Descripción.

8.png

  1. 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.

webhook.jpg

  1. 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.

clave.png

  1. 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.

imagenedit_2_3519415585.jpg

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.

sin nombre.png

 

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.

sin nombre__1_.png

  1. 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.

sin nombre__2_.png

  1. 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.
  2. Seleccione el botón Guardar campo personalizado para crear el campo personalizado.

sin nombre__3_.png

  1. 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.

sin nombre__4_.png

 

Vincular una llave a un vehículo Fleetio

Agregar claves a Keycafe

Deberá agregar las llaves de su vehículo al sistema Keycafe antes de proceder a vincular una llave a un vehículo Fleetio. Consulte Agregar una clave.

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 .

04294f3f5eb1d81b6aca593dcb2d9afe.png

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

381453b7813a76e1feb7ef24d5e7d8be.png

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

7a69508544907517fe57cad277ca8538.png

  1. Seleccione Vincular para confirmar que desea vincular esta llave a este vehículo.
  2. 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.

c03bf175086b559839477d0ac8abf2ea.png

Cambiar el método de notificación

Puede cambiar entre automático y rápido en cualquier momento seleccionando el ícono de ajustes al lado de la llave vinculada del vehículo.

 

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.

212d41bfb47b00c3f89221bb12008969.png

  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.

sin nombre.png

  1. 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.

sin nombre__1_.png

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

sin nombre__4_.png

 

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 .

sin nombre__5_.png

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

1e660e13fbb87740c262340ca9198596.png

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

f665bb7b0aa8ec2b16832e948c51c4b1.png

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

8ba5559ed19c026138bbaec80f6e6303.png

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

257a0304d2be41aff11ddcb165cad388.png

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.

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 0