Conectando a integração por meio do marketplace

Como conectar a integração via marketplace:

1. O usuário deve clicar em “Conectar” na página do seu aplicativo no marketplace Altegio.

2. A Altegio solicitará uma permissão ao usuário para fornecer acesso à sua conta pessoal via API. Depois disso, a integração pode ser conectada por uma solicitação de API (Disponivel em inglês) de sua parte.

3. A partir da Altegio, o usuário será redirecionado para o site do formulário de cadastro em seu serviço, que você especificou nas configurações do aplicativo no campo “insira um link para o seu site”.

a. O parâmetro salon_id GET será adicionado ao endereço url do seu formulário de registro. O valor deste parâmetro é o id da filial da Altegio.
Exemplo: https://seusite.com/cadastro?salon_id=12345

4. Após cadastrar/autorizar junto ao seu serviço, você precisará enviar uma requisição de API para conectar a integração.

a. Você deve enviar uma solicitação dentro de 1 hora após o usuário concordar em fornecer acesso a algumas informações da conta pessoal na Altegio (enviada a você na página de registro). Se a solicitação for enviada posteriormente, você receberá um erro e o usuário precisará reconectar a integração pelo marketplace.

Após o envio do pedido API para conexão, a integração com o seu serviço será habilitada na conta pessoal da sua filial na Altegio:

  • O usuário do seu sistema será adicionado à conta pessoal do cliente. Você especifica o ID do usuário do sistema nas configurações do aplicativo no campo “ID do usuário”. Você poderá usar o token do portador deste usuário para fazer solicitações à API da filial de acordo com os direitos de acesso solicitados.
  • Eventos sobre mudanças na filial serão enviados para os endereços de webhook que você forneceu.
  • Caso sua integração esteja na categoria Notificações, sua API_KEY também será adicionada às configurações da filial para enviar notificações do sistema.

Melhores Práticas

Recomenda-se enviar uma solicitação para conectar a integração imediatamente após a finalização do cadastro do usuário ao lado do seu serviço. Depois disso, você terá acesso à ramificação da API. Em seguida, você pode usar a API para obter os dados necessários sobre a filial, o usuário e facilitar a configuração da integração do seu lado.

Além disso, não se esqueça de prever que um usuário já cadastrado/autorizado em seu serviço possa vir até você a partir do marletplace Altegio. Envie uma solicitação para conectar a integração no marketplace não apenas no momento do registro, mas quando um usuário fizer login no seu serviço ou quando um usuário for do marketplace Altegio diretamente para a conta pessoal em seu serviço.

Por favor, note que

Cadastro automático de usuários em seu sistema

Para simplificar o processo de conexão de sua integração, você pode conectar a transferência de dados do usuário na conexão. Neste caso, ao conectar a integração, você receberá os dados do usuário (nome, telefone, e-mail) e o cadastrará automaticamente em seu sistema sem forçá-lo a preencher um formulário. De acordo com nossos dados, usar essa configuração aumenta a taxa de conversão de conexão em 30-40%. Mais.

Conectando a integração a várias filiais de uma vez

Se a sua integração funciona com várias filiais Altegio, então conecte a configuração “Permitir que o aplicativo seja adicionado a várias filiais”. Nesse caso, ao conectar, o usuário será solicitado a selecionar em quais filiais deseja instalar a integração. Mais.

Conectando e configurando a integração do iframe

Você pode conectar a configuração "Abrir formulário de registro no iframe". Então, ao clicar na página de cadastro “Conectar” do seu serviço ela abrirá na aba “Configurações” no card do seu aplicativo no marketplace. Isso aumenta significativamente a confiança do usuário em seu serviço. A interação com o seu serviço ocorre na interface  da Altegio. Mais.

 

 

 

Comentários