Integração Frota

Neste artigo:

 

O que a integração faz?

Ao integrar sua conta Fleetio com Keycafe, você pode conectar rapidamente todo o seu inventário de veículos Fleetio com a chave de cada veículo no Keycafe. Quando um veículo é atribuído a um motorista no Fleetio, uma reserva única da chave é criada automaticamente no Keycafe e as instruções de acesso são enviadas ao motorista. O motorista usará então um código exclusivo para recuperar a chave do veículo na SmartBox. As reservas das chaves do veículo Fleetio aparecerão no Keycafe com um indicador Fleetio, e as instruções e código de acesso da chave Keycafe são mostradas na atribuição do veículo no Fleetio.

Os motoristas com contas Keycafe podem usar seu número de telefone (e, se habilitado, seu PIN) para acessar as chaves do veículo que lhes foram atribuídas, em vez de usar um novo código único a cada vez.

Após a configuração inicial, esta integração permite a gestão e automatização das atribuições de veículos utilizando apenas o Fleetio.

Recurso Premium

Para usuários corporativos, as integrações de terceiros são um recurso disponível apenas no plano Premium.

 

 

Como configurar a integração

Configurar sua integração Fleetio e Keycafe envolve recuperar 3 tokens de sua conta Fleetio, vincular suas contas e testar a integração.

 

Recuperando a chave da API Fleetio, o token da conta e a chave secreta do Webhook

Recomendamos que você copie e cole cada um deles em um documento temporário, como preparação para a próxima etapa.

 

Crie uma nova chave de API no Fleetio

Uma chave de API permite que um sistema de terceiros se conecte e permita transferências de dados. Você precisará gerar uma chave API no Fleetio que fará parte da configuração da integração com o Keycafe.

  1. Faça login na sua conta Fleetio, selecione o nome da sua conta no canto superior esquerdo da página e selecione Configurações da conta.

1.png

  1. Selecione Gerenciar chaves de API.

2.jpg

  1. Selecione + Adicionar chave API.

API.jpg

  1. Digite "Keycafe" para o Label e clique em Generate API Key. Você deverá ver o novo API Token na tabela.

4.png

 

Obtenha seu token de conta Fleetio

Um token de conta é o identificador principal de um sistema de terceiros em uma integração de API e é emparelhado com a chave de API para identificação completa. O token da conta Fleetio é encontrado na página Chaves de API nas configurações da sua conta Fleetio.

Na seção Account Tokens, copie o token da conta por completo e cole-o no mesmo documento temporário em que você colocou a chave API. Você precisará adicionar este token de conta na configuração de integração do Keycafe.

5.png

 

Crie um webhook Fleetio

Um webhook permite enviar um HTTP POST para um ou mais URLs sempre que ocorrerem tipos específicos de eventos em sua conta Fleetio. Todos os eventos de webhook do Fleetio contêm dados serializados como JSON.

  1. Faça login na sua conta Fleetio, selecione o nome da sua conta no canto superior esquerdo da página e selecione Configurações da conta.

1.png

  1. Selecione Webhooks.

imageedit_2_6778732161.jpg

  1. No canto superior direito da página, selecione + Adicionar Webhook.

7.png

  1. Na página Novo Webhook, copie e cole o seguinte no campo URL:
https://www.keycafe.com/webhooks/fleetio
  1. Insira “Keycafe" para Descrição.

8.png

  1. Clique em Selecionar eventos, role até a parte inferior da página e marque cada uma destas caixas: Atribuição de veículo criada, Atribuição de veículo excluídae Atribuição de veículo atualizada. Clique em Salvar.

webhook.jpg

  1. De volta à página Webhooks, clique no pequeno botão de ações do novo Webhook para exibir um menu pop-up e clique em Ver segredo.

chave.png

  1. Copie a chave secreta por completo e cole-a em seu documento temporário, que também contém a chave de API e o token da conta.

imageedit_2_3519415585.jpg

Agora deve haver três itens em seu documento temporário: a chave de API , o token de conta e a chave secreta . Você irá adicioná-los às configurações da sua conta do Keycafe.

sem nome.png

 

Vincule sua conta Fleetio à sua conta Keycafe

Configurar a integração no Keycafe envolve principalmente adicionar os três identificadores capturados na tarefa descrita acima.

  1. Faça login em sua conta Keycafe.
  2. No canto superior esquerdo, selecione + Adicionar.
  3. SelecioneIntegração.
  4. SelecioneFrota.
  5. Insira a chave API, o token da conta e a chave secreta do seu documento temporário.

sem nome__1_.png

  1. Selecione Conecte-se com Fleetio. Após alguns instantes, clique na aba Integrações no Keycafe para ver a integração.

 

Personalizado Campos

Em seguida, você precisa adicionar três campos personalizados nas configurações do sistema Fleetio.

  1. Navegue até a página Configurações da conta Fleetio e localize o item de menu Campos personalizados na seção Configurações do sistema no menu do lado esquerdo.

sem nome__2_.png

  1. Selecione + Adicionar campo personalizado no canto superior direito da página. Na página Novo campo personalizado, defina Record Type como Vehicle Assignmente defina Data Type como Text.
  2. Selecione o botão Salvar campo personalizado para criar o campo personalizado.

sem nome__3_.png

  1. Repita as etapas acima para criar mais dois campos personalizados. O objetivo é criar estes três campos personalizados:

Tipo de registro

Tipo de dados

Rótulo

Atribuição de Veículo

Texto

Instruções de acesso ao Keycafe

Atribuição de Veículo

Texto

Link de acesso ao Keycafe

Atribuição de Veículo

Texto

Código de acesso ao Keycafe

 

Para visualizar os campos personalizados nas configurações do Fleetio, navegue até a página Campos personalizados e - no menu suspenso Tipo de registro - escolha Atribuição de veículo no menu suspenso.

sem nome__4_.png

 

Vincular uma chave a um veículo Fleetio

Adicionando chaves ao Keycafe

Terá de adicionar as chaves do seu veículo ao sistema Keycafe antes de proceder à ligação de uma chave a um veículo Fleetio. Consulte Adicionando uma chave.

Agora é hora de vincular um veículo Fleetio a uma chave.

  1. A aba Integrações no Keycafe agora deve conter um item para a integração. Clique nesse item para exibir os subitens Veículos e Cerca de .

04294f3f5eb1d81b6aca593dcb2d9afe.png

  1. Para visualizar uma lista dos seus veículos Fleetio, clique em Veículos para navegar na lista no lado direito.
  2. Escolha um veículo e clique no pequeno ícone de chave.

381453b7813a76e1feb7ef24d5e7d8be.png

  1. Digite o nome da sua chave Keycafe e selecione-a na lista suspensa de nomes de chaves correspondentes.

7a69508544907517fe57cad277ca8538.png

  1. Selecione Link para confirmar que deseja vincular esta chave a este veículo.
  2. Você pode escolher Automático ou Prompt, o que mudará a forma como um usuário é notificado quando um veículo é atribuído a ele, o que fará com que um prompt apareça cada vez que um convidado solicitar acesso às chaves. Clique em Atualização para fechar a janela pop-up.

c03bf175086b559839477d0ac8abf2ea.png

Alterando o método de notificação

Você pode alternar entre automático e imediato a qualquer momento selecionando o ícone de engrenagem próximo à chave vinculada do veículo.

 

Métodos de notificação

Automático

Sempre que é criada uma atribuição de veículo no Fleetio, é enviado automaticamente um email ao motorista com instruções sobre como aceder às chaves.

212d41bfb47b00c3f89221bb12008969.png

  1. Ao criar uma atribuição de veículo no Fleetio, você verá três campos vazios para Instruções de acesso ao Keycafe, Link de acesso ao Keycafee Código de acesso ao Keycafe. Deixe-os em branco, pois eles serão preenchidos automaticamente quando a tarefa for criada.

sem nome.png

  1. Depois que a atribuição for criada, visualize os detalhes para ver os valores preenchidos para Instruções de acesso ao Keycafe, Link de acesso ao Keycafee Código de acesso ao Keycafe.

sem nome__1_.png

  1. A atribuição também aparecerá na aba Reservas do Keycafe.

sem nome__4_.png

 

Incitar

Com a configuração Prompt, o administrador da conta Keycafe recebe um e-mail com um lembrete para criar a chave de acesso sempre que um veículo for atribuído no Fleetio. Isso permite a personalização do acesso à chave.

  1. Assim que um veículo for atribuído no Fleetio, encontre esse veículo na integração do Fleetio no Keycafe e selecione o ícone de calendário .

sem nome__5_.png

  1. Selecione a reserva à qual você gostaria de atribuir uma chave de acesso.

1e660e13fbb87740c262340ca9198596.png

  1. Confirme a data , o motorista e o e-mail de contato para a tarefa e selecione Criar reserva.

f665bb7b0aa8ec2b16832e948c51c4b1.png

  1. Personalize os dados da reserva como desejar e confirme selecionando Adicionar.

8ba5559ed19c026138bbaec80f6e6303.png

  1. Navegue até a aba Reservas no Keycafe para confirmar.

257a0304d2be41aff11ddcb165cad388.png

O motorista designado receberá um e-mail ou SMS (dependendo do método de contato que você acabou de selecionar) com instruções sobre como acessar a chave.

Este artigo foi útil?
Utilizadores que acharam útil: 0 de 0