API WhatsApp Business Management

Codes QR et liens courts

Ce guide explique comment créer et gérer des codes QR à l’aide de l’API WhatsApp Business Management.

Les client·es peuvent scanner un code QR sur leur téléphone pour engager rapidement une conversation avec votre entreprise. L’API WhatsApp Business Management vous permet de créer ces codes QR et les liens courts associés, et d’y accéder.

Si vous pouvez gérer vos codes QR à l’aide de Business Manager plutôt qu’avec l’API, consultez l’article Manage your WhatsApp Business Platform QR code (Gérer les codes QR de votre plateforme WhatsApp Business).

Avant de commencer

Vous aurez besoin des éléments suivants :

Créer un code QR

Pour créer un code QR, envoyez une requête POST au point de terminaison Numéro de téléphone WhatsApp Business > Message Qrdls.

Dans la requête, incluez un objet avec une propriété prefilled_message définie sur le texte de votre message, et une propriété generate_qr_image définie sur le format d’image souhaité, SVG ou PNG.

Exemple de requête

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

Exemple de réponse

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

Obtenir une liste de codes QR

Pour obtenir la liste de tous les codes QR associés à un numéro de téléphone d’entreprise, envoyez une requête GET au point de terminaison Numéro de téléphone WhatsApp Business > Message Qrdls.

Exemple de requête

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

Exemple de réponse

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

Obtenir un code QR

Pour obtenir des informations sur un code QR spécifique, envoyez une requête GET au point de terminaison Numéro de téléphone WhatsApp Business > Message Qrdls et ajoutez l’ID du code QR comme paramètre de chemin.

Exemple de requête

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

Exemple de réponse

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

Mettre à jour un code QR

Pour mettre à jour un code QR, envoyez une requête POST au point de terminaison Numéro de téléphone WhatsApp Business > Message Qrdls.

Dans la requête, ajoutez les propriétés code (définie sur l’ID du code QR à mettre à jour) et prefilled_message (définie sur le nouveau texte du code QR).

Exemple de requête

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

Exemple de réponse

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

Supprimer le code QR

Les codes QR n’expirent pas de manière automatique. Pour supprimer un code QR, envoyez une requête DELETE au point de terminaison Numéro de téléphone WhatsApp Business > Message Qrdls et ajoutez l’ID du code QR à supprimer en tant que paramètre de chemin.

Exemple de requête

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

Exemple de réponse

{
  "success": true
}

Références

En savoir plus