Workflow Transactional EmailWorkflow Transactional Email

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

Muitos aplicativos salvam um arquivo relacionado ao pedido ou ao cliente: uma fatura ou nota fiscal em PDF de um aplicativo de faturamento, um certificado, um contrato assinado. O Shopify armazena esse arquivo em um metacampo, seja como um arquivo na sua pasta Shopify do Google Drive, seja como um link para o arquivo. Este aplicativo pode anexar esse arquivo ao e-mail enviado por um fluxo de trabalho do Shopify Flow, sem que você precise fazer upload ou criar um link manualmente.

Como funciona

  1. Outro aplicativo (ou você) insere o arquivo, ou um link para ele, em um metacampo do pedido ou do cliente. No painel de administração do Shopify, isso se encontra em Configurações > Dados personalizados > Pedidos (ou Clientes): uma definição do tipo Arquivo, URL ou um campo de texto no qual um aplicativo insere um link.
  2. Em um layout de e-mail, você adiciona um anexo e seleciona “Metacampo” como fonte; em seguida, escolhe essa definição. O seletor mostra o que cada uma contém: um arquivo, um link ou uma lista de ambos.
  3. 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 os preenche a partir do gatilho; portanto, um fluxo de trabalho iniciado pela criação de um pedido já sabe de qual pedido se trata.
  4. Quando o e-mail é enviado, o aplicativo lê esse metacampo no pedido ou no cliente em questão, baixa o arquivo (da sua pasta Shopify ou do link) e o anexa. 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; portanto, um único layout atende a todos os pedidos.

O metacampo contém Tipo de definição O que o aplicativo faz
Um arquivo de Shopify Arquivo, Lista de arquivos Segue a referência ao arquivo em seus Arquivos e o baixa
Um link URL, lista de URLs ou um campo de texto Baixa o arquivo a partir desse link. Apenas links do tipo https:// funcionam; um link que não responde ou que aponta para algo que não seja um PDF, uma imagem, um CSV ou um arquivo de texto faz com que o envio seja rejeitado com o motivo

De qualquer forma, o tamanho é verificado no momento do envio do e-mail, e não no editor; portanto, os anexos dos metacampos não são contabilizados no total de anexos do editor.

Configure-o

Formatação de texto rico e layouts em 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 exibe o nome da definição, o que ela contém e seu namespace.key; a opção “Alterar” permite selecionar outra definição.

Layouts visuais

Adicione um bloco “Anexo” (ou abra um) e altere sua fonte para “Metacampo”. Ao selecionar “metacampo”, o mesmo seletor é aberto.

A permissão

O aplicativo é instalado sem qualquer acesso aos dados da sua loja. Na primeira vez em que o senhor selecionar um pedido ou um metacampo de cliente, o seletor solicitará permissão para ler os metacampos desse recurso e os arquivos aos quais eles apontam. O Shopify exibe sua própria caixa de diálogo de consentimento; após clicar em “Atualizar”, a lista de definições é carregada.

É possível revisar e revogar todas as permissões a qualquer momento na página “Permissões” do aplicativo. A revogação de uma permissão fará com que todos os e-mails que anexarem um arquivo proveniente desse metacampo apresentem falha até que a permissão seja concedida novamente. O que cada permissão abrange - e o que não abrange - está disponível em Permissões: o que o aplicativo pode acessar na sua loja.

Nome do arquivo

Por padrão, o anexo mantém o próprio nome do arquivo: o nome em seus Arquivos do Shopify ou a última parte do link. O campo “Nome do arquivo” 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, a segunda e as seguintes têm -2 e -3 acrescentados à substituição.

Quando o metacampo estiver vazio

O aplicativo que grava o arquivo geralmente é executado alguns segundos após o gatilho; portanto, no momento em que a etapa de e-mail é executada, o metacampo ainda pode estar vazio. O que acontece a partir daí depende da caixa de seleção “Opcional” do anexo:

Opcional Comportamento
Desativado (padrão) O e-mail ainda não foi enviado. O aplicativo instrui o Shopify Flow a repetir a etapa, e o Shopify Flow o reenvia um pouco mais tarde; o e-mail é enviado assim que o arquivo estiver disponível.
Em O e-mail é enviado sem esse anexo.

Deixe desmarcado para uma fatura que deve constar. Marque para um arquivo que apenas alguns pedidos possuem.

Requisitos e limites

  • A etapa do Shopify Flow precisa ter o campo “Pedido” ou “Cliente” preenchido. As etapas adicionadas antes desta versão ainda não possuem esses campos: exclua a etapa no editor do Shopify Flow e adicione-a novamente.
  • Arquivos de até 10 MB cada; arquivos em PDF, imagens, CSV, texto simples e calendário. Vídeos e modelos 3D são ignorados.
  • Os links devem começar com https:// e serem acessíveis sem a necessidade de login. Um link que redirecione para um endereço que não seja https ou para uma rede privada será recusado.
  • Pedidos dos últimos 60 dias. O Shopify permite que os aplicativos acessem apenas os pedidos recentes. No caso de um fluxo de trabalho relacionado a um pedido mais antigo, o envio falha e é exibida uma mensagem clara.
  • O Microsoft 365 rejeita mensagens com anexos que, no total, ultrapassem 4 MB; consulte Anexos e imagens.

O que o senhor vê na disciplina de História

Todos os resultados constam na página Histórico. Uma etapa sem pedido, uma permissão revogada, um pedido que o Shopify não consegue localizar, um link que não responde ou um arquivo que excede o limite são registrados como “Falha”, com o motivo e as alterações necessárias. Um metacampo vazio com a opção “Opcional” desativada não constitui uma falha: o Shopify Flow exibe as tentativas de reenvio, e o envio aparece assim que o arquivo estiver disponível. Uma opção “Reenviar” no Histórico lê novamente a mesma ordem ou o mesmo cliente.

Teste isso

O envio de e-mail de teste no editor de layout não possui nenhum pedido ou cliente para consultar, portanto, o e-mail é enviado sem anexos de metacampos. Para testar o anexo, execute o fluxo de trabalho no Shopify Flow em um pedido que já contenha o arquivo ou utilize a opção “Executar em um teste do Shopify Flow” com um pedido desse tipo.

Relacionado