Visão geral da plataforma do Messenger

A Visão geral da plataforma do Messenger contém informações sobre o funcionamento da plataforma e os componentes necessários para a implementação.

O Messenger from Meta é um serviço de mensagens que permite que a Página do Facebook ou a conta profissional do Instagram de uma empresa responda às pessoas interessadas nas suas redes sociais ou empresa. Essas conversas devem ser iniciadas pela pessoa.

O uso da plataforma do Messenger é gratuito.

Como funciona

A pessoa envia uma mensagem à Página comercial ou conta profissional do Instagram enquanto estiver conectada ao Facebook ou Instagram, ou via um plugin da Meta enquanto visita seu site ou app para dispositivos móveis. A Página comercial ou conta profissional do Instagram pode usar a plataforma do Messenger para enviar uma resposta automática, encaminhar a um agente ao vivo ou fazer uma combinação de ambos.

Fluxo de mensagens

Quando a pessoa envia uma mensagem à Página comercial ou conta profissional do Instagram, um webhook é acionado e notifica você sobre a mensagem recebida. Seu app pode, então, fazer chamadas ao gráfico social da Meta para obter a conversa, determinar a resposta apropriada e enviá-la à pessoa dentro de 24 horas. A plataforma permite que isso seja feito em escala e oferece diferentes pontos de entrada de conversa e tipos de mensagens.

Limitações

• Uma pessoa que entrou no Facebook não pode enviar mensagem para sua conta profissional do Instagram. Também não é possível enviar mensagens à Página comercial do Facebook nem à conta profissional do Instagram quando a pessoa tiver entrado no Instagram usando a plataforma do Messenger.
• As mensagens do Instagram estão disponíveis para todas as contas profissionais do Instagram de empresa ou criador de conteúdo.

O que você precisa

Para implementar a plataforma do Messenger, você precisará entender os componentes abaixo.

Tokens de acesso

Um token de acesso é uma string opaca que identifica um app, uma Página do Facebook ou uma pessoa e pode ser usado pelo app para fazer chamadas ao gráfico social da Meta com segurança. Ele fornece acesso temporário e seguro a pontos de extremidade específicos, permitindo que a Página comercial ou conta profissional do Instagram envie e receba mensagens. Saiba mais.

Acesso padrão e avançado

Existem dois níveis de acesso nos apps de Páginas comerciais ou contas profissionais do Instagram: padrão e avançado. O acesso padrão é fornecido quando você registra o app pela primeira vez na Meta. Com ele, é possível ver dados de pessoas com função (como desenvolvedor, testador ou administrador) no app ou na Página comercial/conta profissional do Instagram que tenha obtido o app. O acesso avançado permite que você acesse dados de pessoas que usam seu app e não têm função nele nem na Página comercial/conta profissional do Instagram que use o app. Saiba mais sobre Funções no app , Tipos de app e Níveis de acesso .

Devido ao escopo limitado do acesso padrão, talvez alguns recursos não funcionem corretamente até que o app receba acesso avançado. Isso pode limitar os apps de teste que você usa.

Análise do app

Conclua a análise do app caso ele precise de acesso avançado para obter dados de usuários sem função nele ou na Página comercial/conta profissional do Instagram que use o app. Saiba mais.

Se você está criando o app para enviar e receber mensagens da própria página, não será necessário passar pelo processo de análise. Se você planeja obter informações do perfil de usuário, será necessário passar pela análise do app para receber as permissões necessárias para acessar a API do Perfil do Usuário.

Verificação da empresa

Conclua a verificação da empresa se você pretende disponibilizar o app para usuários que não tenham função no app ou na empresa relacionada. Saiba mais.

URLs de rede de fornecimento de conteúdo

A plataforma do Messenger usa URLs de rede de fornecimento de conteúdo (CDN, pelas iniciais em inglês) para que você possa recuperar o conteúdo de mídia interativa compartilhado por usuários do Instagram. Por privacidade, a URL de CDN não retornará mídia quando o conteúdo tiver sido excluído ou tiver expirado.

Login do Facebook

Você precisa pedir permissão à pessoa para que sua Página ou conta profissional do Instagram envie mensagens a ela. Para isso, implemente o Login do Facebook. Saiba mais.

Página do Facebook

É necessária uma Página do Facebook para enviar e receber mensagens na plataforma do Messenger. Saiba mais.

Recursos

Protocolo de entrega

Se você gerenciar as conversas usando mais de um app (por exemplo, um para respostas automáticas e outro para agente humano), será necessário implementar o protocolo de entrega para transferir a conversa entre eles. Para responder a mensagens, o app precisa controlar a conversa. Com o protocolo de entrega, ele pode solicitar o controle a outro app quando necessário, aceitar o controle e fazer a liberação depois de enviar a resposta.

Alto volume de mensagens

Caso a Página ou conta profissional do Instagram envie ou receba alto volume de mensagens, a caixa de entrada não exibirá nem enviará novas mensagens até que o volume diminua.

Para mensagens do Messenger

Se uma Página enviar mais de 40 mensagens por segundo ou tiver um grande número de conversas ao mesmo tempo, as mensagens novas não serão exibidas na caixa de entrada da Página. Além disso, não será possível enviar mensagens até que o volume diminua.

Se o limite de volume for atingido, as chamadas de API para obter todas as conversas falharão. Mesmo assim, você poderá obter as mensagens de uma conversa específica.

Para mensagens do Instagram

Se uma conta profissional do Instagram enviar e receber mais de 72 mil mensagens, as mensagens novas não serão exibidas na caixa de entrada do Instagram. Além disso, não será possível enviar mensagens até que o volume diminua.

Os banners serão exibidos na conversa indicando que o limite foi atingido. Quando o volume diminuir, eles pararão de aparecer.

• Sua mensagem pode estar atrasada. A entrega da sua mensagem pode demorar mais tempo do que o normal, porque [nome-da-conta] está recebendo um grande número de mensagens.

• Sua mensagem não foi entregue. Suas mensagens não foram entregues, porque [nome-da-conta] está recebendo um grande número de mensagens. Tente novamente mais tarde.

Conta profissional do Instagram

Para enviar e receber mensagens no Instagram, você precisa ter uma conta profissional nessa rede. Dessa forma, seu app pode acessar dados dos pontos de extremidade do gráfico social da Meta usando a Página do Facebook associada a ele. Saiba mais.

IDs no escopo do Instagram

Quando alguém envia mensagens a uma conta profissional do Instagram, um ID no escopo do Instagram que representa essa pessoa no app é criado. Ele é específico para a pessoa e a conta com a qual ela está interagindo. Isso permite que a conta profissional identifique as interações com a mesma pessoa em diferentes apps de mensagens.

Registro na Meta

Para fazer chamadas ao gráfico social, é necessário fazer cadastro como desenvolvedor e registrar o app na Meta. Saiba mais.

IDs no escopo da Página

Quando alguém envia mensagens a uma Página do Facebook, um ID no escopo da Página que representa essa pessoa no app é criado. Ele é específico para a pessoa e a Página com a qual ela está interagindo. Isso permite que a Página identifique as interações com a mesma pessoa em diferentes apps de mensagens.

Tarefas da Página

A pessoa que solicita o token de acesso à Página deve ser capaz de executar MESSAGING para enviar mensagens e MODERATE para responder a comentários na Página do Facebook vinculada ao app de mensagens. Saiba mais.

Diretório de parceiros

Encontre um parceiro com experiência na plataforma do Messenger no nosso Diretório de Parceiros .

Permissões

Para as conversas do Messenger, o app precisará solicitar estas permissões via Login do Facebook:

• pages_show_list
• pages_manage_metadata
• pages_messaging
• pages_read_engagement
• business_management

Para mensagens no Instagram, é necessário solicitar o seguinte:

• instagram_basic
• instagram_manage_messages

Solicitar permissão business_management

Ao solicitar a permissão business_management, sinalize o seguinte ao apresentar a análise do seu app:

1. A permissão está sendo solicitada como dependência das permissões pages_messaging e pages_show_list.
2. Para mensagens do Instagram, sinalize que esta permissão está sendo solicitada como dependência da permissão instagram_manage_messages.
3. No screencast da análise do app, mostre claramente o administrador da Página navegando pelo fluxo de login do Facebook, selecionando as páginas ou os identificadores do Instagram e concedendo as permissões necessárias ao app.

No app, instrua o administrador da Página a conceder permissões para gerenciar seus ativos comerciais explicitamente ao app. Você terá que adicionar a permissão business_management dentro do contexto do fluxo do Login do Facebook para Empresas.

Políticas

Para obter e manter o acesso ao gráfico social da Meta, siga as Políticas da Plataforma do Messenger, os Termos da Plataforma da Meta e os Padrões da Comunidade. Saiba mais.

Requisitos de políticas para bots

Os países podem ter requisitos específicos para mensagens enviadas de Páginas comerciais ou contas profissionais do Instagram. Familiarize-se com essas políticas e outras políticas da plataforma .

Limitação de volume

Webhooks

Com os Webhooks, é possível receber notificações em tempo real sobre as mensagens enviadas para sua Página comercial ou conta profissional do Instagram sem precisar fazer chamadas para o gráfico social da Meta (o que poderia ocasionar limitações de volume). Para receber essas notificações e evitar limites de volume, você precisa configurar os Webhooks.

Próximas etapas

• Webhooks da Meta para a plataforma do Messenger – Saiba como receber notificações HTTP em tempo real sobre mensagens enviadas e recebidas pelo app.

Saiba mais

Vídeos para desenvolvedores sobre o Messenger – Tenha acesso a tutoriais, boas práticas, eventos gravados e muito mais.