Enviar imágenes y archivos en Apple Messages
Usa una plantilla de tipo Image o Document para enviar imágenes de productos, instrucciones o un recibo en una conversación abierta con un cliente. Bird obtiene el archivo de origen y lo prepara para Apple durante el procesamiento del mensaje.
Prepara un archivo accesible
Aloja el archivo en una URL HTTPS pública que se pueda obtener sin cookies de navegador ni inicio de sesión. Usa un archivo específico para ese fin que sea seguro exponer en esa URL. Una página de vista previa de una unidad privada no es una URL directa al archivo.
La referencia de envío de mensajes define las restricciones de contenido multimedia:
| Uso | Requisito |
|---|---|
| Adjunto saliente | Cada archivo pesa menos de 100 MB. Indica el nombre de archivo y el tipo de medio correctos. |
| Interacción nativa o imagen rich-link | PNG, hasta 200 kB por imagen; las imágenes interactivas suman como máximo 5 MB. |
| Icono de app de iMessage publicado | PNG menor de 15 kB. Consulta experiencias de app. |
Mantén la URL disponible mientras se completa el procesamiento. Una URL firmada que expire demasiado pronto puede provocar un fallo después de que el mensaje fue aceptado. Prueba la URL sin un navegador con sesión iniciada y confirma que devuelve el archivo real en lugar de una página HTML.
Configura la plantilla
- Abre Templates y elige New template > Image o Document.
- En Content, asigna un Template name al borrador e introduce un Message útil que explique el adjunto.
- En Apple delivery, configura Attachment URL, File name y Media type. Por ejemplo, un PDF usa un nombre de archivo .pdf y application/pdf.
- Selecciona el negocio en Personalization y guarda el borrador.
- Prepara y revisa el mensaje, verificando el cliente y el archivo reales antes de enviar.
Las imágenes de vista previa incluidas no son una fuente de adjuntos para un envío real. Proporciona tu URL prevista de forma explícita.
Comprueba el resultado
Inspecciona el mensaje enviado y sus eventos, luego abre el adjunto en un dispositivo de prueba Apple autorizado. Comprueba la legibilidad, el nombre del archivo y si el contenido tiene sentido sin el sitio web que lo rodea.
Si el mensaje falla después de ser aceptado, inspecciona su error antes de modificar la plantilla. Las causas habituales incluyen una URL inaccesible, un tipo de medio inesperado, un archivo que supera el límite de tamaño o datos PNG no válidos. Cambiar la extensión de un archivo no convierte su formato.
Los adjuntos entrantes pueden aparecer por nombre en la transcripción de la conversación. La transcripción no ofrece actualmente una acción de descarga autenticada para esos archivos. Las operaciones de recuperación de adjuntos y medios no forman parte de la API pública. Si tu servicio necesita descargar archivos entrantes, confirma un flujo de recuperación disponible con Bird antes de depender de él.