Link m.me

Questo documento mostra come creare link m.me per la tua esperienza su Messenger.

m.me è un servizio di URL offerto da Meta che reindirizza le persone a una persona, una pagina o una conversazione su Messenger. Puoi usare questi link nel tuo sito web, nelle newsletter inviate tramite e-mail e per molti altri scopi.

Come funziona

Il formato per un link m.me è il seguente, dove PAGE-NAME è la Pagina Facebook collegata alla tua app di messaggistica.

Quando una persona clicca su un link m.me, sarà reindirizzata a una nuova conversazione con la tua azienda o a una conversazione esistente se ha inviato un messaggio all'azienda in passato. Nella conversazione apparirà il messaggio predefinito: "Hai iniziato a partecipare a questa conversazione tramite un link. Abbiamo comunicato a PAGE-NAME che sei qui".

Puoi aggiungere il parametro text per includere anche un messaggio personalizzato.

Le aziende possono condividere link che reindirizzano a siti web o altre conversazioni, alcuni dei quali potrebbero includere testo precompilato.

Quando una persona clicca sul pulsante Inizia per avviare una conversazione con l'azienda, viene inviata una notifica webhook messaging_postbacks al tuo server webhook. Come parte di questa notifica webhook, l'oggetto postback conterrà un oggetto referral con il parametro ref.

Quando una persona clicca su un link m.me ed esiste già una conversazione tra l'azienda e quella persona, il link la reindirizzerà alla conversazione esistente. Questa azione reimposterà la finestra dei messaggi standard di 24 ore, consentendo alla tua app di messaggistica di rispondere alla persona e inviando una notifica webhook messaging_referrals al tuo server webhook. Come parte di questa notifica webhook, verrà incluso un parametro ref dal link m.me.

Parametri di reindirizzamento

Un link m.me può contenere un parametro ref che, quando una persona clicca sul link, fornisce alla tua azienda maggiore contesto relativo alla conversazione, come un link sul tuo sito web rispetto a un link in un punto vendita. Questi tipi di link possono anche reindirizzare la persona a un contenuto specifico o a funzioni disponibili all'interno dell'esperienza su Messenger.

Codici QR

I link m.me con i parametri ref possono essere incorporati nei codici QR. I codici QR compatibili possono essere scansionati con la fotocamera nativa del cellulare. Dopo la scansione, si apriranno l'app Messenger e la conversazione con l'azienda.

Esempio di codice QR Il seguente esempio di codice QR è associato all'URL http://m.me/OriginalCoastClothing?ref=summer_coupon, che attiverà un flusso di esempio su un coupon di sconto su Messenger.

Notifica webhook

Quando ricevi una notifica webhook, questa conterrà informazioni relative a una persona che ha avviato una conversazione con la tua azienda o che ha già una conversazione in essere con la tua azienda.

Avviare una conversazione

Quando una persona clicca sul pulsante Inizia per avviare una conversazione con l'azienda, ti inviamo una notifica webhook messaging_postbacks contenente il parametro ref.

{
  "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",
    }
  }
}

Continuare una conversazione esistente

Se esiste già una conversazione tra la tua azienda e la persona che ha cliccato sul link m.me, viene inviata una notifica webhook messaging_referrals.

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

Prima di iniziare

Ecco cosa ti servirà:

• Accesso avanzato per l'app collegata alla Pagina Facebook della tua azienda
• Un pulsante Inizia per l'esperienza su Messenger per nuove conversazioni
• L'app collegata alla Pagina Facebook dell'azienda deve aver attivato l'iscrizione per i campi dei webhook messaging_postbacks e messaging_referrals

Limitazioni

• Le app con accesso standard possono ottenere informazioni solo dalle persone con ruolo sviluppatore, tester o amministratore sulla tua app di messaggistica

Richieste di iscrizione ai messaggi di marketing

L'URL m.me/rn ti consente di creare una richiesta di iscrizione alle notifiche ricorrenti con un link m.me. Il formato per un link m.me/rn deve includere l'argomento per la notifica ricorrente. Puoi impostare la frequenza per la notifica ricorrente, altrimenti l'impostazione predefinita sarà giornaliera.

Limitazioni

• La versione 383 di iOS è necessaria affinché i link m.me/rn funzionino correttamente. La persona che ha cliccato sul link verrà reindirizzata all'URL m.me di base, URL http://m.me/PAGE-NAME

Link di esempio di messaggi di marketing

Registrazione dell'argomento

Prima di poter utilizzare l'URL m.me/rn con un nuovo argomento, devi registrare il nuovo argomento.

Se utilizzi un argomento che hai usato in un URL m.me/rn precedente e le persone hanno attivato la ricezione di notifiche ricorrenti, non devi registrare nuovamente l'argomento.

Puoi registrare un nuovo argomento seguendo questi passaggi:

Passaggio 1. Inviati una richiesta di iscrizione alle notifiche ricorrenti con l'argomento a una persona che dispone di un ruolo nella tua app. Ti consigliamo di aggiungere il payload per indicare che si tratta di registrare l'argomento.

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"

In caso di azione eseguita correttamente, l'app riceve la seguente risposta JSON:

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

Passaggio 2. Assicurati di cliccare sul pulsante di iscrizione nella conversazione. Ti invieremo una notifica webhook optin. Ora il tuo argomento è stato registrato ed è pronto per l'uso pubblico.

Esempio di richiesta

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 l'azione viene eseguita correttamente, l'app riceve la seguente risposta JSON:

{ "success": true }

Notifica webhook messaging_optins

Quando ricevi una notifica webhook, questa conterrà informazioni relative a una persona che ha avviato una conversazione con la tua azienda o che ha già una conversazione in essere con la tua azienda.

{
  "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"
    }
}

Riferimento m.me

Passaggi successivi

• Invio di una risposta
• Invio di una notifica ricorrente

Altri contenuti da consultare

• Consulta la pagina sui parametri di reindirizzamento nella guida di esempio su Original Coast Clothing.
• Consulta il riferimento messaging_optins.
• Per maggiori informazioni sui campi del webhook messaging_postbacks, consulta il relativo riferimento.
• Per maggiori informazioni sui campi del webhook messaging_referrals, consulta il relativo riferimento.