Canal Instagram Nativo (BETA)

A partir da v3.1.4.7

A integração nativa do Instagram permite conectar o Instagram Direct diretamente ao Z-PRO através da API Oficial da Meta.

Diferente de emuladores ou automações de tela, esta conexão é oficial, oferecendo maior estabilidade e segurança contra bloqueios.


Parte 1: Configuração no Facebook Developers

Para utilizar o Instagram Nativo, você deve editar o mesmo Aplicativo (App) que você já utiliza para o WhatsApp (WABA) ou criar um novo.

  1. Acesse developers.facebook.com e selecione o seu App.

  2. No menu lateral, vá em Casos de Uso (ou Use Cases).

  3. Clique em Adicionar (ou Edit) e procure pela opção relacionada a Gerenciar mensagens de conteúdo no Instagram (Instagram Message Management).

  4. Adicione este caso de uso ao seu aplicativo.

  5. Configurações de Login:

    • Verifique a seção "Configurações de Login da Empresa".

    • Certifique-se de que a URL de callback (a mesma usada para o WABA) esteja salva corretamente.

Permissões Necessárias

Ao adicionar o caso de uso, o sistema solicitará permissões. Certifique-se de adicionar:

  • instagram_basic

  • instagram_manage_messages

  • pages_manage_metadata

  • pages_show_list (geralmente necessárias para listar as páginas vinculadas ao Instagram).


Parte 2: Atualizar o Token (Gerenciador de Negócios)

Como adicionamos novas permissões (Instagram) a um aplicativo que antes só tinha WhatsApp, o Token antigo não funcionará. É obrigatório gerar um novo.

  1. Acesse o Gerenciador de Negócios (Business Manager).

  2. Vá em Usuários do Sistema.

  3. Clique em Gerar Novo Token.

  4. Selecione o Aplicativo que você configurou na Parte 1.

  5. Importante: Na lista de permissões, agora aparecerão as novas opções do Instagram que você ativou. Marque todas as permissões de Instagram disponíveis, além das permissões de WhatsApp e Business Management que já usava.

  6. Gere o Token e copie-o.


Parte 3: Configuração no Z-PRO (Superadmin)

  1. Acesse o painel Superadmin do Z-PRO.

  2. Vá até as configurações do App WABA (onde você configurou o login do Facebook).

  3. Você notará que agora existe uma seção específica para Configuração do Instagram.

  4. Preencha os campos:

    • App ID: O ID do aplicativo (o mesmo do WABA).

    • App Secret: O segredo do aplicativo (se houver campo específico ou usar o geral).

    • Token: Cole aqui o NOVO Token que você gerou na Parte 2 (que contém as permissões de Instagram).

  5. Salve as alterações.


Parte 4: Conectando no Painel do Cliente

Após o Superadmin realizar a configuração técnica, o cliente final pode conectar a conta facilmente.

  1. Acesse o painel da empresa (Tenant).

  2. Vá em Conexões (ou Canais).

  3. Clique em Adicionar e escolha a opção Instagram.

  4. Você verá um botão para Login com Instagram (ou Facebook).

  5. Ao clicar, uma janela da Meta se abrirá solicitando permissão para acessar a conta do Instagram Business vinculada à Página do Facebook.

  6. Após autorizar, selecione a conta desejada e o canal será criado no Z-PRO.

Pré-requisito da Conta: Para que funcione, a conta do Instagram do cliente deve ser uma Conta Comercial (Business) e estar obrigatoriamente vinculada a uma Página do Facebook.

Atualizado