En Plantillas WhatsApp, elige tu canal Meta directo y agrega un encabezado de imagen, video o documento. Puedes seleccionar un archivo de tu biblioteca o cargar uno nuevo. Revisa y confirma la preparación: talkHero comparte una copia con Meta, conserva el archivo original privado y registra la acción.

Preparar una muestra y guardar una versión no envían mensajes. La aprobación de la plantilla se solicita en un paso separado.

Desde tu servidor

Primero carga un archivo privado y conserva su ID. Usa una clave de producción con whatsapp_templates:write y files:read para enviar POST /v1/whatsapp-template-samples, con Bearer e Idempotency-Key:

{
  "channel_account_id": "UUID de tu canal Meta",
  "file_id": "UUID de tu archivo",
  "header_type": "document"
}

El canal debe estar activo, su cuenta Meta habilitada y tu contrato debe incluir WhatsApp. Los archivos de pruebas no se comparten como muestras de producción.

Formatos: image para JPEG/PNG hasta 5 MiB, video para MP4 hasta 16 MiB y document para PDF hasta 100 MiB. También aplican los límites de almacenamiento de tu contrato.

Consulta la solicitud con GET /v1/whatsapp-template-samples/{id} y whatsapp_templates:read. Cuando devuelve ready, guarda en el encabezado de la versión meta_sample_id con el ID de esa muestra, meta_handle con el identificador recibido y sample_url vacío. Conserva el mismo canal y formato. La API comprueba esa relación al guardar y al solicitar aprobación.

Interrupciones

Si pierdes la respuesta inicial, repite el mismo cuerpo y la misma Idempotency-Key. Para recuperar una solicitud pendiente usa POST /v1/whatsapp-template-samples/{id}/resume. El servidor consulta cuánto recibió Meta y recupera esa misma sesión cuando dispone de su ID.

Si el estado queda incierto, no crees copias automáticamente. meta_sample_receipt_missing indica que Meta recibió todos los bytes pero no se pudo confirmar el identificador final; la muestra necesita revisión.

Una muestra tiene 24 horas de vigencia en talkHero. La disponibilidad también depende de la retención del archivo y del estado del canal y su cuenta. La copia que recibe Meta tiene su propia retención. Eliminar el archivo de la biblioteca no revoca una plantilla previamente enviada al proveedor.

La biblioteca está integrada con muestras de Meta directa. Twilio dispone de enlaces temporales y muestras de biblioteca, además de la URL externa de muestra. Las muestras de aprobación tampoco sustituyen el adjunto de cada mensaje enviado.