Avançar para o conteúdo principal

Integrar com o Instagram

O Instagram Messenger, é uma parte integrante da plataforma Instagram que permite aos usuários enviar mensagens diretas uns aos outros, tanto de contas pessoais quanto de contas de negócios. Os utilizadores podem entrar em contato com as empresas no Instagram Messenger, permitindo às empresas estarem mais perto dos seus clientes. Pode integrar o nosso chat com o Instagram Messenger, o que permite receber e responder a mensagens

 

1. Criar APP do Instagram

Para começar a configurar a integração com o chat do Instagram, deverá antes criar uma APP na página para desenvolvedores do Meta. Para isso deve ir até https://developers.facebook.com/ e registar a sua conta, caso ainda não tenha uma.

 

1.1. No topo clique em "Meus Apps".

image-1711117796055.png

 

1.2. Agora, clique em "Aplicativos" e depois em "Criar aplicativo".

image-1711118210092.png

 

1.3. No painel seguinte, selecione "Outro" e depois em "Avançar".

image-1711118626466.png

 

1.3. Na página seguinte, selecione "Business" e faça "Avançar".

image-1711118662513.png

 

1.4. Dê um nome à sua APP e selecione o email que quer associar à mesma. Clique em Criar aplicativo para avançar para a próxima página.

image-1711119860981.png

 

1.5. Na página seguinte aparecerá a lista de produtos que pode adicionar à sua APP. Procure por "Webhooks" e clique em configurar.

image-1711120024549.png

 

1.6. Nesta página, onde tem "User", clique e selecione "Instagram". Depois, clique em "Subscribe to this object".

image-1711120184011.png

 

1.7. Ao fazer isto, abrir-se-á um painel com dois campos para inserir o "URL de retorno de chamada" e o "Token de verificação".

No "URL de retorno de chamada" deverá colocar o link de integração da sua instância. Deverá ser algo como:

  • URL - https://gestor.dominio.ebsss.eu/api/chat/instagram_api

Deve também criar um "Token de verificação"* que vai ser colocado tanto nesse campo, como no painel de configuração da plataforma da sua instância.

  • *O Verify Token é um componente de segurança da sua app no Facebook. Funciona como uma chave secreta que garante que apenas o Facebook possa enviar requests para sua app, protegendo-a contra acessos não autorizados. É recomendável usar um UUID (Universally Unique Identifier) como "Verify Token. Pode gerar o seu UUID no seguinte website: https://www.uuidgenerator.net/version4

image-1711122367306.png

 

Clique em copy, para copiar o código e cole no campo de "Token de verificação".

Após preencher os dados, deverá ficar semelhante à imagem abaixo:

image-1711120863709.png

 

 

NÃO clique em "Verificar e salvar" ainda. 

 

 

Primeiro, terá de criar uma plataforma na sua instância com o "Token de Verificação", para que o Facebook possa fazer a verficação.

Para isso, vá até à página de criação de plataformas da sua intância. Pode chegar a essa página através do Módulo Chat (1) > Configurações (2) > Plataformas. Depois, clique em "Adicionar".

image-1711120888616.png

 

Ao fazer isso, irá abrir um painel. Clique em "Adicionar" (em baixo) e selecione "Messagens do Instagram".

image-1711120920825.png

 

Dê o nome à sua plataforma e coloque o mesmo token que criou anteriormente no campo "platforms.type.instagram.webhook-secret". Mantenha o módulo de configuração ativado e faça "Guardar".

 

image-1711122355547.png

 

Agora volte às configurações do Facebook e clique, então, em "Verificar e Salvar".

Se tudo estiver bem configurado será levado para a próxima página, onde poderá selecionar as subscrições que pretende.

Caso dê algum erro, veja o bloco abaixo.

 

ATENÇÃO: Se aparecer um erro semelhante ao abaixo, é possível que tenha algo mal nas configurações. 

image-1711122285462.png

Verifique se:
• ao criar a plataforma na sua instância, o switch do Modo Configuração está ativado
• o token que colocou em tanto neste no painel "Editar assinatura de Page" (no Meta) como no da criação da plataforma de chat da sua instância são idênticos
• no painel de criação de plataforma de chat na sua instância está no campo "platforms.type.instagram.webhook-secret"
• fez "Guardar" após terminar de configurar a plataforma de chat na sua instância

 

Caso as configurações estejam corretas, será levado para a página seguinte:

image-1711122711741.png

 

Aqui, procure por "messages" e clique em "Subscribe".

image-1711122732647.png

 

No menu lateral da esquerda, clique em "Painel"

image-1711122830770.png

 

Procuro pelo produto "Graph API do Instagram" e clique em configurar.

image-1711122871605.png

 

Será encaminhado para a página de configurações do Messenger. Caso não seja, clique à esquerda em Configurações da API da empresa.

image-1711123848288.png