Plantillas de autenticación de WhatsApp

Antes de enviar

Enviar un código de verificación

const msg = await bird.whatsapp.send({
  to: "+14155550100",
  template: {
    slug: "bird_otp",
    language: "en",
    components: [{ type: "body", parameters: [{ type: "text", text: "481920" }] }],
  },
});
console.log(msg.id, msg.status);

msg = client.whatsapp.send(
    to="+14155550100",
    template="bird_otp",
    language="en",
    components=[{"type": "body", "parameters": [{"type": "text", "text": "481920"}]}],
)
print(msg.id, msg.status)

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	bird "github.com/messagebird/bird-sdk-go"
	"github.com/messagebird/bird-sdk-go/option"
)

func main() {
	client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
	if err != nil {
		log.Fatal(err)
	}
	code := "481920"
	components := []bird.WhatsAppMessageTemplateComponent{{
		Type:       "body",
		Parameters: &[]bird.WhatsAppMessageTemplateComponentParameter{{Type: "text", Text: &code}},
	}}
	msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
		To:       "+14155550100",
		Template: "bird_otp",
		Language: "en",
		Components: components,
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(msg.Id, *msg.Status)
}

$components = [
    (new WhatsAppMessageTemplateComponent())
        ->setType('body')
        ->setParameters([
            (new WhatsAppMessageTemplateComponentParameter())->setType('text')->setText('481920'),
        ]),
];
$message = $bird->whatsapp->send(
    to: '+14155550100',
    template: 'bird_otp',
    language: 'en',
    components: $components,
);
echo $message->getId(), ' ', $message->getStatus();

bird whatsapp send \
  --components '[{"parameters":[{"text":"481920","type":"text"}],"type":"body"}]' \
  --language en \
  --template bird_otp \
  --to +14155550100

{
  "name": "whatsapp_send",
  "arguments": {
    "template": {
      "components": [
        {
          "parameters": [
            {
              "text": "481920",
              "type": "text"
            }
          ],
          "type": "body"
        }
      ],
      "language": "en",
      "slug": "bird_otp"
    },
    "to": "+14155550100"
  }
}

curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "to": "+14155550100",
      "template": {
        "slug": "bird_otp",
        "language": "en",
        "components": [
          {
            "type": "body",
            "parameters": [
              {
                "type": "text",
                "text": "481920"
              }
            ]
          }
        ]
      }
    }'

• Omite from. Una plantilla gestionada por Bird elige su propio remitente, según la categoría y la región, por lo que establecer from devuelve 422 E15018 WhatsAppSenderNotAllowed. Es lo contrario de un envío libre, que requiere from; vale la pena recordarlo si llegas aquí desde las páginas de mensajes interactivos.
• to debe ser un número de teléfono E.164. Una plantilla de autenticación no puede dirigirse a un ID de usuario con alcance de negocio; eso es 422 E15014 WhatsAppRecipientNotSupportedForTemplate.
• El cuerpo acepta exactamente un parámetro posicional: el código. Cero parámetros, o nombrar el parámetro, devuelve 422 E15003 WhatsAppTemplateParameterMismatch. Autenticación es la única categoría que Meta escribe posicionalmente; todas las demás nombran sus parámetros.
• No se necesita ventana de atención al cliente. Los envíos con plantilla no están limitados por ventana, que es justamente la razón por la que existe una plantilla de código de verificación: tiene que llegar a alguien que nunca te ha escrito antes.

El botón de copiar código

{ "type": "button", "parameters": [{ "type": "text", "text": "481920" }] }

Qué permite Meta en una plantilla de autenticación

Costo

Aspectos a tener en cuenta

• Las plantillas predefinidas de Bird no se entregan a nueve países. bird_otp y bird_otp_authifly envían desde las WhatsApp Business Accounts propias de Bird, y esas cuentas no llevan mensajes de autenticación a Egipto, India, Indonesia, Malasia, Nigeria, Pakistán, Arabia Saudita, Sudáfrica ni los Emiratos Árabes Unidos. Ese envío se rechaza con 422 E15063 WhatsAppDestinationRestricted antes de que se cobre nada. Una plantilla que creaste en tu propia cuenta, enviada desde tu propio número, llega a estos países con normalidad. Verify también llega a ellos, moviendo el código de verificación a otro canal por su cuenta.
• Un envío con plantilla propia requiere from, y debe estar en la misma WhatsApp Business Account que la plantilla. Un remitente en una cuenta diferente se rechaza con 422 E15023 WhatsAppSenderWABAMismatch antes de que se cobre nada.
• Solo un idioma cuya versión esté aprobada y activa se puede enviar. Un idioma en borrador, pendiente, rechazado o pausado no.
• Meta puede recategorizar una plantilla por iniciativa propia. No hay forma de rechazarlo, y arrastra las reglas de precio y entrega que siguen a la categoría.
• La categoría de la plantilla y la categoría de su idioma pueden diferir. Consulta Plantillas de WhatsApp para saber cómo la ruta de envío resuelve esto.
• Una plantilla de autenticación ingestada no se puede duplicar. Bird no puede leer el texto generado por WhatsApp para convertirlo en la configuración a partir de la cual se construye una plantilla nueva; eso es 422 E15024 WhatsAppTemplateContentNotDuplicable. Crea una nueva con su propia recomendación de seguridad y expiración de código.

Próximos pasos

• Plantillas de WhatsApp: explorar el catálogo y el contrato compartido de envío por plantilla
• Plantillas de utilidad: actualizaciones de pedidos, recordatorios de citas y avisos de cuenta
• Verificación empresarial de WhatsApp: cómo funciona la verificación y qué más desbloquea