En Plantillas WhatsApp, selecciona tu canal Twilio y un encabezado de imagen, video o documento. Elige un archivo de la biblioteca o carga uno nuevo. La preparación crea un enlace temporal: quien lo reciba podrá descargar la muestra mientras sea válido. Usa muestras sin datos sensibles y revisa el aviso antes de confirmar.

Guardar una versión y solicitar su aprobación siguen siendo pasos separados. También puedes revocar el enlace de la muestra desde el editor. Esto impide nuevas descargas; no elimina el original ni las copias que ya recibió el proveedor.

API de enlaces

Usa una clave de producción con whatsapp_templates:write y files:read. Envía POST /v1/whatsapp-media-links con Bearer e Idempotency-Key:

{
  "channel_account_id": "UUID de tu canal Twilio",
  "file_id": "UUID de tu archivo privado",
  "header_type": "document",
  "purpose": "template_sample"
}

Se admiten imágenes JPEG/PNG de hasta 5 MiB y videos MP4 o documentos PDF de hasta 15 MiB. También aplican los límites del contrato. El canal, su cuenta y el servicio WhatsApp deben estar habilitados.

La respuesta incluye id, url, path, propósito, formato, tamaño y vencimiento. Para guardar la muestra en una versión, usa su ID como header.twilio_sample_id, su URL como header.sample_url y el mismo tipo de encabezado. Conserva vacías las referencias de Meta.

GET /v1/whatsapp-media-links/{id} consulta el enlace. Requiere whatsapp_templates:read y files:read.
DELETE /v1/whatsapp-media-links/{id} lo revoca. Requiere los mismos permisos de creación.
La URL admite GET y HEAD durante su vigencia. El enlace es su credencial; no requiere tu clave de API. No lo publiques en registros ni lo compartas fuera del destino previsto.

Una repetición con la misma clave idempotente recupera el mismo registro; no renueva enlaces vencidos o revocados. Cambiar el propósito, archivo, canal, tipo o vigencia con esa clave se rechaza.

Una muestra y un archivo por envío

La plantilla Twilio guarda una variable de ruta bajo el dominio de archivos de talkHero. La muestra preparada es el ejemplo de esa variable. Para enviar otro archivo, crea un enlace con purpose: "message" y usa su path como valor de la variable multimedia de la plantilla. Mantén el tipo de archivo aprobado. Crear el enlace no envía mensajes ni elimina los controles de consentimiento y consumo del servicio.

La vigencia predeterminada es 72 horas para muestras y 24 horas para archivos de mensajes. Puedes indicar lifetime_hours entre 1 y 168; la retención del archivo puede acortarla. Suspender la cuenta, revocar el enlace, retirar el archivo o cambiar la identidad del canal impide nuevas descargas. Se aplican límites de solicitudes y la respuesta 429 requiere esperar antes de consultar de nuevo.

La publicación requiere un origen HTTPS público configurado por el operador. Si el editor muestra que los enlaces no están habilitados en el entorno, conserva la opción de URL externa. También puedes elegir el archivo desde Mensajes o Campañas, o enviar su file_id a la API. En ese recorrido, talkHero crea el enlace individual cuando despacha cada mensaje y completa la variable de archivo de la plantilla.