Workflow Transactional EmailWorkflow Transactional Email
Anexar um ficheiro a partir de um metacampo de pedido ou de cliente

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

Copiar página

Anexe automaticamente ficheiros de metacampos de pedidos ou clientes aos e-mails do Shopify Flow, sem uploads manuais.

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 um ficheiro na sua pasta «Shopify Files», quer como um link 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

  1. Outra aplicação (ou o próprio utilizador) insere o ficheiro, ou um link para o mesmo, num metacampo do pedido ou do cliente. No painel 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.
  2. Num modelo de e-mail, ao adicionar um anexo e selecionar «Metacampo» como fonte, deve escolher essa definição. O seletor mostra o que cada uma contém: um ficheiro, um link ou uma lista de ambos.
  3. No Shopify Flow, o passo «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 pela criação de um pedido já sabe de que pedido se trata.
  4. 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 quem é o cliente, pelo que um único layout serve todos os pedidos.

Uma etapa «Enviar e-mail transacional» recentemente adicionada em Shopify Flow, com o campo «Pedido» definido como «order.id» e o campo «Cliente» como «order.customer.id», acima dos campos «Para», «CC» e «BCC»
A etapa em Shopify Flow: «Pedido» e «Cliente» são preenchidas a partir do gatilho, neste caso, um fluxo de trabalho de pedidos. Uma etapa adicionada antes da versão 1.17 não as possui; elimine-a e adicione-a novamente.

Ficheiros e ligações

O metacampo contém Tipo de definição O que a aplicação faz
Um ficheiro do 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.

O cartão «Anexos» de um layout de texto rico com os botões «Adicionar anexo», «Adicionar a partir de URL» e «Adicionar a partir de metacampo»
O cartão «Anexos» de um layout de texto rico ou HTML: Adicionar a partir do metacampo junto aos botões de carregamento e de URL.

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.

Um bloco de anexos no construtor visual com a sua fonte definida para «Metacampo», o botão «Escolher metacampo», a substituição do nome do ficheiro e a caixa de seleção «Opcional»
O bloco de anexos com o Metacampo como fonte: selecione a definição, substitua o nome do ficheiro e decida se um metacampo vazio impede o envio do e-mail.
A caixa de diálogo «Anexar um ficheiro a partir de um metacampo», com «Pedido» selecionado como recurso e as definições «PDF da fatura (Ficheiro)» e «URL da fatura (Ligação)» listadas abaixo de um campo de pesquisa
O seletor: Primeiro o pedido ou o cliente, depois as definições desse recurso, cada uma com o que contém. O PDF da fatura está selecionado.
O bloco de anexos após selecionar o metacampo: PDF da fatura, Ficheiro, Fatura personalizada do pedido (custom.invoice_pdf), um botão «Alterar metacampo», a substituição do nome do ficheiro e a caixa de seleção «Opcional»
O bloco após a escolha: o nome da definição, o seu conteúdo e o seu namespace.key. A opção «Alterar metacampo» seleciona outro.

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 consultar 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 - pode ser consultado em Autorizações: o que a aplicação pode ler na sua loja.

A página «Permissões», que apresenta «Pedidos» e «Ficheiros» como «Concedidos», com botões «Revogar», e «Clientes» e «Descontos» como «Não concedidos», com botões «Conceder», cada um com o seu âmbito
A página «Permissões»: cada permissão opcional com o seu âmbito de aplicação, concedida ou não, e um botão para a conceder ou revogar. Aqui, as permissões «Pedidos» e «Ficheiros» foram concedidas a partir do seletor.

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 essa opção desativada para uma fatura que tenha de constar. Ative-a para um ficheiro que apenas alguns pedidos incluem.

Requisitos e limites

  • É necessário definir o campo «Pedido» ou «Cliente» na etapa do Shopify Flow. As etapas 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 apenas 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, sendo apresentada 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 retirada, um pedido que o Shopify não consegue encontrar, 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.

Um evento «History» de um e-mail com instruções de devolução, cujos dados do pedido incluem o «orderId» do pedido a partir do qual a fatura foi lida
Um e-mail com um anexo proveniente de um metacampo no Histórico: os dados do pedido registam qual a ordem em que foram lidos, pelo que uma «Reenviar» volta a lê-los.

Experimente

A função «Enviar e-mail de teste» no editor de layout não dispõe de qualquer pedido ou cliente a partir do qual possa ler os dados, pelo que o e-mail é enviado sem anexos de metacampo. 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