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 con la API de administración de WhatsApp Business.

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

Si puedes usar el administrador comercial para administrar los códigos QR en lugar de la API, consulta Administrar tus códigos QR de WhatsApp.

Antes de empezar

Necesitarás lo siguiente:

Crear códigos QR

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

En el cuerpo de la solicitud, incluye un objeto con una propiedad prefilled_message configurada con el texto de tu mensaje y una propiedad generate_qr_image configurada con el formato de imagen que prefieras, que puede ser 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 en un número de teléfono comercial, envía una solicitud GET al punto de conexión Número de teléfono de WhatsApp Business > Qrdls de mensajes.

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 específico, envía una solicitud GET al punto de conexión Número de teléfono de WhatsApp Business > Qrdls de mensaje y adjunta el identificador del código QR como parámetro de la 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 punto de conexión Número de teléfono de WhatsApp Business > Qrdls de mensaje.

En el cuerpo de la publicación, incluye una propiedad code configurada en el identificador del código QR que quieres actualizar y una propiedad prefilled_message configurada en el texto del nuevo 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 punto de conexión Número de teléfono de WhatsApp Business > Qrdls de mensaje y adjunta el identificador del código QR que deseas quitar como parámetro de la 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