Notificação única (beta)

Resumo

Com a API de Notificação Única da plataforma do Messenger (beta), a página pode solicitar a permissão de um usuário para enviar uma mensagem de acompanhamento após o encerramento da janela de mensagens de 24 horas. O usuário poderá optar por receber uma notificação futura. Assim que o usuário solicitar uma notificação, a página receberá um token equivalente a uma permissão para enviar uma mensagem única ao solicitante. O token só pode ser usado uma vez e expirará um ano após a criação.

Permissões

As páginas que quiserem usar essa API precisarão se inscrever para obter a permissão "Notificação única" na seção "Mensagens avançadas" das configurações da página. A página precisará concordar com os termos da versão beta e receberá a permissão se atender aos nossos critérios.

Conteúdo

• Uso
• Como enviar uma solicitação de notificação única
• Como enviar uma mensagem de acompanhamento
• Eventos de webhook
• Restrições e limitações

Uso

• Não confunda, engane, defraude, iluda, surpreenda nem envie spam para as pessoas. Confirme que há um relacionamento claro e óbvio entre o aviso e o conteúdo da mensagem. O conteúdo da solicitação de notificação única e da mensagem devem seguir os Padrões da Comunidade.
• Perderão o acesso à API as Páginas que receberem um alto volume de feedback negativo ou que confundirem, enganarem, fraudarem, iludirem ou surpreenderem negativamente os usuários.

Como enviar uma solicitação de notificação única

Com a Send API, a Página pode enviar uma mensagem de solicitação de notificação como modelo. O tipo de modelo deve ser one_time_notif_req. O corpo da solicitação segue um formato padrão para todos os tipos de modelo, com a propriedade message.attachment.payload contendo o tipo e os detalhes do conteúdo específicos de cada tipo de modelo. É possível personalizar apenas o título e a carga da solicitação. O limite do campo title é 65 caracteres.

{
  "recipient": {
    "id":"

O modelo da solicitação de notificação única será renderizado. Depois disso, assim que o usuário clicar no botão Notificar-me, um webhook message_optins será entregue no seu back-end. O one_time_notif_token pode ser usado para enviar uma mensagem de acompanhamento única ao usuário fora do período de 24 horas.

Como enviar uma mensagem de acompanhamento

Para enviar uma mensagem de acompanhamento, encaminhe uma solicitação POST à Send API, com o one_time_notif_token obtido via webhook e o message.text definido no corpo da solicitação.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "one_time_notif_token":"<ONE_TIME_TOKEN>"
  },
  "message": {
    "text":"<MESSAGE_CONTENT>"
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Para enviar uma mensagem avançada, substitua o texto pelo conteúdo desejado. Consulte a documentação de referência da Send API para ver a lista completa de tipos de mensagem compatíveis. O one_time_notif_token pode ser usado apenas uma vez e será invalidado assim que a mensagem for enviada.

Eventos de webhook

Quando o usuário aceitar ser notificado sobre uma atualização específica, você receberá um evento de webhook com a payload e o one_time_notif_token. Armazene a carga e o token para enviar uma mensagem de acompanhamento quando as informações estiverem disponíveis. Não há uma API específica para consultar uma lista de one_time_notif_token. Por isso, é importante que você processe e armazene as informações do webhook conforme elas forem recebidas. Cada token pode ser usado apenas uma vez e expirará dentro de um ano após a criação.

{
   "sender": {
     "id":"<PSID>"
   },
   "recipient": {
     "id":"<PAGE_ID>"
   },
   "timestamp":1458692752478,
   "optin": {
     "type": "one_time_notif_req",
     "payload": "<USER_DEFINED_PAYLOAD>",
     "one_time_notif_token":"<ONE_TIME_TOKEN>",
   }
}

Restrições e limitações

• Não use o campo de carga para enviar senhas, credenciais e informações de identificação pessoal dos usuários (por exemplo, informações como nome ou endereço de email, que podem ser usadas para entrar em contato com uma pessoa ou identificá-la) nem outras informações sensíveis (como dados financeiros, de saúde, pagamento ou cartão de crédito ou outras categorias de informações consideradas confidenciais de acordo com as leis aplicáveis).
• O número de solicitações de notificação única está sujeito a um limite de volume para evitar a criação de uma experiência ruim para o usuário.

Perguntas frequentes

Encontre mais informações na página de perguntas frequentes.