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.
- Faça o login no Konvoo com o seu usuário Super Admin.
- 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).
Habilite a chave de ativação do OAuth.
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
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 Konvoo, 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:
- Abra o Facebook e mude para o perfil da Página (Logar como a página).
- Acesse as Configurações da página.
- No menu lateral, clique em Acesso à Página (ou Configuração da Página > Acesso à Página).
- Na primeira seção, chamada "Pessoas com acesso do Facebook", clique em Adicionar novo.
- Pesquise pelo seu perfil pessoal (o perfil que você usa para logar no Facebook) e conceda Controle Total.
- 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 Konvoo 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.
- No tipo de canal, selecione Instagram.
- No campo "Aplicativo Meta", clique no menu suspenso e selecione a integração OAuth que liberamos no Super Admin (meta.konvoo.com.br).
- Clique no botão azul Conectar via Instagram OAuth.
- 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
- No tipo de canal, selecione Facebook.
- No campo "Aplicativo Meta", clique no menu suspenso e selecione a integração Oauth que liberamos no super-admin (meta.konvoo.com.br).
- Clique no botão azul Conectar via Facebook OAuth.
- 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 Konvoo 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 Konvoo!