Condivisione dei prodotti con i clienti

Hai diversi modi per condividere i prodotti con i tuoi clienti:

• Messaggi per il catalogo: messaggi in formato libero contenenti un pulsante che, quando toccato, mostra il tuo catalogo prodotti all'interno di WhatsApp.
• Modelli di messaggio per il catalogo: modelli di messaggio contenenti un pulsante che, quando toccato, mostra il tuo catalogo prodotti all'interno di WhatsApp.
• Messaggi con link al catalogo: messaggi in formato libero che contengono miniature del catalogo e un link all'intero catalogo prodotti.
• Messaggi sui prodotti: messaggi in formato libero che contengono informazioni su un singolo prodotto o fino a 30 prodotti del tuo catalogo.
• Modelli di messaggio per più prodotti: modelli di messaggio contenenti informazioni su un massimo di 30 prodotti del tuo catalogo e-commerce, organizzati in un massimo di 10 sezioni, in un unico messaggio.

Messaggi per il catalogo

I messaggi per il catalogo sono messaggi in formato libero che ti permettono di mostrare il tuo catalogo prodotti interamente all'interno di WhatsApp.

I messaggi per il catalogo mostrano un'immagine di intestazione contenente la miniatura del prodotto di tua scelta, testo personalizzato, intestazione di testo fisso, sottointestazione di testo fisso e pulsante Visualizza catalogo.

Quando un cliente tocca il pulsante Visualizza catalogo, il tuo catalogo prodotti viene visualizzato su WhatsApp.

Requisiti

Devi aver caricato l'inventario su Meta in un catalogo di e-commerce collegato al tuo account WhatsApp Business.

Sintassi della richiesta

Usa l'endpoint WhatsApp Business Phone Number > Messages per inviare un messaggio per il catalogo.

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Corpo del post

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<TO>",
  "type": "interactive",
  "interactive" : {
    "type" : "catalog_message",
    "body" : {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "catalog_message",
      
      /* Parameters object is optional */
      "parameters": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

    /* Footer object is optional */
    "footer": {
      "text": "<FOOTER_TEXT>"
  }
}

Proprietà

Esempio di richiesta

curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "interactive",
  "interactive": {
    "type": "catalog_message",
    "body": {
      "text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase."
    },
    "action": {
      "name": "catalog_message",
      "parameters": {
        "thumbnail_product_retailer_id": "2lc20305pt"
      }
    },
    "footer": {
      "text": "Best grocery deals on WhatsApp!"
    }
  }
}'

Esempio di risposta

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA"
    }
  ]
}

Modelli di messaggio per il catalogo

I modelli di messaggio per il catalogo sono modelli di messaggio contenenti un pulsante che, quando toccato, mostra il tuo catalogo prodotti all'interno di WhatsApp.

Per inviare un modello di messaggio per il catalogo hai bisogno di un modello di catalogo. Consulta il nostro documento Modelli di catalogo per sapere come creare questi modelli e come inviarli in un modello di messaggio.

Messaggi con link al catalogo

Puoi inviare un link all'intero catalogo prodotti tramite un link wa.me da includere in un messaggio di testo standard. Inviando un messaggio di testo, hai anche la possibilità di usare un preview_url impostato su true in modo che il messaggio offra una serie di immagini di anteprima dal catalogo prodotti per gli URL nella stringa body del messaggio.

Ricorda che se disabiliti il catalogo, i link wa.me e il pulsante Visualizza catalogo nei messaggi con link al catalogo mostreranno il messaggio Link al catalogo non valido quando toccati.

Per creare il link wa.me, allega il numero di telefono aziendale, includendo il prefisso internazionale, al termine della stringa seguente:

https://wa.me/c/

Ad esempio:

https://wa.me/c/15555455657

Messaggi sui prodotti

Sia i messaggi per più prodotti che i messaggi per un singolo prodotto corrispondono al tipo di messaggio interactive.

Esempio di Messaggio per più prodotti:	Esempio di messaggio per un singolo prodotto:
Menu attivato quando l'utente fa clic su Inizia lo shopping:	Esempio di Pagina dettagli del prodotto:

Panoramica

I clienti che ricevono messaggi per più prodotti e messaggi per un singolo prodotto possono eseguire principalmente tre azioni:

1. Visualizzare i prodotti: i clienti vedono una lista di prodotti o un singolo prodotto. Ogni volta che un cliente clicca su un articolo specifico, recuperiamo le informazioni più recenti del prodotto e lo mostriamo in una Pagina dettagli del prodotto (PDP). Attualmente, le PDP supportano solo le immagini dei prodotti. Eventuali video e/o GIF aggiunti al prodotto non saranno visualizzati nella PDP.
2. Aggiungere prodotti al carrello: ogni volta che un utente aggiunge un prodotto al carrello, recuperiamo le ultime informazioni sull'articolo. Se si è verificato un cambiamento di stato riguardo a uno degli articoli, mostriamo una finestra di dialogo con l'avviso "Uno o più articoli nel carrello sono stati aggiornati". Consulta Aggiornamenti dei prodotti per ulteriori informazioni. Il carrello viene mantenuto in una conversazione tra te e il cliente finché quest'ultimo non lo invia. Consulta Esperienza del carrello per ulteriori dettagli.
3. Inviarti un carrello: dopo aver aggiunto tutti gli articoli necessari, i clienti possono inviarti il carrello. Dopodiché, puoi definire i passaggi successivi, ad esempio richiedere informazioni di consegna o fornire opzioni di pagamento.

Se il cliente ha più dispositivi collegati allo stesso account, i messaggi per più prodotti o per un singolo prodotto saranno sincronizzati tra i dispositivi. Tuttavia, il carrello è locale per ogni dispositivo specifico. Consulta Esperienza del carrello per ulteriori dettagli.

Attualmente, questi tipi di messaggi possono essere ricevuti sulle seguenti piattaforme:

• iOS: 2.21.100 (messaggi per più prodotti) e 2.21.210 (messaggi per un singolo prodotto).
• Android: 2.21.9.15 (messaggi per più prodotti) e 2.21.19 (messaggi per un singolo prodotto).
• Web: è stato reso disponibile il client web che supporta queste funzionalità.

Se la versione dell'app del cliente non supporta i messaggi per più prodotti o per un singolo prodotto, il cliente riceverà un messaggio indicante che non è stato possibile ricevere un messaggio perché sta usando una versione obsoleta di WhatsApp. Provvederemo anche a inviarti una notifica webhook che indica che non è stato possibile consegnare il messaggio perché il cliente usa una versione obsoleta di WhatsApp.

Comportamento previsto per i messaggi

I messaggi per più prodotti e i messaggi per un singolo prodotto possono essere:

• Inoltrati da un utente a un altro.
• Riaperti da un utente nella stessa conversazione.

I messaggi per più prodotti e i messaggi per un singolo prodotto non possono essere:

• Inviati come notifiche. Possono essere inviati solo all'interno di conversazioni esistenti.

Limitazioni

A differenza dei messaggi prodotto inviati tramite l'app WhatsApp Business, i messaggi inviati tramite l'API Cloud al momento non mostrano l'icona del carrello nell'intestazione della conversazione.

Aggiornamenti dei prodotti

Potresti dover aggiornare le proprietà degli articoli nel tuo catalogo. A seconda della proprietà aggiornata, gestiremo i messaggi che menzionano quel prodotto come indicato di seguito:

Esperienza del carrello

Dopo aver visualizzato i prodotti, un cliente può aggiungerli al carrello e inviarti quel carrello. Ai fini delle vendite su WhatsApp, il carrello:

• È unico per ogni conversazione tra cliente e azienda in un dispositivo specifico: viene creato un solo carrello per conversazione tra te e il cliente, inoltre i carrelli non vengono mantenuti su più dispositivi. Una volta inviato un carrello, il cliente può aprire un altro carrello con te e ricominciare il processo.
• Non ha data di scadenza: il carrello viene mantenuto nella conversazione fino a quando non ti viene inviato. Una volta inviato, il carrello viene svuotato.

I clienti possono aggiungere fino a 99 unità di ogni singolo articolo del catalogo al carrello, ma non c'è limite al numero dei vari articoli che possono essere aggiunti al carrello.

Una volta inviato un carrello, non è possibile apportare modifiche. I clienti possono inviare un nuovo carrello se hanno bisogno di nuovi articoli o se vogliono modificare l'ordine. Non puoi inviare carrelli ai clienti.

Esempio di esperienza del carrello e comportamento previsto per modifica allo stato dell'articolo.

Perché utilizzarli

Sia i messaggi per più prodotti che i messaggi per un singolo prodotto garantiscono esperienze utente semplici e personalizzate, mostrando al cliente un sottoinsieme di articoli potenzialmente di suo interesse, senza che debba sfogliare l'intera offerta di prodotti e servizi.

Semplici e pratici

Abbinati alle funzioni degli strumenti di navigazione, come l'elaborazione del linguaggio naturale, la ricerca nel testo o i messaggi con lista e i pulsanti di risposta, consentono al cliente di trovare velocemente ciò che desidera.

Personalizzati

Vengono popolati in modo dinamico per essere personalizzati a seconda di cliente o situazione. Ad esempio, puoi mostrare un messaggio per più prodotti contenente gli articoli che un cliente ordina più spesso.

Risultati per l'azienda

Durante un test aziendale, i messaggi per più prodotti si sono rivelati un canale performante nella promozione degli ordini con un tasso di conversione medio del 7% in rapporto ai carrelli ricevuti.

Nessun modello

I messaggi interattivi non richiedono modelli né approvazioni preliminari. Vengono generati in tempo reale e rifletteranno sempre i dettagli, i prezzi e i livelli di disponibilità degli articoli in catalogo più recenti.

Quando utilizzarli

I messaggi per più prodotti sono ideali per guidare i clienti verso un sottoinsieme specifico della tua offerta di prodotti e servizi, come:

• Acquistare mediante le conversazioni. Ad esempio, utilizzando la funzionalità di ricerca per consentire ai clienti di digitare una lista della spesa e di ottenere un messaggio per più prodotti in risposta.
• Passare a una categoria specifica. Ad esempio, abbigliamento da fitness.
• Offerte e consigli personalizzati.
• Riordinare gli articoli già ordinati. Ad esempio, un utente può riordinare il suo solito ordine da asporto con meno di 30 articoli.

I messaggi per un singolo prodotto sono la soluzione ideale per guidare i clienti verso un articolo specifico del tuo inventario di prodotti e servizi, offrendo risposte rapide da un insieme limitato di opzioni, come:

• Rispondere alla richiesta specifica di un cliente.
• Offrire un consiglio.
• Riordinare un articolo già ordinato.

Entrambe le funzionalità possono anche essere usate come parte di un flusso con agente umano, ma dovrai creare uno strumento per consentire all'agente umano di generare un messaggio per più prodotti o un messaggio per un singolo prodotto nella conversazione.

Primi passi

Prima di inviare messaggi sui prodotti, segui la guida introduttiva più adatta alle tue esigenze:

• Guida introduttiva per chi sviluppa per sé o per la propria organizzazione
• Primi passi per i partner di soluzioni

Tutte le chiamate API menzionate in questa guida devono essere autenticate con un token d'accesso. Gli sviluppatori possono autenticare le proprie chiamate API con il token d'accesso generato in Dashboard gestione app > WhatsApp > scheda Configurazione API. I partner di soluzioni devono autenticarsi con un token d'accesso con l'autorizzazione whatsapp_business_messaging.

Passaggio 1: creazione dell'oggetto interattivo

Messaggi per un singolo prodotto

Per inviare un messaggio per un singolo prodotto, crea un oggetto interactive del tipo product con i componenti seguenti:

Consulta Messaggi, oggetto interattivo per i dettagli completi. Al termine del processo, l'oggetto interattivo dovrebbe avere un aspetto simile a questo:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product",
    "body": {
      "text": "BODY_TEXT"
    },
    "footer": {
      "text": "FOOTER_TEXT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "product_retailer_id": "ID_TEST_ITEM_1"
    }
  }
}

Messaggi per più prodotti

Per inviare un Messaggio per più prodotti, crea un oggetto interactive del tipo product_list con i seguenti componenti:

Consulta Messaggi, oggetto interattivo per i dettagli completi. Al termine del processo, l'oggetto interattivo dovrebbe avere un aspetto simile a questo:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product_list",
    "header":{
      "type": "text",
      "text": "HEADER_CONTENT"
    },
    "body": {
      "text": "BODY_CONTENT"
    },
    "footer": {
      "text": "FOOTER_CONTENT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "sections": [
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]

        },
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]
        }
      ]
    }
  }
}

Articoli mancanti

Se nessuno degli articoli forniti nelle chiamate API sopra corrisponde a un prodotto del tuo catalogo prodotti, viene inviato un messaggio di errore, mentre il messaggio per più prodotti o per un singolo prodotto non viene inviato all'utente.

Per i messaggi per più prodotti, almeno un articolo della lista di prodotti deve corrispondere a un articolo del tuo catalogo prodotti. In questo caso:

• I messaggi vengono inviati correttamente.
• Gli articoli senza corrispondenze vengono esclusi.
• Ricevi un messaggio di errore in cui viene ti richiesto di aggiornare il catalogo.

Passaggio 2: aggiunta dei parametri comuni del messaggio

Una volta completato l'oggetto interattivo, aggiungi gli altri parametri che compongono il messaggio: recipient_type, to, messaging_product e type. Ricorda di impostare type su interactive.

curl -X  POST https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER/messages \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 - d '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
  // INTERACTIVE OBJECT GOES HERE    
}'

Per conoscere tutti i parametri disponibili, consulta Riferimento, Messaggi.

Passaggio 3: invio di una richiesta all'endpoint Messages

Invia una richiesta POST all'endpoint /PHONE_NUMBER_ID/messages con l'oggetto JSON creato nei passaggi 1 e 2. Se il tuo messaggio viene inviato correttamente, riceverai la seguente risposta:

{
  "messaging_product": "whatsapp",
  "contacts": [{
      "input": "PHONE_NUMBER",
      "wa_id": "WHATSAPP_ID",
    }]
  "messages": [{
      "id": "wamid.ID",
    }]
}

Modelli di messaggi per più prodotti

Per inviare un modello di messaggio per più prodotti hai bisogno di un modello di messaggio per più prodotti. Consulta il nostro documento Modelli di messaggi per più prodotti per sapere come creare questi modelli e come inviarli in un modello di messaggio.