Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.
Aggiornamento inglese: 1 lug 2022

Utilizzo dei link ig.me

ig.me è un servizio di URL abbreviati gestito da Meta che reindirizza gli utenti a una conversazione su Instagram. Puoi usare questi link nel tuo sito web, nelle newsletter inviate tramite e-mail e per molti altri scopi.

Quando un utente usa un link ig.me per avviare o continuare una conversazione con il tuo account Instagram, l'utente viene reindirizzato a una conversazione nuova o esistente, in base alla presenza o meno di messaggi precedenti inviati al tuo account Instagram.

Contenuti

Formato dei link

I link hanno il formato seguente:

https://ig.me/m/

USERNAME corrisponde al nome utente IG dell'account Instagram.

Parametri di reindirizzamento

Con questi link è possibile passare un parametro di reindirizzamento.

I parametri di reindirizzamento possono essere utilizzati per i seguenti scopi:

  • Monitoraggio dei diversi link in vari canali
  • Associazione di un utente Instagram a una sessione o a un account in un'app esterna
  • Indirizzamento di un determinato utente a funzioni o contenuti specifici disponibili nell'account Instagram

Questo è un link ig.me con un parametro aggiunto:

https://ig.me/m/

REF_PARAM viene passato al server tramite un webhook.

Requisiti

Per un utilizzo corretto dei link ig.me, è necessario soddisfare i seguenti requisiti:

  • Nella tua esperienza su Instagram, i rompighiaccio devono essere impostati in modo da ricevere il parametro di reindirizzamento per nuove conversazioni.
  • Il parametro di reindirizzamento deve essere una stringa lunga al massimo 2083 caratteri.
  • L'account Instagram a cui l'app è collegata deve essere pubblicata per poter ricevere il parametro di reindirizzamento per tutti gli utenti, tranne quelli con il ruolo di sviluppatore, tester o amministratore per il tuo bot.
  • Disponi delle versioni per iOS e Android 235 e successive.

Lettura del parametro passato

La parte relativa al reindirizzamento presenta sempre il seguente formato:

"referral": {
     "ref": "ref_data_in_ig_dot_me_param"
     "source": "SHORTLINKS"
     "type":  "OPEN_THREAD"
}
Valore del campo Descrizione

ref

I dati arbitrari originariamente passati nel parametro ref aggiunto al link ig.me. Sono consentiti solo caratteri alfanumerici e i caratteri -, _, =.

source

L'origine del reindirizzamento. Il valore dell'origine per i link ig.me è “SHORTLINK”.

type

L'identificativo per il reindirizzamento. Per i reindirizzamenti provenienti da link ig.me è sempre "OPEN_THREAD".

Quando un link ig.me con un parametro ref apre l'app Instagram, esistono tre possibili scenari:

1. Nuova conversazione + rompighiaccio

Se per il tuo account Instagram hai configurato i rompighiaccio e l'utente ne tocca uno, l'app riceve l'evento del webhook messaging_postback che include il parametro di reindirizzamento passato.

Il formato dell'evento del webhook messaging_postback è il seguente:

{
  "object": "instagram",
  "entry": [
    {
      "id": "

USER_DEFINED_PAYLOAD si riferisce al payload precedentemente configurato per essere inviato nel postback.

2. Nuova conversazione + invio del messaggio

Se per il tuo account Instagram hai configurato i rompighiaccio e l'utente invece di toccarne uno sceglie di inviare un messaggio usando lo strumento di composizione, l'app riceve l'evento del webhook messages che include il parametro di reindirizzamento passato.

Il formato dell'evento webhook messages è il seguente:

{
  "object": "instagram",
  "entry": [
    {
      "id": "

3. Conversazione esistente

Se l'utente ha già avviato una conversazione con il tuo account Instagram Business, quando utilizza il link ig.me si apre tale conversazione. Per ricevere una notifica del reindirizzamento, per il webhook deve essere attivata l'iscrizione all'evento messaging_referral.

Questa azione reimposta la finestra di 24 ore per i messaggi standard, consentendo all'app di rispondere dopo aver ottenuto l'evento del webhook con il parametro ref.

Il formato dell'evento del webhook messaging_referral è il seguente:

{
  "object": "instagram",
  "entry": [
    {
      "id": "

Esempi

Ecco alcune modalità di utilizzo dei link ig.me:

  1. Usa i link ig.me + codice QR sulla confezione del prodotto per consentire alle persone di contattarti per ricevere assistenza oppure ottenere un coupon per il prossimo acquisto.
  2. Usa i link ig.me + codice QR su materiali pubblicitari esterni come manifesti, inserzioni TV, punti vendita fisici per favorire l'iscrizione ad account fedeltà/di membri.
  3. Usa i link ig.me sulla pagina dei contatti di un sito web per consentire alle persone di contattarti tramite messaggi anziché telefonarti.
  4. Offri a chi ti chiama l'opzione di inviarti un messaggio su Instagram utilizzando un link ig.me con il parametro di reindirizzamento inviato tramite SMS.

Esperienza utente

Nuove conversazioniConversazioni esistenti

L'utente visualizza la seguente notifica:

Hai aperto questa conversazione da un link. <Ig Business Handle> vedrà che hai usato il suo link non appena invierai un messaggio.

L'utente visualizza la seguente notifica:

Hai aperto questa conversazione da un link. <Ig Business Handle> può vedere che hai usato il suo link. Se desideri interrompere la ricezione dei relativi messaggi, puoi disattivare i messaggi.

Limitazioni

Al momento, i link ig.me non sono supportati su Instagram Web.