- Permite que os clientes façam login e cadastro na loja usando a própria conta do Facebook, sem precisar criar senha.
- Exige a criação de um aplicativo no Facebook for Developers, com credenciais próprias vinculadas à loja.
- Funciona em lojas Magento 2, através do módulo Login Social (O2TI).
- O aplicativo passa por um processo de análise do Facebook antes de poder ser publicado e usado pelos clientes.
Passo a Passo por Escrito
1. Crie sua conta e o aplicativo no Facebook for Developers
Acesse developers.facebook.com e crie uma conta, caso ainda não tenha. Em seguida, acesse Meus Apps e clique em Criar aplicativo.
Preencha os detalhes do aplicativo:
- Em Nome do aplicativo, defina um nome (por exemplo, o nome da sua loja).
- Em Caso de uso, selecione a opção Autenticar e solicitar dados de usuários com o Login do Facebook.
- Em Empresa, selecione a empresa vinculada à sua conta.
Avance pelas telas seguintes até a etapa Visão geral e clique em Criar aplicativo para finalizar.
Resultado esperado: o aplicativo é criado e passa a aparecer no Painel do aplicativo no Facebook for Developers.
2. Verifique a empresa, se solicitado (opcional)
No Painel do aplicativo, caso a empresa vinculada ainda não esteja verificada pelo Facebook, aparecerá a opção Verificar empresa. Clique nela e siga as instruções apresentadas pelo Facebook para concluir a verificação.
Este passo só é necessário se o Facebook solicitar a verificação da empresa. Caso essa opção não apareça, siga para o próximo passo.
Resultado esperado: empresa verificada ou confirmação de que a verificação não é necessária neste momento.
3. Personalize o caso de uso e abra as configurações do app
No Painel do aplicativo, acesse Personalizar caso de uso e localize public_profile. Clique em Ações e depois em Ir para análise do app. Avance.
Na tela seguinte, clique em Ir para configurações do app.
Resultado esperado: a tela de configurações básicas do aplicativo é aberta, pronta para preenchimento.
4. Preencha as informações básicas do aplicativo
- Em Ícone, envie a logo da sua loja. A imagem precisa ser quadrada, com tamanho entre 512 x 512 e 1024 x 1024 pixels.
- Em URL da Política de Privacidade, informe a URL da página de política de privacidade da sua loja.
- Em Exclusão de dados do usuário, informe a URL da política de exclusão de dados (ou a mesma URL de privacidade, caso sua loja trate o tema na mesma página).
- Em Categoria do app, selecione a categoria que melhor representa sua loja.
- Em Uso permitido, clique em Começar para iniciar a validação.
- Em Tratamento de dados, selecione as opções que correspondem à forma como sua loja trata os dados dos clientes.
- Clique em Acessar configurações. Uma nova aba será aberta.
Os campos URL da Política de Privacidade e Categoria do app são obrigatórios. Sem eles, o aplicativo não avança na análise do Facebook.
Resultado esperado: uma nova aba é aberta com a tela de configurações de exclusão de dados e plataformas do aplicativo.
5. Configure a exclusão de dados e adicione a plataforma Website
Na nova aba aberta:
- Em Exclusão de dados do usuário, selecione URL de retorno de chamada para exclusão de dados e informe a URL da política de exclusão de dados (ou de privacidade, caso o tema esteja incluído nela).
- No final da página, em Adicionar Plataforma, selecione Website e avance.
- Informe o link da sua loja e clique em Salvar.
Resultado esperado: mensagem confirmando que a plataforma Website foi adicionada ao aplicativo.
6. Envie o aplicativo para análise
Volte para a aba anterior e avance. Na tela seguinte, em Instruções da análise, clique em Ir para instruções de análise e preencha os campos conforme as políticas da sua loja. Avance e clique em Enviar para Análise.
A partir deste momento o aplicativo entra em análise pelo Facebook. Esse processo pode levar alguns dias — acompanhe o status na aba Analisar do painel do aplicativo.
Resultado esperado: aplicativo enviado para análise, com status disponível na aba Analisar.
7. Configure a URL de retorno do login
Em Casos de uso, clique em Personalizar e depois em Configurações. Localize o campo URIs de redirecionamento do OAuth válidos e informe a seguinte URL:
https://minhaloja.com.br/sociallogin/endpoint/index/provider/facebook/
Substitua apenas minhaloja.com.br pelo domínio da sua loja. Mantenha o restante da URL exatamente como está.
Clique em Salvar alterações.
Resultado esperado: mensagem confirmando que as alterações foram salvas.
8. Copie as credenciais do aplicativo
Mesmo com o aplicativo ainda em análise, você já pode copiar as credenciais. Acesse Configurações do app → Básico e copie o ID do Aplicativo e a Chave Secreta do Aplicativo. Guarde essas informações — elas serão usadas na configuração da sua loja.
Sem o ID do Aplicativo e a Chave Secreta preenchidos corretamente na loja, o login com Facebook não vai funcionar para os clientes.
Resultado esperado: ID do Aplicativo e Chave Secreta copiados e guardados para uso no próximo passo.
9. Configure o login social com Facebook na sua loja
Acesse sua loja e vá em Lojas → Configuração → O2TI → Login Social.
- Em Habilitar, selecione Sim.
- Em Facebook → Habilitar, selecione Sim ou Não (veja o aviso abaixo).
- Em ID do APP, informe o ID do Aplicativo copiado no passo anterior.
- Em Segredo do APP, informe a Chave Secreta do Aplicativo copiada no passo anterior.
- Clique em Gravar configurações.
Se o aplicativo ainda estiver em análise no Facebook, mantenha Facebook → Habilitar como Não até que ele seja publicado. Habilitar antes da publicação pode gerar erro de login para os clientes.
Resultado esperado: mensagem confirmando que as configurações foram salvas.
10. Publique o aplicativo e habilite o login na loja
Após a aprovação do Facebook, acesse novamente o Facebook for Developers, selecione o aplicativo e vá em Publicar. Clique em Publicar para liberar o login aos clientes.
Se o botão Publicar não estiver habilitado, aguarde. Isso indica que a análise ainda está em andamento ou que há alguma pendência a corrigir — acompanhe pela aba Analisar do painel do aplicativo.
Em seguida, volte à sua loja em Lojas → Configuração → O2TI → Login Social, altere Facebook → Habilitar para Sim e clique em Gravar configurações.
Resultado esperado: login com Facebook disponível para os clientes na loja.
Validação e Testes
Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.
Teste 1 — Login com Facebook na loja
Ação: acesse a loja em uma janela anônima do navegador, vá até a tela de login ou cadastro e clique no botão Entrar com Facebook.
Resultado esperado: uma janela do Facebook é aberta solicitando a autorização do login. Ao autorizar, você é redirecionado de volta à loja já autenticado.
Teste 2 — Verificar dados do cliente cadastrado
Ação: após concluir o login com Facebook, verifique na loja se os dados básicos do cliente (nome e e-mail) foram preenchidos corretamente na conta.
Resultado esperado: conta de cliente criada ou associada na loja, com nome e e-mail vindos do Facebook.
Teste 3 — Verificar status do aplicativo no Facebook
Ação: acesse o Facebook for Developers, selecione o aplicativo e confira em Publicar se ele está com o status publicado.
Resultado esperado: status do aplicativo exibido como publicado, liberando o login para todos os clientes.
Se não funcionar, verifique:
- Se o aplicativo no Facebook já foi aprovado e publicado.
- Se o ID do Aplicativo e a Chave Secreta foram copiados corretamente, sem espaços extras.
- Se a URL de redirecionamento (URIs de redirecionamento do OAuth) está configurada com o domínio correto da sua loja.
- Se a opção Facebook → Habilitar está marcada como Sim na configuração da loja.
Pronto! Dessa forma realizamos a configuração do Login Social com Facebook em sua loja virtual Magento 2.
Observações Importantes
- O processo de análise do Facebook pode levar alguns dias. Acompanhe o status na aba Analisar do painel do aplicativo.
- Antes da publicação do aplicativo, mantenha o Facebook desabilitado nas configurações da loja para evitar erros de login para os clientes.
- A URL de redirecionamento configurada no Facebook precisa corresponder exatamente ao domínio da sua loja. Qualquer divergência impede o login.
- A logo enviada no aplicativo do Facebook precisa ser quadrada, com tamanho entre 512 x 512 e 1024 x 1024 pixels.
- Esta documentação cobre apenas a configuração do provedor Facebook. Outros provedores de login social, quando disponíveis, terão processo de configuração próprio.
Referências e Relacionados
- Credenciais API — visão geral: entenda como o admin da loja gerencia credenciais e conexões de integrações externas de forma geral. [INSERIR LINK]
- Política de Privacidade e Exclusão de Dados da loja: saiba como configurar essas páginas na sua loja, exigidas também por outras integrações que dependem de credenciais externas. [INSERIR LINK]
- Configuração de cache da loja: após configurar o login social, pode ser necessário limpar o cache para que as alterações apareçam corretamente no frontend. [INSERIR LINK]
- Gerenciar Clientes: veja como visualizar e gerenciar as contas de clientes criadas através do login social. [INSERIR LINK]
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br