Integração Frota

Neste artigo:

• O que faz a integração?
• Como configurar a integração
  • Recupere 3 identificadores das definições da sua conta Fleetio:
    • Chave API
    • Token da conta
    • Chave secreta do webhook
  • Ligue a sua conta Fleetio à sua conta Keycafe.
    • Adicionar campos personalizados
• Utilizando a integração
  • Associe uma chave Keycafe a um veículo Fleetio.
  • Métodos de notificação
    • Automático
    • Solicitação
  • Criar uma atribuição de veículo utilizando a configuração automática
  • Criar uma atribuição de veículo utilizando a configuração de prompt
• Desligar a sua conta Fleetio
• Assistência adicional

O que a integração faz?

Ao integrar sua conta Fleetio com o Keycafe, você pode associar rapidamente todo o seu inventário de veículos Fleetio à chave de cada veículo no Keycafe. Quando um veículo é atribuído a um motorista no Fleetio, um código PIN de reserva exclusivo para a chave é criado automaticamente no Keycafe e instruções de acesso são enviadas ao motorista. O motorista usará então o código PIN para recuperar a chave do veículo no 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.

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.

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. Inicie sessão na sua conta Fleetio, clique no menu suspenso da conta no canto superior esquerdo e selecione Definições.

2. Clique em Gerir chaves API.

3. Selecione + Adicionar chave API.

4. Introduza "Keycafe" para o Rótulo, selecione 2023-03-01 no menu suspenso para a Versão da APIe clique em Guardar. Você deverá ver o novo API Token na tabela.

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.

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. No seu menu Definições , desça até à secção Integrações e selecione Webhooks.

2. No canto superior direito da página, clique em + Adicionar Webhook.

3. No campo URL , copie e cole o seguinte URL: https://www.keycafe.com/webhooks/fleetio
4. Deixe o cabeçalho HTTP de autorização em branco. Digite “Keycafe” na Descriçãoe deixe marcada a opção Activada .

6. Clique em Selecionar Eventos, desça e selecione as três caixas da categoria Atribuição de Veículo e clique em Guardar:

• Atribuição de veículo criada
• Atribuição de veículo excluída
• Atribuição de veículo atualizada

7. De volta à página Webhooks, clique no botão Mais ações para o novo Webhook e, em seguida, clique em Ver segredo.

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

Agora devem existir três itens no seu documento temporário: a chave API, o token da contae a chave secreta.

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. No painel de controlo do Keycafe para desktop, clique em + Adicionar →Integração →Fleetio. Na aplicação móvel, toque em Mais → Integrações → Adicionar → Fleetio.
2. Insira a chave API, o token da conta e a chave secreta do seu documento temporário.

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

Adicionar campos personalizados

Em seguida, precisa de adicionar três campos personalizados à sua conta Fleetio.

1. De volta ao menu Fleetio Definições , desça até à secção Organização e selecione Gestão de Campos.

2. Clique em + Adicionar Campo.
3. Defina Tipo de Registo para Atribuição de Veículoe defina Tipo de Dados para Texto.
4. Introduza Instruções de acesso ao Keycafe no campo Rótulo.
5. Clique em Guardar para criar o campo personalizado.

6. Repita os passos acima para criar mais dois campos personalizados, totalizando três campos personalizados:

Para visualizar os campos personalizados, volte a Gestão de Campos, selecione Atribuição de Veículo Na lista pendente Tipo de Registo e pesquise por "Keycafe".

Usando a integração

Para começar a usar a integração, você deve associar as chaves adicionadas no Keycafe aos veículos adicionados no Fleetio. Depois que um veículo tiver uma chave associada, você pode começar a criar atribuições de veículos no Fleetio e as instruções de acesso à chave serão enviadas automaticamente ao motorista.

Associar uma chave Keycafe a um veículo Fleetio

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

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

4. Digite o nome da sua chave Keycafe para aquele veículo e selecione-a na lista suspensa.

5. Selecione Link para confirmar que deseja vincular esta chave a este veículo.
6. Pode ativar a opção Terminar atribuição automaticamente se pretender que a atribuição do veículo Fleetio seja terminada assim que as chaves forem devolvidas ao SmartBox (o que, consequentemente, terminará a reserva no Keycafe e, portanto, o acesso do condutor às chaves).
7. Você pode escolher Automático ou Prompt, o que mudará como um usuário será notificado quando um veículo for atribuído a ele. A maioria dos usuários deve escolher Automáticopara o fluxo de trabalho mais simples. Clique em Atualização para fechar a janela pop-up.

Métodos de notificação

Automático

Quando é criada uma atribuição de veículo no Fleetio, é enviado automaticamente um e-mail ou SMS para o condutor com instruções sobre como aceder às chaves. Isso permite que todo o processo seja concluído usando apenas o painel do Fleetio. O método de contacto baseia-se nos dados de contacto do perfil de utilizador do motorista no Fleetio. Se o condutor tiver um endereço de e-mail e um número de telefone associados à sua conta, o e-mail terá prioridade.

Solicitação

Quando uma atribuição de veículo é criada no Fleetio, o administrador da conta do Keycafe recebe um e-mail com um lembrete para criar o acesso à chave. Isso permite a personalização dos detalhes e instruções de acesso às chaves, mas exige o uso do Fleetio e do Keycafe para concluir o processo.

Crie uma atribuição de veículo usando a configuração automática

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 estes campos em branco - serão preenchidos automaticamente após a criação da tarefa.

2. 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. Às vezes, isso pode levar alguns minutos para ser preenchido.

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

Crie uma atribuição de veículo usando a configuração de prompt

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 estes campos em branco - serão preenchidos após a criação da chave de acesso no Keycafe.

2. Depois que a atribuição do veículo for criada no Fleetio, encontre o veículo na integração do Fleetio no Keycafe e selecione o ícone de calendário .

3. Você verá as datas de atribuição do veículo como uma reserva . Selecione o ícone + .

4. Confirme os detalhes da tarefa e selecione Criar reserva.

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

6. Navegue até a aba Reservas no Keycafe para confirmar. 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.

Desconectando sua conta Fleetio

1. No seu painel do Keycafe, selecione Integrações → Fleetio → Sobre a integração → Desligar.
2. Clique em Desconectar para confirmar.

Assistência adicional

Tem dúvidas sobre a integração ou sugestões de melhorias? Envie um e-mail para support@keycafe.com.