Notifique clientes sobre uma atualização de produto

O que o Notificar clientes faz

O Notificar clientes envia um e-mail a cada comprador anterior de um produto, com um botão que abre o download dos arquivos mais recentes daquele comprador. Você o inicia pela página do produto no admin do Alva: abra o produto, clique em Notificar clientes, escolha quem recebe, adicione uma observação opcional, confira a visualização e envie.

O e-mail é um aviso fixo de atualização de produto no idioma da sua loja, não um e-mail de marketing. Ele sai por um fluxo de envio separado dos seus e-mails de entrega, com o rastreamento de abertura e de cliques desligado para que o link de download nunca seja reescrito. Quem cancelou a inscrição ou marcou um e-mail anterior como spam é pulado automaticamente.

Quem recebe o e-mail

Todo cliente que comprou uma das variantes selecionadas e ainda aceita receber e-mails recebe exatamente uma mensagem. Se as variantes de um produto entregam arquivos diferentes, a janela mostra uma caixa de seleção por conjunto de arquivos, identificada com as variantes que ele atende; todas vêm selecionadas por padrão. Quem comprou várias variantes selecionadas recebe um único e-mail.

Esse único e-mail leva à compra mais recente do comprador entre as variantes selecionadas. A outra variante continua acessível pelo link de download original e pela página de status do pedido. O número de destinatários é atualizado conforme você muda a seleção, e o número de compradores que cancelaram a inscrição aparece logo abaixo — eles não podem ser alcançados por aqui.

Compras com o acesso ao download desativado, ou que não passaram na sua verificação antifraude, ficam de fora. Produtos personalizados não têm um arquivo compartilhado para reenviar, então nem mostram o botão, e um produto cujos mapeamentos não contêm arquivos, packs ou links não pode ser notificado.

O que o e-mail diz

O e-mail é um modelo bloqueado: o assunto, a saudação, a frase de introdução, o botão Baixar arquivos e o rodapé são fixos e traduzidos para o idioma da sua loja. A única parte que você pode adicionar é uma observação em texto simples de até 2.000 caracteres, exibida como “Um recado de {sua loja}:” entre a frase de introdução e o botão. Os compradores veem, nesta ordem:

• Assunto: Atualização da sua compra de {título do produto}
• Olá {nome},
• {Nome da loja} atualizou sua compra de {título do produto}. Clique abaixo para baixar a versão mais recente.
• Um recado de {nome da loja}: seguido da sua observação — apenas quando você adicionou uma
• O botão Baixar arquivos, que abre a página de download do próprio comprador
• Um rodapé com o nome da sua loja e um link para cancelar a inscrição

Adicionar uma observação

Digite a observação no campo Adicionar uma observação (opcional). Somente texto simples: links e endereços de e-mail não são permitidos — endereços web, www. e nomes de domínio sem prefixo incluídos — e o campo os recusa antes que você possa enviar, para que o botão Baixar arquivos continue sendo o único link do e-mail. Não coloque descontos ou promoções na observação: este e-mail é uma atualização de produto, não marketing.

Variáveis que você pode usar na observação

Três botões abaixo do campo inserem as três primeiras variáveis; um menu Metacampo do produto lista os metacampos do produto para a quarta:

• {customer.first_name} — o primeiro nome do comprador, com uma alternativa neutra quando ele é desconhecido. Fica melhor no início de uma linha.
• {shop.name} — o nome da sua loja.
• {product.title} — o título do produto, como no assunto.
• {product.metafields.<namespace>.<key>} — o valor de um dos metacampos Shopify do produto, por exemplo {product.metafields.custom.edition}. Uma observação pode usar até cinco metacampos diferentes. O menu lista os primeiros 50 metacampos do produto com seus valores atuais.

Os tipos de metacampo compatíveis são texto de uma e de várias linhas, números inteiros e decimais, datas (escritas por extenso no idioma da sua loja) e listas de texto. Um metacampo de outro tipo — um link, um valor verdadeiro/falso, uma referência, texto formatado ou um arquivo — não pode ser exibido em um e-mail, então a observação é recusada com um erro no próprio campo até você removê-lo. O mesmo vale para um metacampo sem valor neste produto, para uma variável que o Alva não conhece, para uma chave não fechada e para um link dentro do valor de um metacampo.

Visualize antes de enviar

A Visualização do email abaixo da observação mostra o assunto e o corpo exatamente como um comprador os verá, no idioma da sua loja, com a observação e suas variáveis preenchidas a partir dos valores reais do produto. A visualização e o e-mail enviado são gerados pelo mesmo código, então o que você vê é o que sai. Se um metacampo mudar enquanto a janela está aberta, a visualização é atualizada e pede que você a confira de novo.

Produtos ZIP: o e-mail espera pelo arquivo

Se um produto entrega um arquivo ZIP e você acabou de substituir seus arquivos, o envio espera até o Alva terminar de gerar o arquivo de novo, para que nenhum comprador baixe a versão antiga. Até então, o histórico de notificações mostra “Aguardando a conclusão da geração do arquivo ZIP antes de enviar.”; o envio continua na fila e ainda pode ser cancelado.

Se a geração falhar, o envio falha com o motivo “Falha ao gerar o arquivo ZIP deste produto, então nada foi enviado.” Corrija os arquivos — substituí-los inicia uma nova geração — e notifique de novo. Se o arquivo ainda estiver sendo gerado depois de uma hora, o envio também falha, dizendo isso, e você pode notificar de novo quando a geração terminar. Nos dois casos nada foi enviado, então o limite de 7 dias não é consumido.

Produtos que entregam arquivos individuais ou links não têm arquivo ZIP e nunca ficam retidos.

O histórico de notificações

Abaixo do card Configurações do produto, o Histórico de notificações lista os últimos dez envios do produto: a data, o número de destinatários, quantos e-mails foram enviados, falharam, foram suprimidos ou receberam reclamação, quem enviou e o status — Na fila, Enviando, Concluído, Parcial, Falhou ou Cancelado. Um selo mostra de onde ele veio: Admin, API ou Atualização de mapeamento (API).

Uma linha também mostra quantas variantes ela atingiu e as primeiras linhas da observação. Uma linha com Falhou diz o motivo, em palavras: os e-mails para clientes estavam desativados, então nada foi enviado; a observação salva não pôde ser renderizada; a observação continha um link; o arquivo ZIP ainda estava sendo gerado após uma hora; falha ao gerar o arquivo ZIP; ou o envio foi interrompido por uma reinicialização do servidor. Parcial significa que alguns e-mails falharam ou foram suprimidos — os números dizem quantos.

Pela API

Tudo o que o botão faz também está disponível pela API externa do Alva, para lojas cujo próprio sistema atualiza seus arquivos. POST /api/v1/products/{id}/notifications coloca na fila uma campanha para um produto; envie "dry_run": true para executar as mesmas verificações e obter o número de destinatários, o assunto e a observação renderizada sem enviar nada. GET /api/v1/notifications/{id} lê o resultado.

POST /api/v1/notifications/{id}/cancel interrompe uma campanha que ainda está na fila; como o cancelamento no admin, ele mantém o limite de 7 dias do produto. Se o seu sistema já cria ou substitui mapeamentos pela API, adicione notify_customers a POST /api/v1/mappings ou PUT /api/v1/mappings/{id} e os compradores daquele mapeamento são notificados assim que os novos arquivos estiverem no lugar — a espera pelo arquivo ZIP também vale ali. O limite é compartilhado com o botão: dentro da semana, a API responde 429 notification_cooldown com o momento em que o produto fica livre de novo, então agende a próxima chamada para então em vez de tentar de novo. Corpos de requisição, códigos de erro e regras de idempotência estão na referência da API.