Plantillas de utilidad de WhatsApp
Una plantilla de utilidad da seguimiento a algo que el destinatario ya hizo: un pedido, un pago, una reserva o un inicio de sesión. El catálogo de Bird ofrece ocho, entre ellas bird_signin_alert y bird_delivery_update. Consulta la categoría de cada slug en la lista de plantillas, no la deduzcas de su nombre: bird_signin_alert parece una plantilla de autenticación, pero no lo es; es de utilidad.
Antes de enviar
Elige una plantilla gestionada del catálogo o crea una plantilla de utilidad en tu cuenta empresarial conectada.
Para enviar las plantillas del catálogo de Bird no necesitas ninguna verificación propia, igual que con la autenticación. Para crear tu propia plantilla de utilidad tampoco: a diferencia de la autenticación, el requisito de verificación empresarial de Meta nunca se aplica a las plantillas de utilidad, así que puedes crearlas y editarlas en un espacio de trabajo sin verificar. Consulta Verificación empresarial de WhatsApp para saber qué desbloquea la verificación en otros casos.
to puede ser un número de teléfono en formato E.164 o un ID de usuario vinculado a la empresa. Una plantilla de utilidad no lleva botón OTP, por lo que no exige que el destinatario sea un número de teléfono, como sí ocurre con la autenticación.
Todas las plantillas de utilidad gestionadas del catálogo están registradas solo en en, con on_missing_language: fail. Si solicitas un idioma que el catálogo no ofrece, el envío falla en lugar de recurrir al inglés o a otro idioma.
Enviar una plantilla de utilidad
POST /v1/whatsapp/messages con un objeto template que indique un slug del catálogo:
const msg = await bird.whatsapp.send({
to: "+16505551234",
template: {
slug: "bird_order_confirmation",
language: "en",
parameters: { ref: "A1B2C3D4", amount: "USD 49.99" },
},
});
console.log(msg.id, msg.status);msg = client.whatsapp.send(
to="+16505551234",
template="bird_order_confirmation",
language="en",
parameters={"ref": "A1B2C3D4", "amount": "USD 49.99"},
)
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)
}
msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
To: "+16505551234",
Template: "bird_order_confirmation",
Language: "en",
Parameters: map[string]any{"ref": "A1B2C3D4", "amount": "USD 49.99"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$message = $bird->whatsapp->send(
to: '+16505551234',
template: 'bird_order_confirmation',
language: 'en',
parameters: ['ref' => 'A1B2C3D4', 'amount' => 'USD 49.99'],
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--language en \
--parameters '{"amount":"USD 49.99","ref":"A1B2C3D4"}' \
--template bird_order_confirmation \
--to +16505551234curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+16505551234",
"template": {
"slug": "bird_order_confirmation",
"language": "en",
"parameters": {
"ref": "A1B2C3D4",
"amount": "USD 49.99"
}
}
}'Como con cualquier plantilla gestionada, omite from: Bird elige el número de envío según la categoría y la región, y si lo indicas, se devuelve 422 E15018 WhatsAppSenderNotAllowed. Crear tu propia plantilla de utilidad y enviarla funciona igual que cualquier envío de una plantilla propia; consulta Enviar con una plantilla para ver el contrato general.
Cómo rellenar las variables
Las variables de utilidad tienen nombre, así que cada una es su propia clave en parameters, como ref y amount. Un botón de URL con un sufijo numerado {{1}} usa en su lugar la clave button_url. Un sufijo con nombre usa su propio nombre. El envío lleva solo el valor, no la dirección completa:
{ "parameters": { "ref": "A1B2C3D4", "button_url": "A-4192" } }En cambio, un envío components nombra cada parámetro del cuerpo, y el orden de un parámetro con nombre dentro del array no tiene ningún significado. Para las reglas comunes sobre componentes, sub_type y la correspondencia entre los components de un envío y los marcadores declarados en una plantilla, consulta Enviar con una plantilla y Componentes y parámetros.
Coste
Una plantilla de utilidad entregada dentro de una ventana de atención al cliente abierta tiene la tarifa gratuita de Meta hasta el 30 de septiembre de 2026. A partir del 1 de octubre de 2026, Meta la cobra como cualquier otra plantilla de utilidad (cambios de precios de octubre de 2026). La tarifa de salida de Bird se cobra durante el procesamiento del mensaje, antes del envío a Meta. Una notificación posterior de entregado o leído determina si se aplica una tarifa de Meta. Ten en cuenta ambos componentes al estimar el total.
Consulta Coste y facturación para saber cuándo se cobra un envío, y precios de WhatsApp para ver las tarifas.
Puntos a tener en cuenta
- Meta puede recategorizar por iniciativa propia una plantilla de utilidad como marketing, y el mensaje se sigue enviando al nuevo precio, más alto. Desde abril de 2025, una empresa a la que Meta ya ha advertido por una categorización incorrecta no recibe ningún aviso previo: el cambio se aplica al instante. No incluyas lenguaje promocional, ofertas ni ventas adicionales en el texto de una plantilla de utilidad, porque es lo que provoca el cambio. Consulta las Directrices de plantillas para saber qué se considera promocional.
- Un encabezado
gifo un botóncopy_codese rechazan fuera de marketing. Ambos son componentes exclusivos de marketing; declarar cualquiera de ellos en una plantilla de utilidad provoca un error. - En un envío
componentscon plantilla propia no se comprueba el número de parámetros antes de cobrarlo. Si envías un número incorrecto de parámetros encomponentscon una plantilla tuya, el mensaje se acepta y se cobra, y después Meta lo rechaza. Un envíoparametersal que le falta una clave obligatoria se rechaza antes de cualquier cobro, y los envíos con plantillas gestionadas del catálogo no tienen este problema. - Un remitente en la cuenta de WhatsApp Business incorrecta se rechaza antes de cualquier cobro.
fromtiene que estar en la misma cuenta que la plantilla; si no, el envío falla422E15023WhatsAppSenderWABAMismatch.
Siguientes pasos
- Plantillas de WhatsApp: cómo explorar el catálogo y el contrato común para enviar con plantilla
- Plantillas de autenticación: códigos de verificación de un solo uso y el requisito de verificación para crear una
- Plantillas de marketing: envíos promocionales y la cuenta que necesitas para crear una
Recursos relacionados
Continúa con la documentación, guías y ejemplos de este tema.