Conexões por autorização: Shopify, Meta e Google Workspace

Estas conexões são para o app ler dados da sua conta (produtos e pedidos da sua loja, as publicações da sua página). Não confunda com o login social, que é o seu cliente entrando no app com a conta dele: isso fica na aba Autenticação, em Cadastro e login no seu app.

Antes de começar

• Plano: Builder. O plano é conferido a cada uso: se a conta sair do Builder, o app para de ler esses dados;
• Custo: criar os apps nos provedores é gratuito. Cada chamada que o app faz a essas contas consome créditos de integração;
• Você precisa estar presente no passo de autorizar: é você quem aprova o acesso, logado na sua conta do provedor.

Como funciona a autorização

O caminho é o mesmo para Shopify e Meta, e tem duas etapas:

1. salvar as chaves do app que você criou no provedor, no card, com Salvar e ativar;
2. conectar a conta: no mesmo card, clique em Conectar conta. Uma janela do provedor abre, você entra na sua conta e aprova o acesso. A janela fecha sozinha e o card mostra "Integração ativa."

O botão Conectar conta fica desabilitado até as chaves estarem salvas ("Salve as chaves primeiro e então conecte a conta."). Salvar as chaves não basta: sem a etapa 2, o app responde que é preciso conectar a conta primeiro.

Shopify

Campos do card: Shop domain, API key e API secret key.

O app pode listar produtos, ver um produto, listar pedidos e listar clientes da loja. É só leitura: o acesso pedido à loja é de ler produtos, pedidos e clientes.

1. em partners.shopify.com, crie um app (para testar, uma loja de desenvolvimento é gratuita);
2. copie a Client ID (vai no campo API key) e o Client secret (vai em API secret key);
3. no editor do app, aba Integrações, categoria E-commerce, abra o card Shopify;
4. em Shop domain, informe o domínio da loja no formato sua-loja.myshopify.com. Tem de ser o endereço .myshopify.com, não o domínio próprio da loja;
5. preencha as duas chaves e clique em Salvar e ativar;
6. clique em Conectar conta e aprove a instalação na loja.

Meta (Facebook/Instagram)

Campos do card: App ID e App Secret.

O app pode listar as Páginas do Facebook que você administra e ler as publicações de uma página. O acesso pedido é o de ver a lista de páginas, ler o engajamento delas e gerenciar o negócio.

1. em developers.facebook.com, crie um app (pode ser o mesmo do WhatsApp);
2. adicione o produto Facebook Login ao app;
3. em Configurações → Básico, copie o App ID e o App Secret;
4. no editor do app, aba Integrações, categoria Social, abra o card Meta (Facebook/Instagram);
5. cole as duas chaves e clique em Salvar e ativar;
6. clique em Conectar conta, entre com o Facebook de quem administra as páginas e aprove.

Enquanto o app da Meta está em modo de desenvolvimento, só quem tem papel no app (administrador, desenvolvedor, testador) consegue autorizar. Para o seu próprio uso, isso basta.

Google Workspace

Campos do card: Client ID e Client Secret.

A conexão é para o app usar Sheets, Calendar, Drive e Gmail com uma conta Google.

1. em console.cloud.google.com, no projeto que você usa (pode ser o mesmo do Maps), vá em APIs e serviços → Credenciais → Criar credenciais → ID do cliente OAuth, tipo Aplicativo da Web;
2. ative no projeto as APIs que o app vai usar (por exemplo, Google Sheets API e Google Calendar API);
3. no editor do app, aba Integrações, categoria Produtividade, abra o card Google Workspace, cole o Client ID e o Client Secret e clique em Salvar e ativar.

⚠️ Diferente de Shopify e Meta, o card do Google Workspace não tem hoje o botão Conectar conta: ele guarda as chaves, mas a etapa de autorizar a conta Google não está disponível nele. Se o seu app depende dessa conexão, fale com o suporte antes de construir em cima dela.

Não use aqui a URL de callback do login com Google, da aba Autenticação: ela é de outra conexão.

Como saber que funcionou

• depois de Conectar conta, a janela do provedor mostra "Conectado! Pode fechar esta janela." e fecha sozinha;
• o card mostra "Integração ativa." e o selo Conectado. Atenção: o selo aparece já ao salvar as chaves, antes da autorização. Ele sozinho não prova que a conta foi conectada;
• a prova final é o app mostrar os dados: peça no chat, por exemplo, "liste os produtos da minha loja Shopify".

Como revogar o acesso

Duas pontas, e vale fazer as duas:

1. na plataforma: abra o card e clique em Desconectar. As chaves e o acesso autorizado são apagados daqui;
2. no provedor: remova a autorização do lado dele, para o acesso deixar de existir de vez. Na Shopify, desinstale o app nas configurações de apps da loja. No Facebook, remova o app nas integrações comerciais da sua conta.

Problemas comuns

• A janela do provedor mostra um erro sobre o endereço de redirecionamento. O provedor exige que o endereço de retorno esteja cadastrado no app que você criou, e esse endereço não aparece no card hoje. Fale com o suporte para obter o endereço de retorno do seu projeto e cadastre-o no app do provedor;
• A janela fecha com "Falha:" seguido de um motivo. O motivo vem do provedor. Os mais comuns: a autorização foi cancelada, ou a chave secreta salva não é a do app em que você entrou;
• "preencha … antes de conectar". Falta algum campo salvo. Na Shopify, o Shop domain também é obrigatório;
• "shop_domain deve ser um domínio .myshopify.com válido". Use o endereço sua-loja.myshopify.com;
• Na Meta, ninguém além de mim consegue autorizar. O app da Meta está em modo de desenvolvimento.