WhatsApp Business Management API

QR-Codes und Kurzlinks

In diesem Leitfaden erfährst du, wie du über die WhatsApp Business Management API QR-Codes erstellst und verwaltest.

Kund*innen können einen QR-Code mit ihrem Smartphone scannen, um schnell eine Unterhaltung mit deinem Unternehmen zu beginnen. Mit der WhatsApp Business Management API kannst du diese QR-Codes und die zugehörigen Kurzlinks erstellen und auf sie zugreifen.

Ob du den Business Manager anstelle der API verwenden kannst, um deine QR-Codes zu verwalten, erfährst du unter Verwalten deiner WhatsApp-QR-Codes.

Bevor du beginnst

Voraussetzungen:

QR-Code erstellen

Um einen QR-Code zu erstellen, sende eine POST-Anfrage an den Endpunkt WhatsApp Business-Telefonnummer > Nachrichten-Qrdls.

Füge dem POST-Anfrageninhalt ein Objekt mit einer prefilled_message-Eigenschaft hinzu, die auf deinen Nachrichtentext festgelegt ist, und eine generate_qr_image-Eigenschaft, die auf dein bevorzugtes Bildformat festgelegt ist (entweder SVG oder PNG).

Beispielanfrage

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"
}'

Beispielantwort

{
  "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/..."
}

Eine Liste mit QR-Codes abrufen

Um eine Liste aller QR-Codes für eine Business-Telefonnummer abzurufen, sende eine GET-Anfrage an den Endpunkt WhatsApp Business-Telefonnummer > Nachrichten-Qrdls.

Beispielanfrage

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

Beispielantwort

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

Einen QR-Code abrufen

Wenn du Informationen über einen bestimmten QR-Code abrufen möchtest, sende eine GET-Anfrage an den Endpunkt WhatsApp Business-Telefonnummer > Nachrichten-Qrdls und hänge die ID des QR-Codes als Pfadparameter an.

Beispielanfrage

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

Beispielantwort

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

Einen QR-Code aktualisieren

Um einen QR-Code zu aktualisieren, sende eine POST-Anfrage an den Endpunkt WhatsApp Business-Telefonnummer > Nachrichten-Qrdls.

Füge dem POST-Anfrageninhalt eine code-Eigenschaft hinzu, die auf die ID des zu aktualisierenden QR-Codes festgelegt ist, und eine prefilled_message-Eigenschaft, die auf den neuen QR-Code-Text festgelegt ist.

Beispielanfrage

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"
}'

Beispielantwort

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

QR-Code löschen

QR-Codes laufen nicht automatisch ab. Sende zum Löschen eines QR-Codes eine DELETE-Anfrage an den Endpunkt WhatsApp Business-Telefonnummer > Nachrichten-Qrdls und hänge die ID des QR-Codes als Pfadparameter an.

Beispielanfrage

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

Beispielantwort

{
  "success": true
}

Referenz

Mehr dazu