Plantillas de marketing de WhatsApp
Una plantilla de marketing lleva contenido promocional, como una oferta, el anuncio de un producto o un cupón. Antes de enviar, prepara contenido aprobado, el permiso del destinatario y una forma clara de gestionar las respuestas y las bajas.
WhatsApp Studio envía a un destinatario cada vez. Una difusión envía una plantilla de marketing a toda una audiencia desde el panel. Para planificar una campaña, consulta WhatsApp Studio y campañas de marketing.
Antes de enviar
El catálogo gestionado de Bird no incluye ninguna plantilla de marketing, así que un envío de marketing siempre usa una plantilla creada por tu espacio de trabajo, en una WhatsApp Business Account propia:
- Conecta una WhatsApp Business Account y un número propio. Consulta Configuración del número de teléfono.
- Crea una plantilla de marketing y envíala a revisión. Consulta las Directrices de plantillas para saber qué se aprueba.
- Envía desde un número de la misma WhatsApp Business Account que la plantilla.
fromes obligatorio en un envío de marketing, y un remitente de otra cuenta se rechaza422E15023WhatsAppSenderWABAMismatchantes de que se cobre nada.
Enviar una plantilla de marketing
POST /v1/whatsapp/messages con from definido y un objeto template que indique tu propio slug:
const msg = await bird.whatsapp.send({
to: "+16505551234",
from: "+13125550101",
template: {
slug: "summer_sale",
language: "en",
parameters: {
header_url: "https://cdn.example.com/banners/summer.png",
first_name: "Pablo",
code: "SUMMER25",
},
},
});
console.log(msg.id, msg.status);msg = client.whatsapp.send(
to="+16505551234",
from_="+13125550101",
template="summer_sale",
language="en",
parameters={
"header_url": "https://cdn.example.com/banners/summer.png",
"first_name": "Pablo",
"code": "SUMMER25",
},
)
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",
From: "+13125550101",
Template: "summer_sale",
Language: "en",
Parameters: map[string]any{
"header_url": "https://cdn.example.com/banners/summer.png",
"first_name": "Pablo",
"code": "SUMMER25",
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$message = $bird->whatsapp->send(
to: '+16505551234',
from: '+13125550101',
template: 'summer_sale',
language: 'en',
parameters: [
'header_url' => 'https://cdn.example.com/banners/summer.png',
'first_name' => 'Pablo',
'code' => 'SUMMER25',
],
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--from +13125550101 \
--language en \
--parameters '{"code":"SUMMER25","first_name":"Pablo","header_url":"https://cdn.example.com/banners/summer.png"}' \
--template summer_sale \
--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",
"from": "+13125550101",
"template": {
"slug": "summer_sale",
"language": "en",
"parameters": {
"header_url": "https://cdn.example.com/banners/summer.png",
"first_name": "Pablo",
"code": "SUMMER25"
}
}
}'- Las variables del cuerpo tienen nombre, igual que en las plantillas de utilidad, así que
first_namees su propia clave. - El código de un botón de cupón va en
code, como en el ejemplo anterior. No hay una clave de cupón aparte. - Un encabezado multimedia usa
header_url, tanto si es una imagen como un vídeo o ungif. Si lo omites, se envía la muestra aprobada de la plantilla. Una plantilla importada de Meta no tiene muestra, así que necesitaheader_url. Marketing es la única categoría que acepta un encabezado de GIF animado. - El contenido multimedia y el sufijo de URL numerado de cada tarjeta de carrusel usan claves numeradas:
header_url_1ybutton_url_1para la primera tarjeta,header_url_2para la segunda, y así sucesivamente. Pon nombre a las variables dentro de las tarjetas. Un nombre usado en dos tarjetas es una sola clave, así que ambas tarjetas reciben el mismo valor. Un carrusel en el que cada tarjeta numera un{{1}}solo usacomponents, con los valores encards, y ese envío debe incluir exactamente el número de tarjetas con el que se aprobó la plantilla.
Bird dirige automáticamente cada envío de marketing a la API Marketing Messages de Meta; no tienes que activarlo y no hay un interruptor por envío. El estado de incorporación de la cuenta de empresa a esa API determina las optimizaciones de Meta, no la entrega en sí, salvo en los encabezados gif y las plantillas con precio máximo, que requieren una cuenta incorporada. Consulta Plantillas de marketing para ver el estado de la cuenta, qué habilita la incorporación y en qué países está limitado el marketing.
Bajas
Cuando Bird recibe de Meta un evento válido de baja de marketing, registra una preferencia del destinatario para esa cuenta de empresa. Esta preferencia es independiente de una supresión de todos los mensajes. Comprueba ambos registros antes de enviar. Un fallo de entrega puede llegar antes que el evento de preferencia correspondiente; respeta la decisión del destinatario e investiga ese historial en lugar de reintentar. Consulta Preferencias para registrar y leer estos registros.
Coste
Usa la tarifa de marketing publicada para el destino y la moneda, o fija un precio máximo para pagar un cargo de entrega variable de Meta hasta tu límite. Bird cobra su tarifa de salida antes del envío a Meta; un resultado de entrega o lectura facturable puede añadir la tarifa de Meta. Consulta Coste y facturación y Precios de WhatsApp.
Aspectos a tener en cuenta
- La categoría de Meta determina el precio. Meta puede reclasificar contenido promocional como marketing después de la aprobación. Revisa la categoría actual de cada idioma antes de enviar; un envío con precio máximo requiere la categoría de marketing. Consulta el proceso de revisión de categorías de Meta si no estás de acuerdo con la clasificación.
131049es una pausa de entrega, no una limitación de solicitudes que hayas configurado, y reintentar la empeora. Meta devuelve131049tanto por su pausa general en EE. UU. como por un límite de marketing por usuario, y recomienda esperar aproximadamente un día antes de reenviar. Si reenvías antes, la cuenta puede quedar no disponible para ese destinatario durante más tiempo y tu propia tasa de entrega se distorsiona. Bird informa del fallo comorate_limited.131050significa que el destinatario desactivó "Offers and announcements", y nunca debes reintentarlo. Meta acepta el envío y después se niega a entregarlo. La respuesta correcta es la vía de preferencias de mensajería, no un reenvío: suprime tú mismo al destinatario o espera a que vuelva a activar la entrega, algo de lo que Bird se entera mediante el mismo mecanismo de preferencias que notificó la baja. Consulta Preferencias.132015y132016indican una pausa de la plantilla, no un problema del destinatario.132015es una pausa por baja calidad;132016es la desactivación permanente tras pausas repetidas, y la única solución es una plantilla nueva con contenido distinto. Comprueba el estado del idioma concreto en lugar del de la plantilla, porque un idioma en pausa deja de enviar de inmediato.- Un remitente en la WhatsApp Business Account equivocada se rechaza antes de cualquier cargo.
fromtiene que estar en la misma cuenta que la plantilla; si no, el envío falla422E15023WhatsAppSenderWABAMismatch.
Próximos pasos
- Plantillas de WhatsApp: cómo explorar el catálogo y el contrato común de envío por plantilla
- Plantillas de marketing: la API de Marketing Messages, el estado de incorporación y dónde está limitado el marketing
- Preferencias: cómo registrar y consultar las declaraciones de los destinatarios
- Plantillas de utilidad: actualizaciones de pedidos, recordatorios de citas y avisos de cuenta
Recursos relacionados
Continúa con la documentación, guías y ejemplos de este tema.