API de administración de WhatsApp Business

Códigos QR y enlaces directos

En esta guía se explica cómo crear y administrar códigos QR mediante la API de administración de WhatsApp Business.

Los clientes pueden escanear un código QR con su teléfono para iniciar rápidamente una conversación con tu empresa. La API de administración de WhatsApp Business te permite crear y acceder a estos códigos QR y enlaces directos asociados.

Si puedes usar Business Manager para administrar tus códigos QR en lugar de la API, consulta Administrar tus códigos QR de WhatsApp.

Antes de empezar

Necesitarás lo siguiente:

Crear un código QR

Para crear un código QR, envía una solicitud POST al extremo Número de teléfono de WhatsApp Business > Qrdls de mensaje.

En el cuerpo de la solicitud, incluye un objeto con la propiedad prefilled_message establecida en el texto del mensaje y la propiedad generate_qr_image establecida en el formato de imagen que prefieras (SVG o PNG).

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Obtener una lista de códigos QR

Para obtener una lista de todos los códigos QR de un número de teléfono de empresa, envía una solicitud GET al extremo Número de teléfono de WhatsApp Business > Qrdls de mensaje.

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Obtener un código QR

Para obtener información sobre un código QR concreto, envía una solicitud GET al extremo Número de teléfono de WhatsApp Business > Qrdls de mensaje y anexa el identificador del código QR como parámetro de ruta.

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Actualizar un código QR

Para actualizar un código QR, envía una solicitud POST al extremo Número de teléfono de WhatsApp Business > Qrdls de mensaje.

En el cuerpo de la solicitud, incluye la propiedad code establecida en el identificador del código QR que quieres actualizar y la propiedad prefilled_message establecida en el nuevo texto del código QR.

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Eliminar un código QR

Los códigos QR no caducan automáticamente. Para eliminar un código QR, envía una solicitud DELETE al extremo Número de teléfono de WhatsApp Business > Qrdls de mensaje y anexa el identificador del código QR que quieres retirar como parámetro de ruta.

Ejemplo de solicitud

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

Ejemplo de respuesta

{
  "success": true
}

Referencia

Más información