Sign inGet Started

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:

  1. Conecta una WhatsApp Business Account y un número propio. Consulta Configuración del número de teléfono.
  2. Crea una plantilla de marketing y envíala a revisión. Consulta las Directrices de plantillas para saber qué se aprueba.
  3. Envía desde un número de la misma WhatsApp Business Account que la plantilla. from es obligatorio en un envío de marketing, y un remitente de otra cuenta se rechaza 422 E15023 WhatsAppSenderWABAMismatch antes 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);
  • Las variables del cuerpo tienen nombre, igual que en las plantillas de utilidad, así que first_name es 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 un gif. Si lo omites, se envía la muestra aprobada de la plantilla. Una plantilla importada de Meta no tiene muestra, así que necesita header_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_1 y button_url_1 para la primera tarjeta, header_url_2 para 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 usa components, con los valores en cards, 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.
  • 131049 es una pausa de entrega, no una limitación de solicitudes que hayas configurado, y reintentar la empeora. Meta devuelve 131049 tanto 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 como rate_limited.
  • 131050 significa 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.
  • 132015 y 132016 indican una pausa de la plantilla, no un problema del destinatario. 132015 es una pausa por baja calidad; 132016 es 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. from tiene que estar en la misma cuenta que la plantilla; si no, el envío falla 422 E15023 WhatsAppSenderWABAMismatch.

Próximos pasos