Links m.me

Este documento mostra como criar links m.me para sua experiência do Messenger.

m.me é um serviço de URL oferecido pela Meta que redireciona para uma pessoa, página ou conversa no Messenger. Você pode usar esses links no seu site, em boletins informativos por email e muito mais.

Como funciona

Veja a seguir o formato de um link m.me, em que PAGE-NAME é a Página do Facebook vinculada ao seu app de mensagens.

Ao clicar em um link m.me, a pessoa será redirecionada para uma conversa nova ou existente, dependendo se ela já enviou mensagem à empresa ou não. Uma mensagem-padrão será exibida na conversa, informando: "Você entrou nessa conversa seguindo um link. Avisamos PAGE-NAME que você está aqui."

Você pode adicionar o parâmetro text para incluir uma mensagem personalizada também.

As empresas podem compartilhar links com redirecionamento para sites ou outras conversas, algumas das quais podem incluir texto preenchido automaticamente.

Quando uma pessoa clicar no botão Começar para iniciar uma conversa com a empresa, uma notificação de webhook messaging_postbacks será enviada ao seu servidor de webhooks. Como parte dessa notificação de webhook, o objeto postback conterá um objeto referral com o parâmetro ref.

Se já tiver uma conversa existente com a empresa, a pessoa será direcionada a essa conversa ao clicar em um link m.me. Essa ação redefine a janela-padrão de mensagens de 24h, permitindo que seu app de mensagens responda à pessoa. Além disso, uma notificação de webhook messaging_referrals será enviada ao seu servidor de webhooks. Como parte dessa notificação de webhook, será incluído um parâmetro ref do link m.me.

Parâmetros de referência

Um link m.me pode conter um parâmetro ref que, quando uma pessoa clica no link, fornece à empresa mais contexto sobre a conversa, como um link no seu site em comparação a um link em uma loja. Esses tipos de links também podem direcionar a pessoa a um conteúdo específico ou recurso disponível na sua experiência do Messenger.

QR codes

Os links m.me com parâmetros ref podem ser incorporados em códigos QR. Os códigos compatíveis com QR podem ser lidos pela câmera nativa de um smartphone. Ao serem lidos, eles abrem o app Messenger e a conversa por mensagem com a empresa.

Exemplo de QR code O QR code de exemplo tem http://m.me/OriginalCoastClothing?ref=summer_coupon codificado que dispara um fluxo ilustrativo sobre um cupom de desconto no Messenger.

Notificação de webhook

Quando você recebe uma notificação de webhook, ela contém informações de uma pessoa que está iniciando ou que já tem uma conversa com a empresa.

Iniciar uma conversa

Quando uma pessoa clicar no botão "Começar" para iniciar uma conversa com sua empresa, entregaremos o parâmetro ref como parte da notificação de webhook messaging_postbacks.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "postback":{
    "payload":"POSTBACK-PAYLOAD-YOU-CONFIGURED",
    "referral": {
      "ref": "REF-PARAMETER-INFORMATION",
      "source": "SHORTLINK",
      "type": "OPEN_THREAD",
    }
  }
}

Continuar em uma conversa existente

Se já existir uma conversa entre a empresa e a pessoa que clicou no link m.me, a notificação de webhook messaging_referrals será enviada.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "referral": {
    "ref": "REF-PARAMETER-INFORMATION",
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}

Antes de começar

Você precisará do seguinte:

• Acesso avançado para o app vinculado à Página do Facebook da sua empresa
• Um botão Começar para sua experiência do Messenger com novas conversas
• O app vinculado à Página do Facebook da empresa precisa estar inscrito nos campos de webhooks messaging_postbacks e messaging_referrals

Limitações

• Os apps com acesso padrão só podem obter informações de pessoas que tenham função de desenvolvedor, testador ou administrador no seu app de mensagens.

Solicitações de aceitação de mensagens de marketing

A URL m.me/rn possibilita que você crie uma solicitação de permissão de notificação recorrente com um link m.me. O formato de um link m.me/rn precisa incluir o tópico da notificação recorrente. É possível definir a frequência das notificações recorrentes; caso contrário, ela será padronizada como diária.

Limitações

• É necessário usar a versão 383 do iOS para que os links m.me/rn funcionem corretamente. A pessoa que clicar no link será redirecionada para sua URL de base m.me: http://m.me/PAGE-NAME.

Link de exemplo de mensagens de marketing

Registrar o tópico

Antes de você usar m.me/rn com um novo tópico, é preciso registrá-lo.

Caso você esteja utilizando um tópico já usado em uma URL m.me/rn anterior, e as pessoas tiverem aceitado receber notificações recorrentes, não será necessário registrar o tópico novamente.

É possível registrar um novo tópico seguindo estas etapas:

Etapa 1. Envie uma solicitação para aceitação de notificações recorrentes com o tópico para uma pessoa que tem uma função no app. Recomendamos adicionar a carga para indicar que o objetivo é registrar o tópico.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
          "title":"TITLE",
          "payload": "Registering a new topic: TOPIC-NAME",
          "notification_messages_frequency": MESSAGE-FREQUENCY,
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Se o processo for bem-sucedido, o app receberá a seguinte resposta JSON:

{ 
        "recipient": {
          "id":"PSID",
          "message_id":"MESSAGE-ID",
}

Etapa 2. Clique no botão de aceitar na conversa. Enviaremos uma notificação webhook sobre a aceitação. Com isso, o tópico estará registrado e pronto para uso público.

Exemplo de solicitação

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

Se o processo for bem-sucedido, o app receberá a seguinte resposta JSON:

{ "success": true }

Notificação de Webhook messaging_optins

Quando você recebe uma notificação de webhook, ela contém informações de uma pessoa que está iniciando ou que já tem uma conversa com a empresa.

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
    "title": "TITLE-FOR-NOTIFICATION-MESSAGE",
    "ref": "REF-PARAMETER-INFORMATION",
    "payload": "",
    "source":"SHORTLINK"
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
    "notification_messages_topic": "RECURRING-NOTIFICATION-TOPIC", 
    "notification_messages_frequency": "MESSAGE-FREQUENCY",
    "notification_messages_timezone": "TIMEZONE-ID",
    "token_expiry_timestamp": "TIMESTAMP",
    "user_token_status": "TOKEN-STATUS"
    }
}

Referência de m.me

Próximas etapas

• Enviar uma resposta
• Enviar uma notificação recorrente

Veja também

• Consulte a página sobre parâmetros de referência no guia de exemplo de experiência com a Original Coast Clothing.
• Consulte a referência sobre messaging_optins.
• Consulte a referência sobre messaging_postbacks para mais informações sobre esses campos de webhook.
• messaging_referrals Acesse esta referência para mais informações sobre esses campos de webhook.