Formatos de mensajes e imágenes de WhatsApp
Aquí encontrarás los requisitos de estructura de mensajes, componentes y activos multimedia para crear mensajes y plantillas de WhatsApp.
Hay dos tipos de mensajes de WhatsApp en Braze: mensajes de plantilla y mensajes de respuesta.
| Tipo de mensaje | Cuándo se usa | Aprobación de Meta |
|---|---|---|
| Mensajes de plantilla | Comunicación iniciada por la empresa; se envían en cualquier momento | Obligatoria; las plantillas deben enviarse a Meta y aprobarse antes del envío. |
| Mensajes de respuesta | Respuestas a mensajes iniciados por el usuario; solo dentro de la ventana de conversación de 24 horas | No obligatoria |
Los mensajes de plantilla deben enviarse a Meta para su aprobación, lo que puede tardar hasta 24 horas. Una vez aprobados, se pueden enviar en cualquier momento. Los mensajes de respuesta (llamados “mensajes de sesión” en la documentación de Meta) solo se pueden enviar mientras haya una ventana de conversación activa abierta, es decir, dentro de las 24 horas posteriores al último mensaje entrante del usuario.
Mensajes de plantilla
Los mensajes de plantilla de WhatsApp son formatos de mensaje preaprobados que se utilizan para la comunicación iniciada por la empresa. En Braze, se construyen a partir de componentes que defines antes de enviarlos a Meta. Todos los mensajes de plantilla se basan en categorías: marketing, utilidad o autenticación.
Plantillas de marketing
Las plantillas de marketing son el tipo más común utilizado en Braze. Constan de hasta cuatro componentes:
| Componente | Obligatorio | Notas |
|---|---|---|
| Encabezado | No | Admite texto, imagen, video, documento o ubicación. Consulta las especificaciones multimedia para los requisitos de tipo de archivo, tamaño y dimensiones. |
| Cuerpo | Sí | El contenido principal del mensaje |
| Pie de página | No | Texto complementario que se muestra debajo del cuerpo |
| Botones | No | Incluye hasta 10 botones (se admiten todos los tipos de botones) |
Longitud de caracteres
| Componente | Longitud máxima de caracteres |
|---|---|
| Cuerpo | 1024 caracteres |
| Pie de página | 60 caracteres |
| Etiqueta de botón (URL, teléfono, respuesta rápida) | 25 caracteres |
| Número de teléfono (en botón de teléfono) | 20 caracteres |
| Nombre de plantilla | 512 caracteres (solo minúsculas, alfanuméricos y guiones bajos) |
Tipos de botones
| Tipo de botón | Comportamiento | Notas |
|---|---|---|
| Respuesta rápida | Envía el texto de la etiqueta del botón como respuesta en la conversación | |
| URL | Abre una URL en el navegador predeterminado del usuario; admite 1 variable añadida al final de la URL (máximo 2000 caracteres) | |
| Número de teléfono | Inicia una llamada al número de teléfono especificado | |
| Copiar código de cupón | Copia un código de cupón al portapapeles del usuario | Siempre requiere aprobación de Meta |
Formato de parámetros
Las variables de plantilla pueden usar parámetros con nombre (como {{first_name}}) o parámetros posicionales (como {{1}}). En Braze, las variables se pueden reemplazar con Liquid o texto plano. Incluye siempre valores predeterminados para las variables Liquid; los mensajes con valores de variables faltantes no se enviarán.
Plantillas de carrusel con tarjetas multimedia
Las plantillas de carrusel muestran un cuerpo de mensaje seguido de 2 a 10 tarjetas de producto desplazables horizontalmente, cada una con su propio activo multimedia y botones. Solo están disponibles para mensajes de plantilla de marketing.
Mensaje de nivel superior
| Componente | Obligatorio | Propiedades máximas | Notas |
|---|---|---|---|
| Texto del cuerpo | Sí | 1024 caracteres | Admite variables |
| Tarjetas | Sí | 2-10 tarjetas | El número de tarjetas se fija en la creación de la plantilla. Una plantilla de carrusel aprobada solo se puede enviar con el número exacto de tarjetas definido durante la creación. |
Especificaciones por tarjeta
| Componente | Obligatorio | Notas |
|---|---|---|
| Encabezado (imagen o video) | Sí | Todas las tarjetas deben usar el mismo formato (todas imagen o todas video). Esto incluye la misma estructura de componentes; no puedes mezclar tarjetas con y sin texto del cuerpo o botones. Los activos del encabezado de la tarjeta se recortan automáticamente a una proporción ancha según el dispositivo del usuario. |
| Texto del cuerpo | No | Si alguna tarjeta incluye texto del cuerpo, todas las tarjetas deben incluir texto del cuerpo |
| Botones | No | Máximo 2 botones por tarjeta |
Longitud de caracteres por tarjeta
| Componente | Longitud máxima de caracteres | Notas |
|---|---|---|
| Texto del cuerpo de la tarjeta | 160 caracteres | |
| Etiqueta de botón | 25 caracteres | |
| Número de teléfono (en botón de teléfono) | 20 caracteres | |
| URL (en botón de URL) | 2000 caracteres; admite 1 variable añadida al final | Los botones de URL se abren en el navegador predeterminado del usuario, fuera de WhatsApp. No se activan webhooks de pedidos ni de conversión a partir de ese punto. |
Mensajes de respuesta
Los mensajes de respuesta (también llamados “mensajes de sesión” por Meta) solo se pueden enviar dentro de la ventana de conversación de 24 horas. Se abren y se reinician cuando un usuario envía un mensaje a tu empresa.
Los mensajes de respuesta que se redactan directamente en el editor de Campaign o Canvas de Braze no requieren aprobación de Meta.
Braze admite siete diseños de mensajes de respuesta:
| Diseño de mensaje | Descripción |
|---|---|
| Texto | Texto del cuerpo del mensaje en texto plano |
| Multimedia | Mensaje con un adjunto de imagen, video, audio o documento |
| Respuesta rápida | Mensaje con hasta 3 botones de respuesta que se pueden tocar |
| Botón de llamada a la acción (CTA) | Mensaje con un botón de URL o un botón de número de teléfono |
| Mensaje de lista | Mensaje con una lista estructurada y desplazable de opciones seleccionables |
| Mensaje de flujo | Mensaje que solicita a los usuarios completar un formulario o tarea interactiva en WhatsApp, con el resultado regresando a Braze |
| Mensaje de producto de Meta | Mensaje que destaca un solo producto, múltiples productos o un catálogo completo de un catálogo de Meta conectado |
Componentes de mensaje de lista
| Componente | Propiedades máximas |
|---|---|
| Texto del cuerpo | 4096 caracteres |
| Etiqueta de botón (para abrir la lista) | 20 caracteres |
| Número de secciones | Hasta 10 |
| Número de filas por sección | Hasta 10 |
| Título de sección | 24 caracteres |
| Título de fila | 24 caracteres |
| Descripción de fila | 72 caracteres |
Componentes de respuesta rápida
| Componente | Propiedades máximas |
|---|---|
| Botón | Hasta 3 |
| Etiqueta de botón | 20 caracteres por botón |
Especificaciones multimedia
Las siguientes especificaciones se aplican a todos los archivos multimedia en encabezados de plantillas de WhatsApp, mensajes de respuesta o mensajes multimedia independientes.
La Biblioteca de medios de Braze solo admite imágenes y video. Los archivos de audio y los documentos deben referenciarse a través de una URL alojada.
Imágenes
Estas especificaciones se aplican a los encabezados de plantilla, los mensajes multimedia de respuesta y los mensajes de imagen.
| Propiedad | Especificaciones | Notas |
|---|---|---|
| Formatos compatibles | JPEG, PNG | Meta solo admite oficialmente JPEG y PNG para mensajes de imagen. WebP solo es compatible con stickers (no con mensajes de imagen estándar). |
| Tamaño máximo de archivo | 5 MB | |
| Modo de color | 8 bits, RGB o RGBA | |
| Pie de imagen (solo mensajes de imagen) | Opcional; 1024 caracteres como máximo | |
| Dimensiones recomendadas | 1125 × 600 px | Recomendamos usar imágenes JPEG o PNG de 1125×600 px (1,91:1) para una visualización uniforme en todos los dispositivos y cumplir con los requisitos de Meta. |
| Relación de aspecto recomendada | 1,91:1 (panorámica) | Se aceptan los formatos cuadrado (1:1) y panorámico (16:9), pero las imágenes pueden recortarse o ampliarse según el dispositivo del usuario. Para las tarjetas de carrusel, WhatsApp recorta automáticamente las imágenes del encabezado a una relación panorámica, a menos que no haya texto del cuerpo, en cuyo caso se muestra como cuadrada. |
Video
Las siguientes especificaciones se aplican a los encabezados de plantilla, los mensajes multimedia de respuesta, los mensajes de video y los encabezados de tarjetas de carrusel.
| Propiedad | Especificaciones |
|---|---|
| Formatos compatibles | MP4, 3GPP |
| Tamaño de archivo | 16 MB como máximo |
| Códec de video | Solo H.264 |
| Códec de audio | Solo AAC |
| Pistas de audio | Una sola pista de audio o sin pista de audio |
| Pie de video (solo mensajes de video) | Opcional; 1024 caracteres como máximo |
| Relación de aspecto recomendada | 1,91:1 (panorámica) |
Meta tiene un problema conocido que puede impedir que algunos videos MP4 se reproduzcan en dispositivos Android debido a configuraciones específicas de codificación o contenedor. Hasta que haya una solución permanente disponible, reformatear el archivo MP4 resuelve el problema para la mayoría de los remitentes. Prueba todos los videos en dispositivos Android para confirmar la capacidad de entrega correcta.
Puedes reformatear el archivo MP4 utilizando una herramienta web, como CloudConvert. Carga tu archivo MP4 en la herramienta, conviértelo a MP4 de nuevo y luego descarga el archivo convertido.
Compatibilidad con Android
El perfil H.264 “High” codificado con B-frames no es compatible con los clientes de WhatsApp en Android. Usa el perfil H.264 “Main” sin B-frames o el perfil “Baseline” para la mayor compatibilidad. Si recodificas con ffmpeg, usa la bandera -movflags faststart para colocar los bloques moov antes de los bloques mdat.
Audio
Las siguientes especificaciones se aplican a los mensajes multimedia de respuesta y a los mensajes de audio, y se basan en su tipo de audio: mensaje de voz o mensaje de audio básico.
Mensaje de voz
Un mensaje de voz funciona como una nota de voz grabada, con controles de reproducción y soporte de transcripción.
| Propiedad | Especificaciones |
|---|---|
| Formato obligatorio | Solo OGG |
| Códec obligatorio | Solo OPUS (entrada mono) |
| Tamaño de archivo | Máximo 16 MB |
| Icono de reproducción | Este icono solo aparece si el archivo es de 512 KB o menos; los archivos más grandes muestran un icono de descarga |
| Transcripción | Se muestra automáticamente si el usuario tiene habilitadas las transcripciones de voz de WhatsApp |
Mensaje de audio básico
Las siguientes especificaciones se aplican al uso compartido de archivos de audio estándar (clips de música, anuncios de audio y archivos de sonido).
| Formato | Extensión | Tamaño máximo de archivo | Notas |
|---|---|---|---|
| AAC | .aac | 16 MB | |
| AMR | .amr | 16 MB | |
| MP3 | .mp3 | 16 MB | |
| MP4 Audio | .m4a | 16 MB | |
| OGG (códec OPUS) | .ogg | 16 MB | Los archivos OGG deben usar el códec OPUS. El formato base audio/ogg sin OPUS no es compatible.Los archivos OGG/OPUS enviados como mensajes de audio básicos mostrarán un icono de micrófono (igual que los mensajes de voz) en lugar de un icono de música. |
Consideraciones
La Biblioteca de medios de Braze solo admite imágenes y video. Los archivos de audio y los documentos deben referenciarse a través de una URL alojada.
- No hay soporte de subtítulos para mensajes de audio.
- Un error común son los tipos MIME no coincidentes. Verifica que el tipo MIME de tu archivo coincida con su extensión antes de enviarlo.
Documentos
Las siguientes especificaciones se aplican a los encabezados de plantillas (formato de documento), mensajes multimedia de respuesta y mensajes de documentos.
| Tipo de documento | Tipos de archivo | Tamaño máximo de archivo |
|---|---|---|
| 100 MB | ||
| Microsoft Word | DOC, DOCX | 100 MB |
| Microsoft Excel | XLS, XLSX | 100 MB |
| Microsoft PowerPoint | PPT, PPTX | 100 MB |
| Texto plano | TXT | 100 MB |
Consideraciones
La Biblioteca de medios de Braze solo admite imágenes y video. Los archivos de audio y los documentos deben referenciarse a través de una URL alojada.
- Los subtítulos son opcionales y pueden tener un máximo de 1024 caracteres.
- El nombre de archivo es opcional. WhatsApp usa la extensión del archivo para determinar qué icono de documento mostrar en la conversación.
- Solo los formatos listados son oficialmente compatibles. Otros tipos de archivo pueden enviarse, pero no se garantiza que se muestren correctamente en WhatsApp.
Referencia rápida: especificaciones multimedia de WhatsApp
| Tipo de multimedia | Tipos de archivo | Tamaño máximo de archivo | Disponibilidad de subtítulos |
|---|---|---|---|
| Imagen | JPEG, PNG | 5 MB | Sí (máximo 1024 caracteres) |
| Video | MP4, 3GPP | 16 MB | Sí (máximo 1024 caracteres) |
| Audio (voz) | OGG (OPUS) | 16 MB | No |
| Audio (básico) | AAC, AMR, MP3, M4A, OGG | 16 MB | No |
| Documento | PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT | 100 MB | Sí (máximo 1024 caracteres) |