Anexar um ficheiro a partir de um metacampo de pedido ou de cliente

Muitas aplicações guardam um ficheiro associado ao pedido ou ao cliente: uma fatura ou guia de remessa em formato PDF proveniente de uma aplicação de faturação, um certificado, um contrato assinado. O Shopify armazena-o num metacampo, quer como ficheiro na sua pasta «Shopify Files», quer como ligação para o ficheiro. Esta aplicação pode anexar esse ficheiro ao e-mail enviado por um fluxo de trabalho do Shopify Flow, sem que tenha de carregar ou criar ligações manualmente.

Como funciona

Outra aplicação (ou o próprio utilizador) insere o ficheiro, ou um link para o mesmo, num metacampo da encomenda ou do cliente. Na sua área de administração do Shopify, isso encontra-se em Definições > Dados personalizados > Pedidos (ou Clientes): uma definição do tipo Ficheiro, URL ou um campo de texto no qual uma aplicação insere um link.
Num modelo de e-mail, adiciona-se um anexo e seleciona-se «Metacampo» como fonte, selecionando depois essa definição. O seletor mostra o que cada uma contém: um ficheiro, um link ou uma lista de qualquer um deles.
No Shopify Flow, a etapa «Enviar e-mail transacional» ou «Enviar e-mail de marketing» possui um campo «Pedido» e um campo «Cliente». O Flow preenche-os a partir do gatilho, pelo que um fluxo de trabalho iniciado por «Pedido criado» já sabe de que pedido se trata.
Quando o e-mail é enviado, a aplicação lê esse metacampo na respetiva encomenda ou cliente, descarrega o ficheiro (a partir da sua pasta Shopify, ou a partir do link) e anexa-o. Um metacampo de lista anexa todas as entradas.

O layout apenas identifica o metacampo. O fluxo de trabalho indica a quem pertence o pedido ou qual é o cliente, pelo que um único layout serve todos os pedidos.

Ficheiros e ligações

O metacampo contém	Tipo de definição	O que a aplicação faz
Um ficheiro da Shopify	Ficheiro, Lista de ficheiros	Segue a referência ao ficheiro na sua pasta «Ficheiros» e descarrega-o
Um link	URL, lista de URLs ou um campo de texto	Descarrega o ficheiro a partir desse link. Apenas os links do tipo `https://` funcionam; um link que não responda ou que aponte para algo que não seja um ficheiro PDF, imagem, CSV ou de texto faz com que o envio falhe, com o motivo

De qualquer forma, o tamanho é verificado no momento em que o e-mail é enviado, e não no editor; por isso, os anexos dos metacampos não são contabilizados no total de anexos do editor.

Configure-o

Formatação de texto rico e layouts HTML

No cartão «Anexos», na parte inferior do editor, clique em «Adicionar a partir do metacampo». Selecione «Pedido» ou «Cliente» e, em seguida, a definição. A linha apresenta o nome da definição, o seu conteúdo e o seu namespace.key; a opção «Alterar» permite selecionar outra definição.

Disposições visuais

Adicione um bloco «Anexo» (ou abra um) e altere a sua fonte para «Metacampo». Ao selecionar «metacampo», abre-se o mesmo seletor.

A autorização

A aplicação é instalada sem qualquer acesso aos dados da sua loja. Na primeira vez que selecionar um metacampo de pedido ou de cliente, o seletor solicita autorização para ler os metacampos desse recurso e os ficheiros para os quais estes apontam. Shopify apresenta a sua própria caixa de diálogo de consentimento; após clicar em «Atualizar», a lista de definições é carregada.

Pode rever e revogar todas as autorizações a qualquer momento na página «Autorizações» da aplicação. A revogação de uma autorização fará com que todos os e-mails que incluam um ficheiro anexado a partir desse metacampo falhem, até que a autorização seja novamente concedida. O que cada autorização abrange e o que não abrange encontra-se em Autorizações: o que a aplicação pode ler na sua loja.

Nome do ficheiro

Por predefinição, o anexo mantém o nome do próprio ficheiro: o nome que consta nos seus ficheiros do Shopify ou a última parte do link. O campo «Nome do ficheiro» substitui esse nome e oferece suporte a Liquid; por exemplo, invoice-{{ variables.order_name }}.pdf. Quando um metacampo de lista contém várias entradas, à segunda e às seguintes é acrescentado -2, -3 à substituição.

Quando o metacampo estiver vazio

A aplicação que grava o ficheiro costuma ser executada alguns segundos após o gatilho; por isso, no momento em que a etapa de e-mail é executada, o metacampo ainda pode estar vazio. O que acontece a seguir depende da caixa de seleção «Opcional» do anexo:

Opcional	Comportamento
Desativado (predefinição)	O e-mail ainda não foi enviado. A aplicação indica a Shopify Flow para repetir a etapa e a Shopify Flow reenvia-o pouco tempo depois; o e-mail é enviado assim que o ficheiro estiver disponível.
Em	O e-mail é enviado sem este anexo.

Deixe-o desativado para uma fatura que tenha de constar. Ative-o para um ficheiro que apenas alguns pedidos têm.

Requisitos e limites

É necessário definir o campo «Pedido» ou «Cliente» na etapa do Shopify Flow. As etapas que foram adicionadas antes desta versão ainda não dispõem desses campos: elimine a etapa no editor do Shopify Flow e adicione-a novamente.
Ficheiros com um tamanho máximo de 10 MB cada; ficheiros PDF, imagens, CSV, texto simples e ficheiros de calendário. Os vídeos e os modelos 3D são ignorados.
As ligações devem começar por https:// e estar acessíveis sem necessidade de início de sessão. Uma ligação que redirecione para um endereço que não seja https ou para uma rede privada será recusada.
Pedidos dos últimos 60 dias. O Shopify só permite que as aplicações consultem os pedidos recentes. No caso de um fluxo de trabalho relativo a um pedido mais antigo, o envio falha, apresentando uma mensagem clara.
O Microsoft 365 rejeita mensagens com anexos que, no total, excedam os 4 MB; consulte Anexos e imagens.

O que vê na disciplina de História

Todos os resultados constam na página «Histórico». Um passo sem um pedido, uma autorização revogada, um pedido que o Shopify não consegue localizar, um link que não responde ou um ficheiro que excede o limite é registado como «Falha», indicando o motivo e o que deve ser alterado. Um metacampo vazio com a opção «Opcional» desativada não constitui uma falha: o Shopify Flow apresenta as tentativas de reenvio e o envio aparece assim que o ficheiro estiver disponível. Uma opção «Reenviar» a partir do Histórico volta a ler o mesmo pedido ou o mesmo cliente.

Experimente

A função «Enviar e-mail de teste» no editor de layout não tem qualquer pedido ou cliente a partir do qual possa ler os dados, pelo que o e-mail é enviado sem anexos de metacampos. Para testar o anexo, execute o fluxo de trabalho no Shopify Flow numa encomenda que já contenha o ficheiro, ou utilize a opção «Executar num teste do Shopify Flow» com uma encomenda desse tipo.

Relacionado

Autorizações: o que a aplicação pode ler na sua loja - em que consistem as autorizações opcionais e como as revogar.
Anexos e imagens - anexos carregados, modo «Anexar» vs. «Ligação» e tamanhos.
Transmissão de dados a partir de Shopify Flow - os campos e variáveis do passo.
Histórico e resolução de problemas - leitura de um envio falhado.