Componenti conversazionali

I componenti conversazionali sono funzioni in chat che puoi abilitare sui numeri di telefono aziendali. Rendono più facile per gli utenti di WhatsApp interagire con la tua azienda. Puoi configurare comandi facili da usare, fornire messaggi per rompere il ghiaccio predefiniti selezionabili con un tocco e salutare con un messaggio di benvenuto gli utenti con cui interagisci per la prima volta.

Limitazioni

Se un utente di WhatsApp tocca un link universale (ovvero un link wa.me) configurato con testo precompilato, le interfacce utente per i messaggi per rompere il ghiaccio vengono ignorate automaticamente.

Configurazione tramite WhatsApp Manager (WAM)

Puoi configurare tutte queste funzioni in WhatsApp Manager sui numeri specifici che scegli:

1. Accedi alla dashboard Le mie app sul sito Meta for Developers.
2. Seleziona la tua app, quindi nella scheda a sinistra seleziona Configurazione sotto WhatsApp.
3. In Numeri di telefono seleziona Gestisci numeri di telefono.
4. Nell'angolo in alto a destra del numero di telefono che intendi configurare, seleziona l'icona a forma di ingranaggio in Impostazioni.
5. Seleziona Automazioni.
6. Accedi e configura i componenti conversazionali.

Anche i fornitori di soluzioni possono configurare queste funzioni per i loro clienti, se hanno accesso al loro account di WhatsApp Business in WhatsApp Manager.

Messaggi di benvenuto

Quando un utente di WhatsApp apre una chat con te per la prima volta, puoi ricevere una notifica tramite webhook. Questo può essere utile se vuoi rispondere all'utente con un messaggio di benvenuto speciale ideato da te.

I messaggi di benvenuto sono perfetti per le interazioni per richieste di servizi, come l'assistenza clienti o gli interventi di risoluzione dei problemi con l'account. Ad esempio, puoi incorporare un pulsante di WhatsApp nella tua app o nel tuo sito web. Quando gli utenti toccano il pulsante, vengono reindirizzati a WhatsApp, dove ricevono un messaggio di benvenuto che fornisce contesto su come possono interagire con te.

Se abiliti questa funzione e un utente ti scrive, il client WhatsApp controlla se c'è una conversazione esistente tra l'utente e il tuo numero di telefono aziendale. Se non esiste alcuna conversazione, il client attiva un webhook messages con type impostato su request_welcome. Puoi quindi rispondere all'utente con il tuo messaggio di benvenuto.

Il webhook request_welcome attiva una finestra di assistenza clienti che consente all'azienda di inviare messaggi in formato libero quando risponde ai clienti.

Modello di messaggio carosello come messaggio di benvenuto

Payload webhook

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "type": "request_welcome"  // Indicates first time message from WhatsApp user
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Messaggi per rompere il ghiaccio

I messaggi per rompere il ghiaccio sono stringhe di testo personalizzabili che è possibile toccare, che compaiono in una conversazione la prima volta che chatti con un utente. Ad esempio, "Pianifica un viaggio" o "Crea un piano di allenamento".

I messaggi per rompere il ghiaccio sono perfetti per le interazioni per richieste di servizi, come l'assistenza clienti e gli interventi di risoluzione dei problemi con l'account. Ad esempio, puoi incorporare un pulsante di WhatsApp nella tua app o nel tuo sito web. Quando gli utenti toccano il pulsante, vengono reindirizzati su WhatsApp, dove possono scegliere da una serie di prompt personalizzabili che mostrano loro come interagire con i tuoi servizi.

Su un numero di telefono aziendale puoi configurare fino a 4 messaggi per rompere il ghiaccio. Ogni messaggio per rompere il ghiaccio può avere un massimo di 80 caratteri. Le emoji non sono supportate.

Quando un utente tocca un messaggio per rompere il ghiaccio, attiva un webhook standard di messaggio ricevuto con la stringa di tale messaggio assegnata alla proprietà body nel payload. Se l'utente tenta di inviarti messaggi invece di toccare un messaggio per rompere il ghiaccio, apparirà l'overlay della tastiera, che può però essere ignorato per vedere di nuovo il menu dei messaggi.

Payload webhook

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "text": {
                  "body": "Plan a trip"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Comandi

I comandi sono stringhe di testo che gli utenti di WhatsApp possono vedere digitando una barra obliqua in una conversazione con la tua azienda.

I comandi sono composti dal comando stesso e da un suggerimento, che dà all'utente un'idea di cosa può accadere quando utilizza il comando. Ad esempio, potresti definire il comando:

/imagine - Create images using a text prompt

Quando un utente WhatsApp digita /imagine cars racing on Mars, viene attivato un webhook di messaggio ricevuto con quella stessa stringa di testo assegnata alla proprietà body. Potresti quindi generare e restituire un'immagine di auto che corrono sul pianeta Marte.

Puoi definire fino a 30 comandi. Ogni comando ha un massimo di 32 caratteri e ogni suggerimento ha un massimo di 256 caratteri. Le emoji non sono supportate.

Payload webhook

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "text": {
                  "body": "/imagine cars racing on Mars"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Configurazione tramite API

Utilizzando l'API, puoi configurare anche i componenti conversazionali e visualizzare i valori configurati.

L'API Conversational Components ha due endpoint:

POST </PHONE_NUMBER_ID>/conversational_automation, utilizzato per configurare i componenti conversazionali su un numero di telefono specifico.

GET /<PHONE_NUMBER_ID>/conversational_automation, che restituisce i valori correnti per i campi enable_welcome_message, commands e prompts su un determinato numero di telefono.

Configurare i componenti conversazionali tramite l'API

Puoi configurare i componenti conversazionali su un numero di telefono specifico chiamando l'endpoint POST.

Sintassi della richiesta

// Enable or disable the Welcome Message for the given phone number ID
POST /<PHONE_NUMBER_ID>/conversational_automation?enable_welcome_message=<ENABLE_DISABLE>

// Configure Commands with names and descriptions
POST /<PHONE_NUMBER_ID>/conversational_automation?commands=<COMMAND_LIST>

// Configure Prompts
POST /<PHONE_NUMBER_ID>/conversational_automation?prompts=<PROMPT>

Proprietà del corpo

"commands": {
     "command_name": "generate"
     "command_description": "Create a new image",
     “command_name”: “rethink”
     “command_description”: “Generate new images from existing images”,
} 

Esempio di richiesta

   curl -X POST \
 'https://graph.facebook.com/v19.0/PHONE_NUMBER_ID/conversational_automation' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
   "enable_welcome_message": true/false,
   "commands": [
     {
       "command_name": "tickets",
       "command_description": "Book flight tickets",
     },
     {
       "command_name": "hotel",
       "command_description": "Book hotel",
     }
   ],
 "prompts": ["Book a flight","plan a vacation"]
}'

Esempio di risposta

{
  "success": true
}

Visualizzare la configurazione corrente tramite l'API

Puoi visualizzare la configurazione corrente dei componenti conversazionali in un numero di telefono specifico chiamando l'endpoint GET.

Sintassi della richiesta

GET  /<PHONE_NUMBER_ID>?fields=conversational_automation

Esempio di risposta

{
  "conversational_automation": {
    "enable_welcome_message": true
    "prompts": [
      "Find the best hotels in the area",
      "Find deals on rental cars"
    ],
    "commands": [
      {
        "command_name": "tickets",
        "command_description": "Book flight tickets",
      },
      {
        "command_name": "hotel",
        "command_description": "Book hotel",
      }
    ],
  }
  "id": "123456"
}

Test

Per testare i componenti conversazionali una volta configurati, apri il client WhatsApp e inizia una chat con il tuo numero di telefono aziendale.

Per i messaggi di benvenuto e i messaggi per rompere il ghiaccio, se hai già una conversazione in corso con il numero di telefono aziendale, devi cancellarla prima di procedere:

1. Apri la conversazione nel client WhatsApp.
2. Tocca il profilo del numero di telefono aziendale.
3. Tocca Svuota chat > Elimina tutti i messaggi.
4. Elimina chat.
5. Avvia una nuova chat con questa azienda.

A questo punto puoi inviare un messaggio al numero di telefono aziendale; questa operazione dovrebbe attivare il webhook request_welcome.