E-mail da loja

Toda loja Venddor envia e-mails para clientes e para a própria equipe: confirmação de pedido, mudança de status, carrinho abandonado, avisos de CRM. Esta seção cobre as peças ao redor dos modelos de e-mail: o envio manual de uma mensagem avulsa, o layout (cabeçalho e rodapé que moldura todo e-mail), os fragmentos (trechos de HTML reutilizáveis) e o log de entrega, onde você descobre se uma mensagem saiu, falhou e por quê.

Como funciona

Um e-mail da plataforma é montado em três camadas: o modelo do evento (por exemplo "pedido criado"), o layout que envolve o modelo com cabeçalho e rodapé, e os fragmentos que o modelo inclui pelo código. Os modelos têm seção própria; aqui você gerencia as outras duas camadas e o resultado.

Cada linha do log tem um destes status:

Fluxo típico de operação

1. Ver a saúde do envio

   Chame Estatísticas do log para ver quantos e-mails saíram e quantos falharam hoje.

2. Investigar falhas

   Liste o log com status=failed, abra uma linha e leia error_message. Erros de configuração do SMTP aparecem aqui em texto claro.

3. Corrigir e reenviar

   Depois de corrigir a configuração, reenvie a linha. O mesmo registro volta para queued e termina em sent ou failed de novo.

Conceitos-chave

Layout: cabeçalho e rodapé

Os dois HTMLs são trechos de tabela (<tr>...</tr>) que a plataforma encaixa antes e depois do corpo do modelo. Aceitam marcadores no formato {{store_name}}, {{logo_url}}, {{store_url}}, {{support_email}} e {{current_year}}. A prévia usa dados de exemplo, não os da sua loja.

Fragmentos

Um fragmento é um pedaço de HTML com um code (por exemplo email_footer). Os modelos o incluem com {{snippet "code"}}. O idioma do fragmento é fixado na criação e não pode ser trocado depois.

Status em letra ou em palavra

O banco guarda o status do log e do fragmento em uma letra, mas a API do log devolve a palavra (failed). Nos filtros, aceite-se tanto a palavra quanto a letra (failed, f). Nos fragmentos, o status é A (ativo) ou D (desativado) e a API devolve a letra.

Datas

Todas as datas saem em RFC 3339 em UTC (2026-10-11T21:03:49Z). No filtro date_to o dia informado entra por inteiro, até 23:59:59 UTC.

Endpoints

Erros comuns

• Achar que 200 em POST /email significa entregue. Com o módulo de e-mail desligado, ou com o provedor console (ambientes de teste), a resposta é 200 "email sent" e nada sai. Leia provider e log na resposta.
• Mandar type diferente de header ou footer no layout. É 400.
• Esperar que PUT /email-snippets/{id} limpe um campo. Campos vazios são ignorados, então não dá para esvaziar content por aqui.
• Tentar apagar um fragmento de sistema. Responde 500 (veja a página de fragmentos).
• Reenviar um e-mail com status sent. Só failed e bounced são aceitos.
• Paginar o log pedindo per_page maior que 100. Valores fora de 1 a 100 voltam silenciosamente para 20.

Próximos passos