Documentación

Adjuntos de WhatsApp

Envía archivos de tu biblioteca desde Mensajes, Campañas o la API.

En Mensajes → Nuevo mensaje, elige el canal y una plantilla aprobada con archivo. Completa sus variables y usa Elegir archivo para enviar. Puedes seleccionar o cargar un archivo de la biblioteca. El archivo se comparte con el destinatario; la biblioteca conserva el original privado.

En Campañas, elige el archivo al preparar el contenido y comprueba la vista previa antes de aprobar. La campaña conserva el archivo revisado y verifica que siga disponible al enviar. El enlace temporal de cada mensaje comienza su vigencia cuando se despacha, no cuando guardas el borrador.

Enviar mediante API

Usa POST /v1/messages, Bearer de producción, Idempotency-Key y permisos messages:write más files:read:

{
  "channel_account_id": "UUID del canal",
  "recipient_identity_id": "UUID del destinatario",
  "purpose": "service",
  "content": {
    "whatsapp_template": {
      "id": "UUID de la plantilla",
      "variables": { "1": "Leo" },
      "file_id": "UUID del archivo"
    }
  }
}

El archivo debe pertenecer al mismo cliente y al entorno de producción. Usa un archivo compatible con el encabezado aprobado. No combines file_id con header_media ni envíes propiedades internas del archivo. La finalidad debe coincidir con la categoría de la plantilla.

Para Twilio, crea primero la plantilla con una muestra de biblioteca. La API completa su variable de archivo: omite esa variable en variables cuando envíes file_id. Puedes seguir usando URLs externas para las otras plantillas.

Si pierdes la respuesta, repite el mismo cuerpo y clave idempotente. Consulta el estado de la operación; no generes otra clave para recuperar un envío incierto. La API separa aceptación, entrega y consumo confirmado.

Disponibilidad y límites

La cuenta de WhatsApp, el canal, el contrato y el archivo deben seguir activos. Si el archivo se elimina, vence o cambia después de aprobar el contenido, el envío se detiene antes de contactar al proveedor. El enlace de entrega tiene una vigencia máxima de 24 horas, acotada por la retención del archivo. Revocarlo no elimina copias ya recibidas.

Meta admite JPEG/PNG hasta 5 MiB, MP4 hasta 16 MiB y PDF hasta 100 MiB en esta integración. Twilio admite JPEG/PNG hasta 5 MiB y MP4/PDF hasta 15 MiB. También aplican las cuotas de tu contrato y la aprobación del formato por tu proveedor.

Si el selector indica que falta habilitar el origen público, el operador debe configurar el servicio HTTPS de archivos. Los enlaces externos permanecen disponibles. La campaña selecciona un archivo común; puedes personalizar el texto por destinatario.