Modulo didattico · Sviluppo Web / E-commerce

Creare applicazioni su Messenger

Un percorso operativo pensato per chi si avvicina per la prima volta alla Messenger Platform di Meta: dai concetti di base alla configurazione, fino a cinque casi d'uso reali.

📄
Pagina Facebook
Identità pubblica
→
⚙️
App su Meta for Developers
Prodotto Messenger
→
🔑
Page Access Token
Credenziale
→
💬
Send API
Invio/ricezione
01

Fondamenti

Messenger è un prodotto distinto da WhatsApp all'interno dell'ecosistema Meta: si aggancia a una Pagina Facebook, non a un numero di telefono.

Piattaforma

Messenger Platform

L'infrastruttura di Meta per costruire esperienze automatizzate collegate a una Pagina Facebook, tramite la Send API.

Identità

Pagina Facebook

A differenza di WhatsApp (numero di telefono), qui l'identità pubblica è una Pagina Facebook: ogni bot Messenger appartiene a una pagina specifica.

Sicurezza

Page Access Token

Il token legato alla singola Pagina, generato dall'app Meta collegata: autentica ogni chiamata alla Send API.

Identificativo utente

PSID

Page-Scoped ID: l'identificativo univoco di un utente rispetto a quella Pagina. Si ottiene solo dopo che l'utente ha scritto per primo alla pagina.

Regola importante

Finestra di 24 ore

Come WhatsApp, puoi rispondere liberamente entro 24 ore dall'ultimo messaggio dell'utente. Fuori da questa finestra servono Message Tag specifici.

Contenuto

Message Tag

Etichette che permettono di scrivere fuori dalla finestra 24h solo per casi specifici e autorizzati (es. aggiornamento su un ordine, un evento confermato).

02

Setup operativo passo-passo

Segui questi quattro passaggi in ordine.

01Crea (o usa) una Pagina Facebook

Su facebook.com/pages/create crea una Pagina, se non ne hai già una collegata alla tua attività didattica o al progetto.

02Crea un'app su Meta for Developers e aggiungi Messenger

Su developers.facebook.com crea un'app di tipo "Business", aggiungi il prodotto Messenger e collega la tua Pagina nella sezione di configurazione.

03Genera il Page Access Token

Dalla dashboard "Messenger > Impostazioni API" genera il token per la tua Pagina: è la credenziale che userai in ogni chiamata.

04Invia il tuo primo messaggio di prova

Per ottenere un PSID valido, scrivi tu stesso un messaggio alla tua Pagina da Messenger, poi leggi l'evento dal webhook configurato (o dal "Tester" nella dashboard Meta). Con quel PSID, prova:

cURL — invio messaggio di prova
curl -X POST "https://graph.facebook.com/v21.0/me/messages?access_token={PAGE_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {"id": "{PSID}"},
    "message": {"text": "Ciao! Questo è il mio primo messaggio via Send API."}
  }'
Segna come completato quando ricevi il messaggio su Messenger
Errore comune: provare a scrivere a un utente usando il suo profilo Facebook invece del PSID: la Send API richiede sempre il PSID, ottenibile solo dopo un primo contatto dell'utente verso la pagina.
03

Le cinque tipologie di applicazione

Clicca su ciascuna scheda per aprire scenario, esempio di codice e avvertenze.

🎧

Assistenza clienti

Risposte automatiche su Pagina Facebook
▾
Scenario: un cliente scrive alla pagina "Avete la taglia M?" e riceve subito una risposta con pulsanti di scelta rapida.
JSON — quick reply
{
  "recipient": {"id": "{PSID}"},
  "message": {
    "text": "Quale taglia ti serve?",
    "quick_replies": [
      {"content_type":"text", "title":"S", "payload":"TAGLIA_S"},
      {"content_type":"text", "title":"M", "payload":"TAGLIA_M"}
    ]
  }
}
Cosa non fare: non affidare risposte su temi delicati (resi, reclami) solo all'automazione: prevedi sempre un passaggio a un operatore umano.
📦

Notifiche transazionali

Aggiornamenti su ordini, fuori dalla finestra 24h
▾
Scenario: un e-commerce avvisa il cliente che l'ordine è stato spedito, anche a distanza di giorni dall'ultimo messaggio, usando un Message Tag.
JSON — invio con message_tag
{
  "recipient": {"id": "{PSID}"},
  "message": {"text": "Il tuo ordine è stato spedito!"},
  "messaging_type": "MESSAGE_TAG",
  "tag": "POST_PURCHASE_UPDATE"
}
Cosa non fare: non usare un Message Tag per contenuti che non corrispondono al suo scopo dichiarato (es. marketing generico con POST_PURCHASE_UPDATE): viola le policy di Meta.
📣

Marketing e broadcast

Solo entro consenso e finestra 24h
▾
Scenario: un brand risponde entro la finestra 24h a chi ha interagito di recente, proponendo un'offerta pertinente al contesto della conversazione.
JSON — messaggio promozionale entro la finestra
{
  "recipient": {"id": "{PSID}"},
  "messaging_type": "RESPONSE",
  "message": {"text": "Codice sconto15 valido oggi!"}
}
Cosa non fare: non inviare messaggi promozionali fuori dalla finestra 24h senza un Message Tag appropriato: Meta ha eliminato i permessi generici di "subscription messaging".
🤖

Chatbot conversazionale

Quick reply e template generici
▾
Scenario: uno studio guida l'utente tra opzioni tramite quick reply, prima di prenotare un appuntamento.
Node.js — gestione postback dei pulsanti
app.post('/webhook', (req, res) => {
  const event = req.body.entry[0].messaging[0];
  if (event.postback?.payload === 'PRENOTA') {
    inviaMessaggio(event.sender.id, 'Perfetto, in che data preferisci?');
  }
  res.sendStatus(200);
});
Cosa non fare: non costruire flussi senza via d'uscita verso un operatore umano.
🛒

E-commerce integrato

Catalogo prodotti con Generic Template
▾
Scenario: un negozio mostra una carosello di prodotti direttamente in chat, con immagine, prezzo e pulsante "Acquista".
JSON — generic template (carosello)
{
  "recipient": {"id": "{PSID}"},
  "message": {
    "attachment": {
      "type": "template",
      "payload": {
        "template_type": "generic",
        "elements": [{
          "title": "Maglietta Basic",
          "subtitle": "€19,90",
          "image_url": "https://tuosito.it/img.jpg"
        }]
      }
    }
  }
}
Cosa non fare: non dimenticare che ogni immagine deve essere raggiungibile pubblicamente via URL: link privati o locali non funzionano.
04

Glossario interattivo

Clicca su un termine per rivelarne la definizione.

PSID clicca
Page-Scoped ID: l'identificativo di un utente specifico per quella Pagina Facebook, diverso da pagina a pagina.
Page Access Token clicca
Token legato a una specifica Pagina Facebook, usato per autenticare le chiamate alla Send API.
Send API clicca
L'endpoint di Meta (graph.facebook.com/v21.0/me/messages) usato per inviare messaggi tramite Messenger.
Finestra 24h clicca
Periodo entro cui puoi rispondere liberamente a un utente dopo il suo ultimo messaggio, senza restrizioni di contenuto.
Message Tag clicca
Etichetta che autorizza l'invio fuori dalla finestra 24h, solo per lo scopo specifico dichiarato (es. aggiornamento ordine).
Quick Reply clicca
Pulsanti di risposta rapida mostrati sotto un messaggio, che scompaiono dopo la selezione.
Generic Template clicca
Formato a "carosello" per mostrare schede con immagine, titolo e pulsanti, tipico per cataloghi prodotto.
Webhook clicca
URL del tuo server che Meta chiama per notificare messaggi in arrivo o interazioni con i pulsanti (postback).
05

Esercitazioni pratiche

Verifica quanto hai appreso con questo quiz di autovalutazione.

1. A cosa è collegato un bot Messenger, a differenza di WhatsApp?
2. Come si ottiene il PSID di un utente?
3. Fuori dalla finestra di 24 ore, cosa serve per scrivere a un utente?
4. Cosa mostra un Generic Template?
06

Attestato di completamento

Completa tutti i passaggi della Sezione 2 per sbloccare il tuo attestato personale in PDF.

🔒
Attestato non ancora disponibile
Completa tutti e 4 i passaggi della Sezione 2 — Setup operativo.