API WhatsApp Business Management

Codici QR e link diretti

Questa guida spiega come creare e gestire codice QR usando l'API WhatsApp Business Management.

I clienti possono scansionare un codice QR dal loro telefono per iniziare rapidamente una conversazione con la tua azienda. L'API WhatsApp Business Management ti consente di creare questi codici QR e accedere ad essi e ai link diretti associati.

Se puoi usare il Business Manager per gestire i tuoi codici QR anziché l'API, consulta il documento sulla gestione dei codici QR di WhatsApp.

Prima di iniziare

Ecco cosa ti servirà:

Creazione di un codice QR

Per creare un codice QR, invia una richiesta POST all'endpoint WhatsApp Business Phone Number > Message Qrdls.

Nel corpo del post, includi un oggetto con la proprietà prefilled_message impostata sul tuo messaggio di testo e una proprietà generate_qr_image impostata sul tuo formato di immagine preferito, SVG o PNG.

Esempio di richiesta

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "prefilled_message": "Cyber Monday",
  "generate_qr_image": "SVG"
}'

Esempio di risposta

{
  "code": "4O4YGZEG3RIVE1",
  "prefilled_message": "Cyber Monday 1",
  "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1",
  "qr_image_url": "https://scontent-iad3-2.xx.fbcdn.net/..."
}

Acquisizione di una lista di codici QR

Per ottenere una lista di tutti i codici QR per un numero di telefono aziendale, invia una richiesta GET all'endpoint WhatsApp Business Phone Number > Message Qrdls.

Esempio di richiesta

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Authorization: Bearer EAAJB...'

Esempio di risposta

{
  "data": [
    {
      "code": "4O4YGZEG3RIVE1",
      "prefilled_message": "Cyber Monday",
      "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
    },
    {
      "code": "WOMVT6TJ2BP7A1",
      "prefilled_message": "Tell me more about your production workshop",
      "deep_link_url": "https://wa.me/message/WOMVT6TJ2BP7A1"
    }
  ]
}

Acquisizione di un codice QR

Per ottenere informazioni su uno specifico codice QR, invia una richiesta GET all'endpoint WhatsApp Business Phone Number > Message Qrdls e aggiungi l'ID del codice QR come parametro di percorso.

Esempio di richiesta

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
-H 'Authorization: Bearer EAAJB...'

Esempio di risposta

{
  "data": [
    {
      "code": "4O4YGZEG3RIVE1",
      "prefilled_message": "Cyber Monday",
      "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
    }
  ]
}

Aggiornamento di un codice QR

Per aggiornare un codice QR, invia una richiesta POST all'endpoint WhatsApp Business Phone Number > Message Qrdls.

Nel corpo del post, includi una proprietà code impostata sull'ID del codice QR che desideri aggiornare e una proprietà prefilled_message impostata sul testo del nuovo codice QR.

Esempio di richiesta

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
    "code": "4O4YGZEG3RIVE1",
    "prefilled_message": "Cyber Tuesday"
}'

Esempio di risposta

{
  "code": "4O4YGZEG3RIVE1",
  "prefilled_message": "Cyber Tuesday",
  "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
}

Eliminazione di un codice QR

I codici QR non scadono automaticamente. Per eliminare un codice QR, invia una richiesta DELETE all'endpoint WhatsApp Business Phone Number > Message Qrdls e aggiungi l'ID del codice QR che desideri ritirare come parametro di percorso.

Esempio di richiesta

curl -X DELETE 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
-H 'Authorization: Bearer EAAJB...'

Esempio di risposta

{
  "success": true
}

Riferimento

Ulteriori informazioni