Introdução ao livro Workflow Transactional Email

Shopify Flow é uma poderosa plataforma de automação, mas sua biblioteca de ações integrada apresenta limitações. É possível acionar fluxos de trabalho e definir condições, mas quando se trata de realizar alguma ação com um serviço externo - como chamar uma API ou enviar um e-mail com a identidade visual da sua empresa a partir da sua própria caixa de correio - , o Flow nativo apresenta limitações.
Workflow Transactional Email preenche essa lacuna. Ele adiciona três ações ao Shopify Flow: “Enviar e-mail transacional”, “Enviar e-mail de marketing” e “Solicitação HTTP”, permitindo que você conecte seus fluxos de trabalho a qualquer API externa, webhook, CRM ou caixa de correio - sem escrever uma única linha de código.
O que o diferencia
O Shopify Flow nativo lida bem com as ações internas do Shopify: etiquetagem, publicação e ajustes de estoque. O que lhe falta é conectividade externa, ou seja, a capacidade de ir além do Shopify e interagir com sistemas externos. Este aplicativo se concentra exatamente nessa lacuna:
- Envie e-mails a partir de sua própria caixa de correio. Conecte o Microsoft 365 ou o Google com um clique, ou configure o aplicativo para qualquer servidor SMTP. Seu domínio, sua reputação, sua marca.
- Um verdadeiro editor de e-mails. Crie layouts a partir de blocos - títulos, texto, imagens, botões, linhas com duas colunas, loops e códigos QR - ou escreva seu próprio HTML. Cabeceiras e rodapés reutilizáveis garantem que todas as mensagens estejam alinhadas à identidade da marca.
- E-mails de marketing com uma opção de cancelamento. Marque um modelo como “marketing” e todos os e-mails enviados a partir dele incluirão um link para cancelar a inscrição e os dados da sua empresa; os clientes que cancelarem a inscrição serão excluídos da lista a partir de então. Consulte E-mails de marketing e cancelamentos de inscrição.
- Solicitações HTTP em todos os planos do Shopify. A ação “Enviar solicitação HTTP” do próprio Shopify está limitada a determinados planos. Esta ação, porém, não está, portanto, as lojas do plano Básico ainda podem enviar dados para qualquer API.
- Gerenciamento seguro de segredos. Armazene chaves de API, tokens e senhas uma única vez e, em seguida, utilize-os em qualquer lugar como
{{ secrets.keyName }}. Eles são criptografados por envelope em repouso com o Cloud KMS e descriptografados somente durante a execução de uma ação. - Modelos em Liquid. Crie cabeçalhos, corpos, URLs e payloads dinâmicos com marcadores de posição
{{ variables.xxx }}, preenchidos a partir do Shopify Flow. - Histórico completo de execução. Cada envio e cada solicitação são registrados com os detalhes da solicitação e da resposta, de modo que a depuração se resume a um clique, em vez de adivinhação. Qualquer ação anterior pode ser reenviada.
- Não há escopos de dados do tipo Shopify. O aplicativo não solicita nenhum escopo de acesso. Ele não lê seus produtos, pedidos ou clientes - limita-se a executar as solicitações de saída e os e-mails que você configurar.
As três ações do Shopify Flow
Enviar e-mail transacional
Envia um e-mail utilizando um remetente e um modelo de e-mail transacional que você configurou no aplicativo.
| Campo em Shopify Flow | O que ele faz |
|---|---|
| Para e-mail(s) | Um ou mais destinatários, um por linha. Normalmente, uma variável do Shopify Flow, como {{customer.defaultEmailAddress.emailAddress}} |
| E-mail(s) em cópia (CC) | Destinatários em cópia (CC) opcionais, um por linha |
| E-mails com CCO | Destinatários opcionais em CCO, um por linha |
| Variáveis (JSON) | Dados personalizados para o layout, por exemplo, {"customerName": "John", "orderId": "12345"}, referenciados como {{ variables.customerName }} |
O remetente e o layout são selecionados na própria tela de configuração da ação (Enviar de e Layout), e não nesses campos. Nessa tela, são oferecidos apenas layouts transacionais.
A ação retorna um resultado com base no qual as etapas posteriores do Shopify Flow podem se ramificar:
| Campo de retorno | Valores |
|---|---|
status |
SENT ou FAILED, ou SKIPPED, quando um layout direcionado ao marketing continha apenas destinatários que haviam cancelado a assinatura |
messageId |
O ID da mensagem do provedor, quando disponível |
provider |
GOOGLE, MICROSOFT, SMTP ou DEFAULT |

Enviar e-mail de marketing
Envia um modelo de e-mail de marketing: um boletim informativo, um pedido de avaliação, uma oferta de reconquista. Possui os mesmos campos que a opção “Enviar e-mail transacional”, mas apenas modelos de marketing são oferecidos na tela de configuração, e o envio ocorre de maneira diferente:
- um e-mail por destinatário do campo “Para” (no máximo 20 por ação), cada um com seu próprio link para cancelar a inscrição,
- sua frase de cancelamento de inscrição e os dados da empresa no rodapé,
- os clientes que cancelaram a assinatura são ignorados.
O resultado é:
| Campo de retorno | Valores |
|---|---|
status |
SENT, FAILED ou SKIPPED (todos os destinatários haviam cancelado a inscrição) |
messageId |
O ID da mensagem do provedor do primeiro e-mail enviado, quando disponível |
provider |
GOOGLE, MICROSOFT, SMTP ou DEFAULT |
Todas as informações sobre layouts de marketing, o rodapé e a lista de cancelamento de inscrição estão disponíveis em E-mails de marketing e cancelamentos de inscrição.
Solicitação HTTP
Executa uma solicitação HTTP que o(a) senhor(a) salvou no aplicativo.
| Campo em Shopify Flow | O que ele faz |
|---|---|
| Substituição de variáveis ou do corpo (JSON) | Podem ser variáveis personalizadas referenciadas como {{ variables.xxx }} na URL, nos cabeçalhos e no corpo da solicitação, ou uma substituição do corpo da solicitação: passe {"body": {...}} para substituir integralmente o corpo da solicitação configurado |
O resultado é:
| Campo de retorno | Valores |
|---|---|
status |
O código de status HTTP |
response |
O corpo da resposta como JSON convertido em string |
Navegando pelo aplicativo
| Página | Para que serve |
|---|---|
| Página inicial | Guia de configuração, utilização em relação ao seu plano, taxa de sucesso, status de envio, gráfico de ações e atividades recentes |
| Remetentes de e-mail | Contas conectadas do Microsoft 365 e do Google, servidores SMTP e a caixa de diálogo de envio de teste |
| Layouts de e-mail | Os próprios e-mails - assunto, layout, anexos, variáveis de teste - nas guias “Transacional” e “Marketing” |
| Cabeçalho e rodapé | Predefinições reutilizáveis de cabeçalho e rodapé compartilhadas entre layouts |
| Solicitações HTTP | Modelos de solicitação salvos: método, URL, cabeçalhos, corpo |
| Segredos | Valores criptografados aos quais o(a) senhor(a) faz referência como{{ secrets.keyName }} |
| História | Cada execução com detalhes sobre status, tempo, solicitação e resposta |
| Cancelamentos de assinatura | Clientes que cancelaram a inscrição em seus e-mails de marketing, por meio de pesquisa, adição manual, reinscrição e exportação em CSV - consulte E-mails de marketing e cancelamentos de inscrição |
| Desenvolvedor | Chaves de API e o comando “connect” para a API REST e o servidor MCP - consulte API para desenvolvedores e MCP |
| Configurações | Configurações padrão de e-mail, textos do rodapé de marketing por idioma, cores da marca, fontes personalizadas e alertas - consulte Configurações |
| Ajuda | Contatos de suporte, links para a documentação e seu plano |
Veja como funciona
Envio de uma solicitação HTTP personalizada a partir de Shopify Flow (o vídeo não tem som):
Envio de um e-mail com a identidade visual da sua empresa por meio do seu próprio servidor SMTP (o vídeo não tem som):
Planos e limites
| Plano | Preço | Ações por período móvel de 30 dias | Armazenamento de anexos |
|---|---|---|---|
| Gratuito | $0 | 500 | 500 MB |
| Entrada | US$ 15 por mês | 5.000 | 2 GB |
| Crescer | US$ 35 por mês | 15.000 | 10 GB |
| Ilimitado | US$ 100 por mês | Ilimitado | 50 GB |
O faturamento anual está disponível em todos os planos pagos e sai mais barato do que o mensal. Uma “ação” corresponde a um e-mail enviado ou a uma solicitação HTTP executada; um e-mail de marketing enviado a vários destinatários ainda conta como uma ação. Todos os planos incluem todos os recursos - os planos diferem apenas em volume e espaço de armazenamento. Consulte Planos e uso.
Próximos passos
Siga esta lista nesta ordem:
- Visão geral dos remetentes de e-mail - decida como seu e-mail deve ser enviado pela loja.
- Enviar e-mail a partir de Shopify Flow utilizando um servidor SMTP personalizado - conecte seu próprio servidor de e-mail e envie seu primeiro e-mail com a identidade visual da sua empresa.
- Envie e-mails a partir de Shopify Flow com o Microsoft 365 - enviar a partir de uma caixa de correio do Microsoft 365 ou do Outlook.
- Envie um e-mail a partir de Shopify Flow com o Google - enviar a partir de uma caixa de correio do Google ou do Gmail.
- Crie um layout de e-mail - criar o próprio e-mail.
- E-mails de marketing e cancelamentos de inscrição - boletins informativos e promoções com um link para cancelar a inscrição.
- Variáveis e Líquido - insira os dados do Shopify Flow no título e no corpo do texto.
- Anexos e imagens - adicionar arquivos e imagens a um e-mail.
- Predefinições de cabeçalho e rodapé - certifique-se de que todos os e-mails estejam alinhados à identidade da marca.
- Faça uma solicitação HTTP a partir de Shopify Flow - chamar uma API externa a partir de um fluxo de trabalho.
- Segredos - Não inclua chaves de API e senhas em seus modelos.
- Histórico e solução de problemas - acompanhar todas as execuções e corrigir as falhas.
- Perguntas frequentes - as perguntas que mais nos fazem.

