Invio di un messaggio

Per inviare messaggi a una persona su Messenger o Instagram, la conversazione deve essere avviata da quella persona. Dalla Piattaforma Messenger è possibile inviare diversi tipi di messaggi. Le normative e le linee guida relative ai tipi di contenuto e alle condizioni di invio variano per ogni tipo di messaggio.

Componenti del messaggio

Tutte le richieste dell'API Send trasmesse dall'app per inviare un messaggio devono includere i seguenti elementi:

• L'ID della Pagina Facebook o della Pagina Facebook collegata all'account Instagram per professionisti da cui viene inviato il messaggio
• L'ID della persona che riceve il messaggio
• Un token d'accesso della Pagina richiesto dalla Pagina che invia il messaggio
• L'autorizzazione del destinatario del messaggio
• Il tipo di messaggio
• Il contenuto del messaggio

Per maggiori informazioni sui componenti del messaggio, consulta il riferimento per l'API Send.

Finestra dei messaggi standard

La finestra dei messaggi standard è il periodo di 24 ore entro il quale è consentito l'invio di un messaggio a una persona. Quando una persona invia un messaggio alla tua Pagina o al tuo account Instagram per professionisti oppure avvia una conversazione tramite un plug-in web, l'app può inviare un messaggio entro 24 ore.

I messaggi inviati entro la finestra di 24 ore potrebbero contenere contenuti promozionali.

Azioni dell'utente che causano l'apertura della finestra dei messaggi standard

Le seguenti azioni dell'utente causano l'apertura della finestra dei messaggi standard di 24 ore:

• Una persona invia un messaggio alla tua Pagina o al tuo account Instagram per professionisti
• Una persona clicca su un pulsante di call to action, come Inizia, all'interno di una conversazione
• Una persona clicca su un'inserzione che rimanda a Messenger, quindi invia un messaggio alla tua Pagina o al tuo account Instagram per professionisti
• Una persona invia un messaggio a una Pagina tramite un plug-in, come il plug-in Invia a Messenger oppure il plug-in della casella di spunta
• Una persona clicca su un link m.me che la rimanda a una conversazione esistente tra quella persona e la Pagina
• Una persona clicca su un link ig.me che la rimanda a una conversazione esistente tra quella persona e l'account Instagram per professionisti
• Una persona reagisce a un messaggio, come un messaggio di marketing
• Una persona commenta un post sulla tua Pagina o sul tuo account Instagram per professionisti
• Una persona pubblica un post come visitatore sulla tua Pagina

Sappiamo che gli utenti si aspettano una risposta tempestiva, quindi ti invitiamo vivamente a rispondere il prima possibile, entro la finestra di 24 ore. Le persone possono bloccare o silenziare una conversazione in qualsiasi momento.

ID destinatari

L'ID della persona destinataria del messaggio è impostato nel parametro oggetto recipient. Può trattarsi di uno dei seguenti tipi di ID:

• ID della singola Pagina (PSID): ID assegnato a una persona la prima volta che invia un messaggio alla Pagina. Questo ID unico rappresenta le interazioni tra la Pagina e quella persona.

• Riferimento utente: un ID assegnato a una persona che ha usato un plug-in o un pulsante di postback per inviare un messaggio alla Pagina.

• ID del post o del commento: un ID assegnato a una persona che ha pubblicato un post sulla tua Pagina o ha commentato un post. Viene usato per inviare una risposta privata a quella persona.

Gli ID utente dalle integrazioni Facebook Login sono per singola app e non funzionano con la Piattaforma Messenger.

Tipi di messaggi

Il tipo di messaggio che invii è impostato nel parametro messaging_type. Questo parametro è un modo più esplicito per assicurarsi che i messaggi siano conformi alle normative in materia e che rispettino le preferenze del destinatario.

Sono supportati i seguenti tipi di messaggi:

• Risposta: il messaggio viene inviato in risposta a un messaggio ricevuto. Il messaggio può includere contenuti promozionali e non promozionali e deve essere inviato durante la finestra dei messaggi standard.

• Aggiornamenti: il messaggio che stai inviando viene inviato in modo proattivo e non in risposta a un messaggio ricevuto. Il messaggio può includere contenuti promozionali e non promozionali e deve essere inviato durante la finestra dei messaggi standard.

• Messaggio con tag: il messaggio che stai inviando viene inviato al di fuori della finestra dei messaggi standard. Il messaggio deve includere un tag corrispondente al caso di utilizzo consentito per il tag e includere contenuti non promozionali.

Tag dei messaggi

I tag dei messaggi consentono di inviare un messaggio al di fuori della finestra dei messaggi standard. Questi messaggi sono aggiornamenti di rilevanza personale per una persona. Ad esempio, puoi inviare aggiornamenti su spedizione e consegna, su una prenotazione o su un volo in programma oppure avvisi sull'account di un cliente. Per i flussi di messaggistica che richiedono un percorso di escalation, il tag Human Agent consente a un rappresentante aziendale di rispondere manualmente ai messaggi di una persona entro un periodo di 7 giorni.

I tag dei messaggi non possono essere utilizzati per inviare contenuti promozionali, compresi, a titolo esemplificativo ma non esaustivo, promozioni, offerte, coupon e sconti. L'uso dei tag dei messaggi al di fuori dei casi d'uso approvati potrebbe comportare l'applicazione di restrizioni alla capacità della Pagina o dell'account Instagram di inviare messaggi. Per i dettagli, consulta la Normativa della Piattaforma Messenger e dell'API Instagram Messaging.

Le aziende che usano la Piattaforma Messenger e vogliono inviare messaggi promozionali al di fuori della finestra standard di 24 ore devono usare i messaggi sponsorizzati o le notifiche una tantum.

Tipi di contenuto

Il messaggio inviato può includere i seguenti tipi di contenuti:

Invio di un messaggio di testo di base

Per inviare un messaggio di testo di base a una persona che ha inviato un messaggio alla tua Pagina, invia una richiesta POST all'endpoint /PAGE-ID/messages impostando l'id della chiave letterale dell'oggetto recipient sull'ID della singola pagina (PSID) di quella persona, il parametro message_type su RESPONSE e l'oggetto text del parametro message sul messaggio di testo.

Esempio di richiesta

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text":"Hello, world!"
  }
}' "https://graph.facebook.com/v25.0/{PAGE-ID}/messages?access_token={PAGE-ACCESS-TOKEN}"
    

Se l'invio viene eseguito correttamente, l'app riceve la seguente risposta JSON con l'ID del destinatario e l'ID del messaggio.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Invio di un allegato multimediale

Per inviare un messaggio con contenuti multimediali, come una GIF, un'immagine o un modello, aggiungi il contenuto alla richiesta API in un oggetto allegato al messaggio JSON.

Per inviare un messaggio con un'immagine alla persona che ha inviato un messaggio alla tua Pagina, invia una richiesta POST all'endpoint /PAGE-ID/messages, impostando l'id della chiave letterale dell'oggetto recipient sull'ID della singola pagina (PSID) di quella persona, il parametro message_type su RESPONSE, la chiave type dell'oggetto attachment del parametro message su image e la chiave url dell'oggetto payload sull'URL dell'immagine.

Esempio di richiesta

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"1254459154682919"
  },
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "url":"http://www.messenger-rocks.com/image.jpg", 
        "is_reusable":true
      }
    }
  }
}' "https://graph.facebook.com/v25.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

Se l'invio viene eseguito correttamente, l'app riceve la seguente risposta JSON con l'ID del destinatario e l'ID del messaggio.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Per l'invio di audio, video o file da un URL, verrà usato lo stesso formato.

Puoi anche inviare contenuti multimediali dal tuo server o da contenuti che hai caricato in precedenza su un server di Meta. Scopri di più sul caricamento dei file tramite l'API Attachment Upload.

Invio di più allegati multimediali

Per inviare un messaggio con più immagini, aggiungi il contenuto alla richiesta API in un array di allegati al messaggio JSON. L'unico tipo di contenuto multimediale consentito è un'immagine e il limite è 30 immagini contemporaneamente.

Per inviare un messaggio con più immagini alla persona che ha inviato un messaggio alla tua Pagina, invia una richiesta POST all'endpoint /PAGE-ID/messages, impostando l'id della chiave letterale dell'oggetto recipient sull'ID della singola pagina (PSID) di quella persona, il parametro message_type su RESPONSE e il parametro message che contiene un array attachments in cui la chiave type di ciascun oggetto attachment viene impostata su image e la chiave url dell'oggetto payload sull'URL dell'immagine.

Esempio di richiesta

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "1254459154682919"
  },
  "message": {
    "attachments": [
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      },
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      }
    ]
  }
}' "https://graph.facebook.com/v25.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

Se l'invio procede correttamente, l'app riceve la seguente risposta JSON con l'ID del destinatario e l'ID del messaggio.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Invio di una risposta a un messaggio

Per inviare una risposta a uno specifico messaggio passato all'interno della chat, invia una richiesta POST a /PAGE-ID/messages con i seguenti elementi:

• id della chiave letterale dell'oggetto recipient impostato sull'ID della singola pagina della persona (PSID)
• message_type impostato su RESPONSE
• I dettagli del tuo messaggio nell'oggetto del parametro message
• mid della chiave letterale dell'oggetto reply_to impostato sull'ID del messaggio relativo al messaggio specifico della chat a cui vuoi rispondere

Il messaggio può essere il messaggio inviato dalla tua Pagina o dall'utente.

Esempio di richiesta

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "<PSID>",
  }
  "messaging_type": "RESPONSE"
  "message": {
    "text": "Hello, world!"      
  },
  "reply_to": {
    "mid": "{MESSAGE_ID}"
  }
}' "https://graph.facebook.com/v23.0/{PAGE-ID}/messages?access_token={PAGE_ACCESS_TOKEN}" 

Se l'invio procede correttamente, l'app riceve la seguente risposta JSON con l'ID del destinatario e l'ID del messaggio.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U…"
} 

Best practice

Messaggi di testo

• Punta sulla brevità. Considera le dimensioni dello schermo e l'utilizzo dello scorrimento; i messaggi compatti sono più facili da seguire. Prova a inviare più messaggi separati invece di uno lungo.
• Non utilizzare il testo come sostituto di immagini, tabelle e grafici. I messaggi strutturati o anche una visualizzazione web potrebbero soddisfare meglio le tue esigenze.
• Non scrivere messaggi lunghi. Se devi comunicare più cose, prova a inviare più messaggi separati anziché uno lungo.

Allegati

• Presta attenzione alla qualità. Usa immagini colorate ad alta risoluzione per far risaltare i tuoi messaggi.
• Considera il rapporto larghezza/altezza. Valuta come l'immagine potrebbe essere ritagliata quando viene visualizzata nel cerchio del messaggio.
• Non inserire grandi quantità di testo nell'immagine. Utilizza invece un messaggio di testo o combina immagini e testo con un modello generico.

Altri tipi di messaggi

Messaggi di marketing

La funzione Messaggi di marketing ti consente di richiedere a una persona l'autorizzazione all'invio di più messaggi di marketing allo scadere della finestra dei messaggi standard. Se la persona accetta la richiesta di ricevere queste notifiche, potrai inviarle messaggi promozionali automatici e ricorrenti con informazioni sulle promozioni in programma o su lanci di prodotti e aggiornamenti.

Messaggi con notizie (in fase di sviluppo)

I messaggi con notizie sono disponibili solo per gli editori di notizie registrati con l'indice delle Pagine di notizie di Facebook. Questi messaggi consentono agli editori di notizie di inviare messaggi con notizie non promozionali alle persone che hanno attivato l'iscrizione per riceverli.

I messaggi con notizie non sono disponibili per l'API Instagram Messaging.

Notifiche una tantum

Le notifiche una tantum ti consentono di richiedere a una persona l'autorizzazione all'invio di un messaggio di follow-up allo scadere della finestra dei messaggi standard. Se la persona accetta la richiesta di ricevere una notifica una tantum, potrai inviare un messaggio a tempo limitato e pertinente a livello personale, come un promemoria di un appuntamento o un avviso sulla disponibilità dei prodotti.

Le notifiche una tantum non sono disponibili per l'API Instagram Messaging.

Risposte private

Le risposte private ti consentono di inviare un messaggio a una persona che pubblica un commento su uno dei tuoi post o inserzioni oppure pubblica un post come visitatore sulla tua Pagina o sul tuo account Instagram per professionisti. La risposta privata può essere solo un messaggio singolo, che includerà automaticamente un link al post o al commento, e va inviata entro sette giorni dalla pubblicazione del post o del commento.

Messaggi sponsorizzati

I messaggi sponsorizzati ti consentono di inviare contenuti promozionali o non promozionali, dopo la scadenza della finestra dei messaggi standard, a una persona che ha già inviato un messaggio alla tua Pagina o al tuo account Instagram per professionisti. I messaggi sponsorizzati sembrano normali messaggi nella conversazione, ma si distinguono per la parola "Sponsorizzato" sopra il messaggio. Il contenuto dei messaggi sponsorizzati deve rispettare le Normative pubblicitarie.

I messaggi sponsorizzati non sono disponibili per l'API Instagram Messaging.

Messaggi di utility

I messaggi di utility ti consentono di inviare un modello di messaggio pre-approvato che include ordini, aggiornamenti dell'account e appuntamenti. Questi messaggi sono altamente personalizzati con numeri di account, ID degli ordini, numeri di tracking delle spedizioni e data e ora degli appuntamenti. In più, possono avere call to action che consentono all'utente di annullare un ordine, riprogrammare un appuntamento ed eseguire altre azioni che rendono più facili le interazioni con un'azienda.

Passaggi successivi

Scopri di più sui componenti che puoi aggiungere ai messaggi nelle tue conversazioni.

Per saperne di più

Scopri di più sull'invio di messaggi usando la Piattaforma Messenger.

• Riferimento per l'API Attachment Upload: scopri di più su come caricare e inviare contenuti multimediali.
• Riferimento per l'API Send: scopri di più sui tag, sui contenuti e sugli allegati che puoi inviare.
• Rate limiting: scopri di più sul rate limiting per l'invio di messaggi dalla Piattaforma Messenger.