Instagram e Facebook Messenger via OAuth (login)

Esta documentação detalha o processo para conectar os canais do Facebook Messenger e do Instagram ao Z-PRO utilizando o Login Incorporado (OAuth) com o aplicativo nativo da ZDG

Essa é a forma mais rápida e recomendada de realizar a integração com Instagram e Facebook Messenger, pois dispensa a necessidade de criar e aprovar um aplicativo próprio no painel de desenvolvedores da Meta.

---

Etapa 0: Liberação no Painel Super Admin (Para ambos os canais)

A liberação da integração via aplicativo nativo precisa ser feita individualmente para cada empresa (Tenant) dentro do painel global. Esta etapa serve tanto para o Messenger quanto para o Instagram.

1. Faça o login no Z-PRO com o seu usuário Super Admin.

2. Acesse o menu Tenants e clique em Editar na empresa onde deseja ativar os canais.

Role a página até encontrar a seção de Autenticação (OAuth).

1. Habilite a chave de ativação do OAuth.

2. Preencha os campos com as informações do aplicativo nativo:

   • URL / Domínio:

   https://oauth.techprovider.com.br

   • Webhook do Messenger:

   https://oauth.techprovider.com.br/messenger-webhook/

   • Webhook do Instagram:

   https://oauth.techprovider.com.br/instagram-wehbhook/

   • Chave Secreta (é a mesma tanto para instagram quanto para messenger):

   2f5b5b457e2febbc3c2333e2ebc84df926a45c36f76f3bedc0d1994f749413f1

3. Clique em Salvar.

Obs: Volte mais acima, na seção de liberação de canais, certifique-se de que o WhatsApp, Facebook e Instagram estão habilitados para este tenant.

Clique em Salvar.

---

Etapa 1: Permissões de ADM da Página do Facebook (Especificamente para o canal Facebook Messenger)

Antes de ir para a tela de canais fazer a conexão, existe uma regra obrigatória apenas para o Facebook Messenger.

(Se você vai conectar apenas o Instagram, pule para a Etapa 2).

ATENÇÃO: O ACESSO DE ADM VIA GERENCIADOR DE NEGÓCIOS NÃO É SUFICIENTE PARA O MESSENGER

Para conectar o Messenger ao Z-PRO, o seu perfil pessoal do Facebook precisa estar adicionado como Administrador Direto da Página (Com perfil pessoal do facebook).

Ter "Acesso Total" através do Portfólio Empresarial (Gerenciador de Negócios / Meta Business Suite) não é suficiente para liberar a conexão. Se houver apenas esse acesso via portfólio / gerenciador, o sistema retornará um erro na hora de conectar.

Como corrigir e se adicionar como Administrador da Página do Facebook:

Se você já tem o acesso gerencial da página, siga estes passos no Facebook para se dar a permissão correta:

1. Abra o Facebook e mude para o perfil da Página (Logar como a página).

2. Acesse as Configurações da página.

3. No menu lateral, clique em Acesso à Página (ou Configuração da Página > Acesso à Página).

4. Na primeira seção, chamada "Pessoas com acesso do Facebook", clique em Adicionar novo.

5. Pesquise pelo seu perfil pessoal (o perfil que você usa para logar no Facebook) e conceda Controle Total.

6. Volte para o seu perfil pessoal do Facebook, abra suas notificações e Aceite o convite.

Etapa 2: Criando as Conexões no Painel Admin

Com o OAuth liberado no Tenant (e as permissões do Facebook ajustadas, caso vá usar o Messenger), vamos realizar a conexão final no painel de atendimento.

Acesse o Z-PRO com o seu usuário Administrador da conta (Tenant) e vá em Administração > Canais > Adicionar Canal.

Conectando o Instagram

O processo do Instagram é extremamente simples e não exige configurações avançadas de página.

1. No tipo de canal, selecione Instagram.

2. No campo "Aplicativo Meta", clique no menu suspenso e selecione a integração OAuth que liberamos no Super Admin (meta.zdg.com.br).

3. Clique no botão azul Conectar via Instagram OAuth.

4. No Pop-up da Meta: Uma janela do Facebook será aberta. Siga as etapas na tela para vincular a conta do Instagram Business.

   • Dica: Certifique-se de estar logado na sua conta do Instagram Business em outra aba do mesmo navegador para que o pop-up a reconheça e faça a vinculação automaticamente.

Opção B: Conectando o Facebook Messenger

1. No tipo de canal, selecione Facebook.

2. No campo "Aplicativo Meta", clique no menu suspenso e selecione a integração Oauth que liberamos no super-admin (meta.zdg.com.br).

3. Clique no botão azul Conectar via Facebook OAuth.

4. No Pop-up da Meta: Uma janela do Facebook será aberta.

   • Faça o login com o seu perfil pessoal (aquele que colocamos como administrador da página na Etapa 2).

   • Clique em Continuar como [Seu Nome].

   • Selecione a Página que você deseja conectar ao ZPRO e conceda as permissões solicitadas.

Pronto!

Se tudo estiver correto, a janela pop-up se fechará e o seu canal (Instagram ou Messenger) aparecerá como Conectado na sua lista de canais.

A partir de agora, todas as mensagens e directs dos canais instagram / facebook messenger chegarão diretamente na sua tela de atendimento do ZPRO!