Perguntas frequentes

Os apps são instalados a partir do site do app usando o Login do Facebook e concedendo a permissão pages_messaging a uma Página específica. Os apps autorizados serão exibidos nas Configurações da Página em Mensagens avançadas.

Sim, um único aplicativo do Facebook pode se inscrever em várias páginas. Depois que o aplicativo é analisado, como a permissão pages_messaging, o aplicativo pode se inscrever para receber webhooks em mais de uma página. Você é responsável por obter o contexto de cada webhook com base na carga.

Sim, mais de um app pode assinar uma Página. Quando vários apps são responsáveis pela mesma conversa, a melhor opção é usar o protocolo de entrega para administrar qual deles será o responsável por ela.

Para ler as perguntas frequentes sobre o RGPD e a Plataforma do Messenger, visite Plataforma do Messenger e o Regulamento Geral sobre a Proteção de Dados.

Ao usar o Plugin “Enviar para o Messenger”, o parâmetro data-ref pode ser usado por você como um parâmetro de passagem para enviar qualquer informação sobre o contexto do clique.

As pessoas também podem descobrir sua página por meio da pesquisa no Messenger. Nesses casos, você não terá um parâmetro de passagem. É possível usar o recurso de link da conta para associar um tópico a uma conta de usuário no seu site.

Quando um aplicativo está no modo de desenvolvimento apenas os administradores, os desenvolvedores e os testadores do aplicativo podem visualizar o plugin. Depois que o aplicativo for revisado e aprovado, você o disponibilizará para o público na guia Análise do aplicativo no Painel de Aplicativos.

No. Unlike subscriptions where a business can send multiple messages to people on a recurring basis, the one-time notification API limits the business to a single message per user request. If the person engages with the message, the standard messaging window will reopen.

Yes. Pages interested in using the One-time Notification API need to apply for permission. Go to the Advanced Messaging section of your Page Settings and consent to the terms. A Page will be granted permission if the Page meets our criteria.

Common uses of the API include various promotional and non-promotional use cases where the User explicitly requested a follow-up. Examples include:

• Back in stock alerts
• Collection launches
• Concert tickets going on sale
• Price drop alerts
• Train tickets available for purchase
• CSAT surveys

Your Page is not allowed to send a notification on a topic for which the User has not agreed to receive a notification. Please see the Usage and Restrictions and Limitations sections of the One-time Notification guide for more information.

A Page can send multiple requests however, the 24-hour policy will be applied to all the requests being sent. We also have controls in place to prevent spamming users with multiple requests.

The 24 hour standard messaging window will open only if the user interacts with the opt-in message. The behavior is consistent with interactions with other elements in the Messenger experience.

Pages will need to subscribe to message_optins webhook to receive notifications about User consent.

Once a person asks to be notified, the Page will receive a token which is equivalent to a permission to send a single message to the person. The token can be used to send a message to the person outside the 24 hour window. The token can only be used once and unused tokens will expire within 1 year of creation.

Yes. However, while it is possible to send another notification request using an existing token, there is no clear benefit for the business to send these type of requests.

Token is for one-time use only. Once a token is used it can not be used again.

No. The API does not return tokens available to a Page.

Page level. Permissions for the One-time Notification API are given at the Page level.

No. The app does not need to specify any message tags when sending a message outside the 24-hour standard messaging window using this API.

Há várias razões pelas quais isso pode acontecer:

• Você está usando uma identificação do Login do Facebook As identificações de usuário do Login do Facebook não são destinadas a funcionar com a API de Envio/Recebimento. Somente as identificações de usuário obtidas por meio da autenticação com a Plataforma do Messenger funcionarão com a Plataforma do Messenger.
• Você está usando uma identificação com um token de acesso da Página incorreto. As identificações de usuário da Plataforma do Messenger serão inseridas no escopo de uma página e, portanto, são específicas da página. Se você usar uma identificação de usuário válida com um token de acesso da Página associado a uma página diferente, a chamada não funcionará. Certifique-se de usar a identificação de usuário e o token de acesso da Página associado à mesma página.
• Você está enviando para um número de telefone que não foi verificado recentemente. Ao usar a API de Envio com um número de telefone, só enviaremos mensagens se o número de telefone tiver sido verificado recentemente. Mesmo se o número de telefone for mostrado como verificado, mas não tiver sido verificado recentemente, o envio poderá falhar. Verifique novamente o seu número de telefone e aguarde 24 horas até tentar novamente.

Aqui está uma solução alternativa para usar um usuário de teste de plataforma para sua integração de plataforma de mensagens:

1. Na página Funções do seu aplicativo, crie um novo usuário de teste clicando no botão Adicionar.
2. Alterne a opção Autorizar usuários de teste para este aplicativo? e conceda as permissões "manage_pages" e "page_messaging".
3. Use o botão Editar e obtenha um token de acesso para este usuário (usando v2.6). Salve isto para mais tarde.
4. Utilize o botão Editar para entrar como usuário de teste.
5. Quando estiver conectado, crie uma página como usuário de teste.
6. Use o token de acesso de usuário para o usuário de teste para obter o token de acesso da Página deste usuário. Você pode fazer isso com a seguinte chamada:

   https://graph.facebook.com/v2.6/me/accounts?access_token=[TEST_USER_ACCESS_TOKEN]

   (Documentação)
7. Use este token de acesso da Página para vincular seu Aplicativo do Facebook à sua Página:

   https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[TEST_USER_PAGE_ACCESS_TOKEN]
           

   (Documentação)
8. Depois de ter seguido estas etapas, você receberá atualizações RTU para sua Página de teste e poderá enviar mensagem ao seu Usuário de teste por meio da Página de teste. Além disso, é possível substituir seu token de acesso por um token de longa duração se eles estiverem expirando muito rápido para seus testes. Siga a documentação aqui:

   GET /oauth/access_token?  
       grant_type=fb_exchange_token&           
       client_id={app-id}&
       client_secret={app-secret}&
       fb_exchange_token={short-lived-token} 
           

Sim. O bot pode incluir os dois tipos de mensagem. O usuário deve acionar o sistema de mensagens padrão da plataforma por meio de um dos gatilhos qualificados e optar por receber mensagens por assinatura.

Tecnicamente, os bots não conseguem enviar mensagens aos usuários mais de uma vez, após o período de 24 horas; portanto, as mensagens não serão enviadas. Permitiremos essas mensagens durante o período de transição para os bots existentes, mas sinalizaremos elas quando as encontrarmos.

Não, a Plataforma do Messenger não oferece uma API que retorna uma lista de PSIDs de todas as pessoas que optaram por receber mensagens de seu bot.

Há 2 etapas para receber retornos de chamada. Primeiro, certifique-se de que seu webhook está configurado corretamente (https://developers.facebook.com/docs/messenger-platform/webhook-reference#setup). Existe um indicador quando os webhooks estão configurados corretamente.

Em segundo lugar, você deve se inscrever em cada página. Todas as páginas inscritas serão listadas.

Se as chamadas para o seu webhook falharem por um período de tempo prolongado, o seu aplicativo terá a inscrição cancelada e você terá de voltar a adicionar o webhook e inscrever a sua página novamente.

As chamadas para o webhook contêm um campo no cabeçalho denominado Assinatura-Central-X, que pode ser usado para validar se a chamada veio do Facebook.

Verifique se o webhook está respondendo com um código de status de 200. Isso nos comunica que o webhook foi recebido com sucesso. Se você não retornar o código 200, vamos repetir a chamada até que seja concluída com êxito. Além disso, se um webhook não retornar o código 200 por um longo período de tempo, iremos apresentar alertas de desenvolvedores.

Observe que um código de status bem-sucedido é retornado em tempo hábil. Uma chamada webhook com tempo limite após 20 segundos. Projete o seu código para que os webhooks sejam processados ​​de forma assíncrona para que um código de status bem-sucedido possa ser retornado imediatamente e processado separadamente.

Há uma ferramenta que exibe os erros recentes dos Webhooks. Se os recursos apresentarem falhas na entrega, os servidores do Facebook cancelarão a assinatura da sua URL. Para encontrar a ferramenta, acesse Painel de Aplicativos > Messenger > Configurações. Depois, clique no botão Exibir erros recentes, que aparece no cartão “Webhooks”.