Adjunte un archivo desde un metacampo de pedido o de cliente
Adjunta en Shopify Flow el PDF guardado en un metacampo de pedido o cliente: configuración, permisos y metacampos vacíos.
Muchas aplicaciones guardan un archivo relacionado con el pedido o el cliente: una factura o un albarán en formato PDF desde una aplicación de facturación, un certificado o un contrato firmado. Shopify lo almacena en un metacampo, ya sea como un archivo en su «Shopify Files» o como un enlace al archivo. Esta aplicación puede adjuntar ese archivo al correo electrónico que envía un flujo de trabajo de Shopify Flow, sin que usted tenga que subir ni vincular nada manualmente.
Cómo funciona
- Otra aplicación (o usted mismo) introduce el archivo, o un enlace al mismo, en un metacampo del pedido o del cliente. En su panel de administración de Shopify, se encuentra en Configuración > Datos personalizados > Pedidos (o Clientes): una definición de tipo «Archivo», «URL» o un campo de texto en el que una aplicación introduce un enlace.
- En una plantilla de correo electrónico, se añade un archivo adjunto y se selecciona «Metacampo» como origen; a continuación, se elige esa definición. El selector muestra lo que contiene cada uno: un archivo, un enlace o una lista de cualquiera de ambos.
- En Shopify Flow, el paso «Enviar correo electrónico transaccional» o «Enviar correo electrónico de marketing» cuenta con un campo «Pedido» y un campo «Cliente». Flow los rellena a partir del activador, por lo que un flujo de trabajo iniciado por «Pedido creado» ya sabe de qué pedido se trata.
- Cuando se envía el correo electrónico, la aplicación lee ese metacampo del pedido o del cliente, descarga el archivo (desde su cuenta de Shopify, desde la sección «Archivos» o desde el enlace) y lo adjunta. Un metacampo de lista adjunta todas las entradas.
La plantilla solo indica el nombre del metacampo. El flujo de trabajo especifica a qué pedido o cliente corresponde, por lo que una sola plantilla sirve para todos los pedidos.
Archivos y enlaces
| El metacampo contiene | Tipo de definición | Para qué sirve la aplicación |
|---|---|---|
| Un archivo de Shopify | Archivo, Lista de archivos | Sigue la referencia al archivo que se encuentra en su carpeta «Archivos» y lo descarga |
| Un enlace | Una URL, una lista de URL o un campo de texto | Descarga el archivo desde ese enlace. Solo funcionan los enlaces de tipo https://; un enlace que no responde o que apunta a algo distinto de un PDF, una imagen, un archivo CSV o un archivo de texto provoca que el envío falle con el motivo |
En cualquier caso, el tamaño se comprueba al enviar el correo electrónico, no en el editor, por lo que los archivos adjuntos de los metacampos no se incluyen en el recuento total de archivos adjuntos del editor.
Configúrelo
Formatos de texto enriquecido y diseños HTML
En la ficha «Archivos adjuntos», situada en la parte inferior del editor, haga clic en «Añadir desde metacampo». Seleccione «Pedido» o «Cliente» y, a continuación, la definición. La fila muestra el nombre de la definición, su contenido y su namespace.key; al hacer clic en «Cambiar» se selecciona otra.
Diseños visuales
Añada un bloque «Archivo adjunto» (o abra uno) y cambie su origen a «Metacampo». Al seleccionar «Metacampo», se abre el mismo selector.
El permiso
La aplicación se instala sin ningún tipo de acceso a los datos de su tienda. La primera vez que seleccione un pedido o un metacampo de cliente, el selector le solicitará permiso para leer los metacampos de ese recurso y los archivos a los que apuntan. Shopify muestra su propio cuadro de diálogo de consentimiento; tras pulsar «Actualizar», se carga la lista de definiciones.
Puede revisar y revocar cualquier permiso en cualquier momento en la página «Permisos» de la aplicación. Si revoca uno de ellos, todos los correos electrónicos que incluyan un archivo adjunto procedente de dicho metacampo fallarán hasta que se vuelva a conceder dicho permiso. La descripción de lo que incluye y lo que no incluye cada permiso se encuentra en Permisos: qué datos de sus tiendas puede leer la aplicación.
Nombre del archivo
De forma predeterminada, el archivo adjunto conserva el nombre propio del archivo: el nombre que aparece en «Shopify Files» o la última parte del enlace. El campo «Nombre del archivo» lo sustituye y ofrece soporte para Liquid; por ejemplo, invoice-{{ variables.order_name }}.pdf. Cuando un metacampo de lista contiene varias entradas, a la segunda y a las siguientes se les añade -2, -3 al nombre sustituido.
Cuando el metacampo está vacío
La aplicación que escribe el archivo suele ejecutarse unos segundos después del activador, por lo que, en el momento en que se ejecuta el paso de correo electrónico, el metacampo aún puede estar vacío. Lo que ocurra a continuación dependerá de la casilla de selección «Opcional» del archivo adjunto:
| Opcional | Comportamiento |
|---|---|
| Desactivado (por defecto) | El correo electrónico aún no se ha enviado. La aplicación indica a Shopify Flow que vuelva a intentar el paso, y Shopify Flow vuelve a enviarlo un poco más tarde; el correo electrónico se envía en cuanto el archivo está disponible. |
| El | El correo electrónico se envía sin este archivo adjunto. |
No lo incluya en una factura en la que deba figurar. Inclúyalo en un archivo que solo contienen algunos pedidos.
Requisitos y límites
- Es necesario configurar el campo «Pedido» o «Cliente» en el paso del Shopify Flow. Los pasos que se añadieron antes de esta versión aún no disponen de dichos campos: elimine el paso en el editor de Shopify Flow y vuelva a añadirlo.
- Archivos de hasta 10 MB cada uno; archivos PDF, de imágenes, CSV, de texto sin formato y de calendario. Los vídeos y los modelos 3D se omiten.
- Los enlaces deben comenzar por
https://y ser accesibles sin necesidad de iniciar sesión. Se rechazará cualquier enlace que redirija a una dirección que no sea https o a una red privada. - Pedidos de los últimos 60 días. Shopify solo permite que las aplicaciones consulten los pedidos recientes. Si se intenta realizar un flujo de trabajo relacionado con un pedido anterior, el envío falla y se muestra un mensaje claro al respecto.
- Microsoft 365 rechaza los mensajes con archivos adjuntos que superen los 4 MB en total; consulte Archivos adjuntos e imágenes.
Lo que se ve en la asignatura de Historia
Todos los resultados se muestran en la página «Historial». Un paso sin pedido, un permiso retirado, un pedido que Shopify no puede encontrar, un enlace que no responde o un archivo que supera el límite se registran como «Fallido», indicando el motivo y qué hay que modificar. Un metacampo vacío con la opción «Opcional» desactivada no se considera un error: Shopify Flow muestra los reintentos y el envío aparece una vez que el archivo está disponible. Una «Reenvío» desde el Historial vuelve a leer el mismo pedido o cliente.
Pruébelo
La función «Enviar correo electrónico de prueba» del editor de diseño no dispone de ningún pedido ni cliente del que extraer información, por lo que se envía sin archivos adjuntos de metacampos. Para probar el archivo adjunto, ejecute el flujo de trabajo en «Shopify Flow» con un pedido que ya contenga el archivo, o utilice la opción «Ejecutar en una prueba de Shopify Flow» con dicho pedido.
Relacionado
- Permisos: qué datos de sus tiendas puede leer la aplicación - en qué consisten los permisos opcionales y cómo revocarlos.
- Archivos adjuntos e imágenes - Archivos adjuntos subidos, modo «Adjuntar» frente a «Enlace» y tamaños.
- Pasar datos desde Shopify Flow - los campos y las variables de paso.
- Historial y resolución de problemas - leer un mensaje cuyo envío ha fallado.