API de nube

Enviar plantillas de autenticación

En este documento se describe cómo enviar plantillas de autenticación con botones de contraseña de un solo uso aprobadas.

Solicitud

Usa el extremo Número de teléfono de WhatsApp Business > Mensajes para enviar un mensaje de plantilla de autenticación con un botón de contraseña de un solo uso.

Sintaxis de la solicitud

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Cuerpo de la solicitud POST

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<CUSTOMER_PHONE_NUMBER>",
  "type": "template",
  "template": {
    "name": "<TEMPLATE_NAME>",
    "language": {
      "code": "<TEMPLATE_LANGUAGE_CODE>"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "<ONE-TIME PASSWORD>"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": "0",
        "parameters": [
          {
            "type": "text",
            "text": "<ONE-TIME PASSWORD>"
          }
        ]
      }
    ]
  }
}

Propiedades del cuerpo

Marcador de posiciónDescripciónValor de ejemplo

<CUSTOMER_PHONE_NUMBER>

Número de teléfono de WhatsApp del cliente.

12015553931

<ONE-TIME PASSWORD>

Contraseña de un solo uso o código de verificación que se va a entregar al cliente.


Ten en cuenta que este valor debe aparecer dos veces en la carga útil.


Máximo 15 caracteres.

J$FpnYnP

<TEMPLATE_LANGUAGE_CODE>

Código de idioma y configuración regional de la plantilla.

en_US

<TEMPLATE_NAME>

Nombre de la plantilla.

verification_code

Respuesta

Si la operación se realiza correctamente, la API responderá con lo siguiente:

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "<INPUT>",
      "wa_id": "<WA_ID>"
    }
  ],
  "messages": [
    {
      "id": "<ID>"
    }
  ]
}

Contenido de la respuesta

Marcador de posiciónDescripciónValor de ejemplo

<INPUT>

Cadena

Número de teléfono del cliente al que se envió el mensaje. Es posible que no coincida con el wa_id.

+16315551234

<WA_ID>

Cadena

Identificador de WhatsApp del cliente al que se envió el mensaje. Es posible que no coincida con input.

+16315551234

<ID>

Cadena

Identificador del mensaje de WhatsApp. Puedes utilizar el identificador que se muestra después de “wamid” para hacer un seguimiento del estado del mensaje.

wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI3N0EyQUJDMjFEQzZCQUMzODMA

Ejemplo

Ejemplo de solicitud

curl -L 'https://graph.facebook.com/v19.0/105954558954427/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '{
      "messaging_product": "whatsapp",
      "recipient_type": "individual",
      "to": "12015553931",
      "type": "template",
      "template": {
        "name": "verification_code",
        "language": {
          "code": "en_US"
      },
      "components": [
        {
          "type": "body",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        },
        {
          "type": "button",
          "sub_type": "url",
          "index": "0",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        }
      ]
    }
  }'

Ejemplo de respuesta

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "12015553931",
      "wa_id": "12015553931"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI4Qzc5QkNGNTc5NTMyMDU5QzEA"
    }
  ]
}