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 lo rimanda a una conversazione esistente tra quella persona e la Pagina
• Una persona clicca su un link ig.me che lo 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. Gli utenti 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: 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: 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 è 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 fuori dalla 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 ulteriori dettagli, consulta la Normativa della Piattaforma Messenger e dell'API Instagram Messaging .

Le aziende che usano la Piattaforma Messenger e desiderano 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 che invii 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 con l'id della chiave letterale dell'oggetto recipient impostato sull'ID della singola pagina (PSID) di quella persona, il parametro message_type impostato su RESPONSE e l'oggetto text del parametro message impostato 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/v21.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..."
} 

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/v21.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..."
} 

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

Puoi anche inviare contenuti multimediali dal server o da contenuti caricati in precedenza su un server Meta. Maggiori informazioni sul caricamento dei file tramite l'API Attachment Upload.

Best practice

Messaggi di testo

Allegati

Altri tipi di messaggi

Messaggi con notizie (in fase di sviluppo)

I messaggi con notizie sono disponibili solo per gli editori di notizie registrati nell'Indice delle Pagine di notizie (NPI) di Facebook.I messaggi con notizie consentono agli editori di notizie di inviare messaggi non promozionali con notizie agli utenti che ne hanno sottoscritto la ricezione.

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

Notifiche una tantum

La notifica una tantum consente di richiedere a una persona l'autorizzazione all'invio di un messaggio di follow-up allo scadere di una 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 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 di marketing

I messaggi di marketing consentono 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 prossime vendite o sui lanci di prodotti e sugli aggiornamenti.

Messaggi sponsorizzati

I messaggi sponsorizzati consentono di inviare contenuti promozionali o non promozionali, allo scadere della finestra dei messaggi standard, a una persona che ha precedentemente 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.

Passaggi successivi

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

Per saperne di più

Ulteriori informazioni sull'invio di messaggi usando la Piattaforma Messenger.

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