Como configurar uma conexão de integração entre várias filiais

O que é uma conexão de integração multifilial/Rede?

Esta é uma janela que se abre quando você clica no botão “Conectar” no cartão do aplicativo. Nele, o usuário pode escolher e conectar a integração em todas as filiais disponíveis ao mesmo tempo.

Fluxo de integração em múltiplas filiais pelo usuário:

1. O usuário deve clicar no botão “Conectar” no cartão do aplicativo.

2. Uma janela vai se abrir com a escolha de filiais (disponíveis - aqueles em que o usuario pode conectar a integração, ou seja, naquelas onde ele tem o direito “Gerenciar direitos de usuário”). Se apenas uma filial estiver disponível para ele, a janela com escolha de filiais não aparecerá. Caso esta integração já esteja habilitada em algumas filiais, elas não estarão disponíveis para seleção.

3. O usuário pode selecionar filiais específicas ou clicar na caixa de seleção “Selecionar todas as filiais”. Também existe uma função para buscar uma filial pelo nome.

4. O usuário clica no botão “Avançar” e vai para a tela de acordo de termos. E clica no botão “Continuar”.

5. O usuário acessa o site da integração e se cadastra.

6. Em todas as filiais selecionadas, a integração passa para o status “Conectada”.

Para configurar uma conexão de integração em sua aplicação (como desenvolvedor) em diversas filiais, você precisa:

1. Acesse a conta pessoal de desenvolvedor.

2. Acesse o aplicativo na aba “Configurações de desenvolvimento”.

3. Marque a caixa de seleção “Permitir que o aplicativo seja adicionado a várias ramificações”.

4. Salve as alterações.

Também é importante lembrar:

1. Caso o usuário tenha selecionado diversas filiais, ao se cadastrar, seu serviço receberá não um ID de filial, como antes, mas um conjunto de IDs de filiais no formato ?salon_ids[]=YYY&salon_ids[]=XXX. A solicitação para ativar a integração deve ser enviada para todas as filiais recebidas no conjunto, caso contrário a integração não será ativada e você, por sua vez, não terá acesso à API das filiais e não poderá adicionar seus webhooks a essas redes.

2. Se duas configurações forem selecionadas ao mesmo tempo — registro via iframe e conexão em diversas filiais — um  de IDs conjunto também será transferido para o iframe ao selecionar diversas filiais (você pode ler sobre registro via iframe neste artigo).

3. Se duas configurações forem selecionadas ao mesmo tempo - transferência de dados e conexão em várias filiais - como antes, user_data + uma matriz de IDs das filiais selecionadas serão transferidos para o seu serviço (você pode ler sobre transferência de dados neste artigo) .

 

Comentários