Condivisione dei prodotti con i clienti

Le aziende possono condividere i loro prodotti con i clienti in più modi:

• 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 messaggi per il catalogo: modelli di messaggi contenenti un pulsante che, quando toccato, mostra il tuo catalogo prodotti all'interno di WhatsApp.
• Messaggi con link al catalogo: messaggi che contengono miniature del catalogo e un link all'intero catalogo prodotti.
• Messaggi sui prodotti: messaggi che contengono informazioni su un singolo prodotto o fino a 30 prodotti dal 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": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

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

Proprietà

Esempio di richiesta

{
  "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

Le aziende possono 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, le aziende hanno 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 le aziende disabilitano il catalogo, toccando i link wa.me e il pulsante Visualizza catalogo nei messaggi con link al catalogo verrà visualizzato il messaggio Link al catalogo non valido.

Per creare il link wa.me, aggiungi il numero di telefono dell'azienda, includendo il prefisso internazionale, al termine della seguente stringa:

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 clicca su Inizia a fare acquisti:	Esempio di pagina con i dettagli del prodotto:

Panoramica

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

1. Visualizzare i prodotti: i clienti possono vedere una lista di prodotti o un solo prodotto. Ogni volta che un utente clicca su un articolo specifico, recuperiamo le informazioni più recenti del prodotto e lo mostriamo in una pagina dei dettagli del prodotto. Attualmente, le pagine dei dettagli del prodotto supportano solo le immagini dei prodotti. Eventuali video e/o GIF aggiunti al prodotto non saranno visualizzati nella pagina dei dettagli del prodotto.
2. Aggiungere prodotti al carrello: gli utenti possono aggiungere un prodotto al carrello o modificare la quantità direttamente dalla lista o nella pagina dei dettagli del prodotto. 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, viene visualizzata una finestra di dialogo con l'avviso "Uno o più articoli nel carrello sono stati aggiornati". Per ulteriori informazioni, consulta Aggiornamento dei prodotti. Il carrello viene conservato nella serie di post di una chat tra l'azienda e il cliente finché non viene inviato all'azienda. Per maggiori dettagli, consulta Esperienza del carrello.
3. Inviare un carrello all'azienda: dopo aver aggiunto tutti gli articoli necessari, i clienti possono inviare il carrello all'azienda con cui scambiano messaggi. Dopodiché, le aziende possono definire i passaggi successivi, ad esempio richiedere informazioni di consegna o fornire opzioni di pagamento.

Se un cliente ha più dispositivi collegati allo stesso account WhatsApp, 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, sulle seguenti piattaforme è possibile ricevere i seguenti tipi di messaggi:

• 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 destinatario non supporta i messaggi per più prodotti o per un singolo prodotto, l'utente riceverà un messaggio indicante che non è stato possibile ricevere un messaggio perché sta usando una versione obsoleta di WhatsApp. L'azienda riceverà inoltre una notifica webhook indicante che il messaggio non è stato consegnato perché il destinatario 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 il catalogo, i messaggi per più prodotti e i messaggi per un singolo prodotto non possono essere:

• Inviati come notifiche. Possono essere inviati solo nell'ambito di una conversazione esistente.

Aggiornamenti dei prodotti

Le aziende talvolta devono aggiornare le proprietà degli articoli nel 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 inviare il carrello all'azienda. Ai fini dell'esperienza di vendita e acquisto su WhatsApp, il carrello:

• È unico per ogni conversazione in una chat personale/aziendale in un dispositivo specifico: viene creato un solo carrello per ogni conversazione in chat tra cliente e azienda, e i carrelli non vengono mantenuti su più dispositivi. Una volta inviato un carrello, il cliente può aprire un altro carrello con l'azienda e riavviare il processo.
• Non ha data di scadenza: il carrello viene mantenuto nella chat fino a quando non viene inviato all'azienda. 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 di articoli diversi 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 il loro ordine. Le aziende non possono inviare carrelli ai clienti.

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

Perché utilizzarli

Sia i messaggi per un prodotto che i messaggi per più prodotti 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 dell'azienda.

Semplici e pratici

Abbinati alle funzionalità 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.

Personalizzabili

Vengono popolati in modo dinamico per essere personalizzati a seconda del cliente o della situazione. Ad esempio, puoi mostrare un messaggio per più prodotti con i prodotti che un cliente ordina più spesso.

Risultati di business

Sono un canale efficace per generare ordini: durante i test, le aziende hanno registrato in media una conversione del 7% dei messaggi per più prodotti inviati 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 dell'offerta di prodotti e servizi aziendale, 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 dell'offerta di prodotti e servizi di un'azienda, 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 durante un flusso con un agente umano, ma dovrai creare gli strumenti 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 ogni messaggio, devi ottenere l'ID WhatsApp del destinatario con una chiamata al nodo /contacts.

Consigliamo di configurare i webhook per ricevere notifiche relative allo stato dei messaggi e ai messaggi in arrivo. In questo modo, puoi monitorare l'invio di un messaggio e le risposte dei clienti.

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 seguenti componenti:

Al termine del processo, l'oggetto interattivo dovrebbe essere simile a questo:

"interactive": {
    "type": "product",
    "body": {
      "text": "text-body-content"
    },
    "footer": {
      "text": "text-footer-content"
    },
    "action": {
      "catalog_id": "catalog-id",
      "product_retailer_id": "product-SKU-in-catalog"
    }
}

Messaggi per più prodotti

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

Al termine del processo, l'oggetto interactive dovrebbe essere simile a questo:

"interactive": 
    {
    "type": "product_list",
    "header":{
       "type": "text",
        "text": "text-header-content"
     },
     "body":{
        "text": "text-body-content"
      },
     "footer":{
        "text":"text-footer-content"
     },
     "action":{
        "catalog_id":"catalog-id",
        "sections": [
             {
             "title": "the-section-title",             
             "product_items": [
                  { "product_retailer_id": "product-SKU-in-catalog" },
                  { "product_retailer_id": "product-SKU-in-catalog" },
                            ...
              ]},
              {
              "title": "the-section-title",
              "product_items": [
                 { "product_retailer_id": "product-SKU-in-catalog" }
                           ...
              ]},
               ...
       ]
     },  
    }

Articoli mancanti

Se nessuno degli articoli forniti nelle chiamate API riportate sopra corrisponde a un prodotto del catalogo Facebook dell'azienda, 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 dell'elenco dei prodotti deve corrispondere a un articolo del catalogo Facebook dell'azienda. In questo caso:

• I messaggi vengono inviati correttamente.
• Gli articoli senza corrispondenze vengono esclusi.
• L'azienda riceve un messaggio di errore in cui viene 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 e type. Ricorda di impostare type su interactive.

{
  "recipient_type": "individual",
  "to" : "whatsapp-id", // WhatsApp ID of the recipient
  "type": "interactive",
  "interactive":{
    // The interactive object  
   }
  }

Consulta i parametri comuni per tutti i tipi di messaggio qui.

Passaggio 3: esecuzione di una chiamata POST a /messages

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

{
  "messages": [{
    "id": "{message-id}"
  }]
  }

Modelli di messaggi per più prodotti

Per inviare un messaggio per più prodotti basato su un modello devi prima creare il relativo modello. Consulta il nostro documento Modelli di messaggi per più prodotti per sapere come creare questi modelli e come inviarli in un modello di messaggio.