Adjunte un archivo desde un metacampo de pedido o de cliente

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

  1. Otra aplicación (o usted mismo) introduce el archivo, o un enlace al mismo, en un metacampo del pedido o del cliente. En el 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.
  2. 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 ambos.
  3. 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.
  4. 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 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 hacer clic en «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 detallada 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 puede seguir estando 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 lo reenvía 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 marque en el caso de una factura en la que deba figurar. Márquelo en el caso de un archivo que solo incluyen 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 cuentan con 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 imagen, 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 a las aplicaciones consultar los pedidos recientes. Si se intenta procesar un pedido más antiguo, 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 Anexos 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 en cuanto 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 maquetación no dispone de ningún pedido ni cliente del que obtener información, por lo que se envía sin archivos adjuntos de metacampos. Para probar el archivo adjunto, ejecute el flujo de trabajo en «Flow» con un pedido que ya contenga el archivo, o utilice la opción «Ejecutar en una prueba de Flow» con dicho pedido.

Relacionado