# Número de seguimento no e-mail Enviado: guia completo
> Visão geral O Número de seguimento no e-mail Enviado adiciona um bloco Acompanhe a sua encomenda ao e-mail Enviado do PrestaShop: a transportadora, o número de seguimento e um botão…
- Página:
- Idioma: pt
- Atualizado em: 2026-11-03
- Outros idiomas: [en](https://www.datafirefly.com/en/documentation/dftrackingmail/index.md), [fr](https://www.datafirefly.com/documentation/dftrackingmail/index.md), [es](https://www.datafirefly.com/es/documentation/dftrackingmail/index.md), [de](https://www.datafirefly.com/de/documentation/dftrackingmail/index.md), [it](https://www.datafirefly.com/it/documentation/dftrackingmail/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftrackingmail/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftrackingmail/index.md)
- Índice:
## Visão geral
O Número de seguimento no e-mail Enviado adiciona um bloco **Acompanhe a sua encomenda** ao e-mail Enviado do PrestaShop: a transportadora, o número de seguimento e um botão que abre a página de seguimento da transportadora. O bloco é redigido no idioma da encomenda e inserido durante o envio do e-mail: os seus modelos de e-mail nunca são alterados.
O módulo também pode **reter o e-mail Enviado** quando uma encomenda é marcada como enviada antes de o número de seguimento ser introduzido, e enviá-lo assim que o número for guardado. Mostra um cartão de seguimento na conta do cliente e disponibiliza uma pré-visualização em direto, um e-mail de teste, uma fila e um registo de atividade.
Funciona no PrestaShop 1.7.8 a 9.x com PHP 7.1 a 8.5, em Classic, Hummingbird e nos respetivos temas filho. O back office e os textos predefinidos estão disponíveis em inglês, francês, espanhol, alemão, italiano, polaco, neerlandês e português.
O separador Visão geral: estado, indicadores dos últimos 30 dias, lista de primeiros passos e atividade recente.
## Instalação e atualização
1. Em **Módulos > Gestor de Módulos**, clique em **Carregar um módulo** e largue o ficheiro `dftrackingmail-2.0.0.zip`.
2. Clique em **Configurar**. O módulo já está ativo no e-mail Enviado, com textos predefinidos em todos os idiomas instalados.
Uma mensagem de boas-vindas indica os três pontos a verificar: os links de seguimento das suas transportadoras, as cores do bloco e um e-mail de teste.
**Atualização a partir da 1.0:** carregue o novo zip por cima do antigo. As suas definições, textos, cores, links das transportadoras e e-mails retidos são mantidos. O cartão da conta do cliente começa desativado, por isso nada muda na sua loja até o ativar.
## Definições
### Ativação
- **Adicionar os dados de seguimento aos e-mails**: desativado, todos os e-mails são enviados exatamente como o PrestaShop os gera.
- **Mostrar um cartão de seguimento na conta do cliente**: na página de detalhes da encomenda e na página de seguimento para visitantes.
### E-mails que mostram o número de seguimento
O estado Enviado predefinido envia o e-mail `shipped`, selecionado por predefinição. Cada estado de encomenda que envia um e-mail é listado com o respetivo modelo, pelo que pode adicionar estados personalizados ou o e-mail `in_transit`.
### Dados e privacidade
Escolha durante quanto tempo o registo de atividade e os e-mails enviados são conservados (90 dias por predefinição). A cópia de um e-mail retido é eliminada assim que este é enviado ou cancelado. Com o módulo oficial de RGPD, os dados do cliente são exportados e eliminados com o resto da conta.
O separador Definições: ativação, e-mails abrangidos, retenção do e-mail e conservação dos dados.
## Reter o e-mail até o número de seguimento ser introduzido
Se mudar o estado para Enviado antes de imprimir a etiqueta, o e-mail predefinido é enviado sem qualquer número. Ative **Reter o e-mail**: o e-mail Enviado aguarda então numa fila e é enviado assim que o número de seguimento for guardado, na página da encomenda ou por um módulo de transportadora.
- **Enviar mesmo assim após**: o e-mail é enviado sem número (ou com a mensagem de espera) após este prazo, 48 horas por predefinição.
- **E-mail Em trânsito**: o PrestaShop envia-o quando é introduzido um número de seguimento. Por predefinição, é ignorado quando o e-mail Enviado retido acabou de ser enviado, para que o cliente receba um único e-mail completo em vez de dois.
- Só são retidas as transportadoras com **Número de seguimento previsto** assinalado no separador Transportadoras. O levantamento na loja e as outras transportadoras sem seguimento nunca são retidos.
Na página da encomenda, um cartão mostra os números que o cliente verá, o estado do e-mail retido e duas ações: **Enviar agora sem número de seguimento** e **Não enviar**.
Página da encomenda: o e-mail Enviado fica retido até o número de seguimento ser introduzido.
### Tarefa cron
A tarefa cron só é necessária com a retenção ativada. Execute-a a cada 15 minutos: envia os e-mails retidos cujo número foi escrito por um módulo de transportadora, ou cujo prazo terminou, e elimina as entradas antigas. Copie o URL no separador Definições (funciona em modo de manutenção) ou use a linha de comandos:
```
php /path/to/prestashop/modules/dftrackingmail/cli/process-queue.php
```
**Gerar um novo URL** invalida o anterior.
## E-mail e textos
### Posição no e-mail
- **Após a referência da encomenda** (recomendado): logo a seguir à frase que indica a referência da encomenda.
- **Logo após a saudação**: visto primeiro.
- **Manual**: o bloco só aparece onde o seu modelo contém `{df_tracking_block}`.
### Estilo e cores
Escolha um estilo cartão, barra de destaque ou minimalista e, depois, as cores do fundo, do contorno, do botão e do texto do botão. O contraste do botão é verificado em direto: abaixo de 4.5:1, o texto é difícil de ler e é mostrado um aviso.
### Conteúdo e textos
Mostre ou oculte o nome da transportadora e o botão de seguimento, e escolha o que acontece quando a encomenda ainda não tem número de seguimento: ocultar o bloco ou mostrar a mensagem de espera. Os textos são editados por idioma: título, introdução, rótulos da transportadora e do número, texto do botão, mensagem de espera e rótulo do pacote. A introdução aceita `{firstname}`, `{lastname}`, `{order_name}`, `{carrier_name}` e `{tracking_number}`; o rótulo do pacote aceita `{n}` e `{total}`.
A pré-visualização em direto, à direita, acompanha as suas alterações antes de guardar, no idioma selecionado para os textos, num computador ou num telemóvel.
O separador E-mail e textos com a pré-visualização em direto.
## Transportadoras e links de seguimento
O botão de seguimento usa o URL de seguimento definido em **Envio > Transportadoras**. Preencha o campo de uma transportadora para o substituir apenas nos e-mails. Coloque `{tracking_number}` (ou `@`, a sintaxe do PrestaShop) no lugar do número; `{postcode}` e `{country_iso}` são preenchidos a partir da morada de entrega para as transportadoras que precisam deles.
- Aparece uma sugestão quando o nome da transportadora é reconhecido; **Outras transportadoras** lista 21 links de seguimento (Colissimo, Chronopost, Mondial Relay, DPD, GLS, UPS, FedEx, DHL, PostNL, bpost, Correos, SEUR, CTT, Poste Italiane, BRT, InPost, Poczta Polska, Royal Mail, USPS, 17TRACK).
- **Testar** abre o link com um número de exemplo.
- **Número de seguimento previsto**: desmarque as transportadoras que nunca têm número. O seu e-mail nunca é retido e não são contadas como sem link.
Teste cada link uma vez com um número real: as transportadoras por vezes mudam o endereço da sua página de seguimento.
Transportadoras, links de seguimento, sugestões e botão Testar.
## Pré-visualização e teste
O separador Pré-visualização e teste mostra o e-mail completo, gerado a partir dos modelos da sua loja: com dados de exemplo fictícios (um pacote, dois pacotes ou ainda sem número) ou com uma encomenda recente. Escolha o idioma e o e-mail e alterne entre a versão HTML, a versão texto e a vista em telemóvel.
**Enviar um e-mail de teste** envia o e-mail selecionado para o endereço que introduzir, com **[Teste]** no assunto. O cliente não recebe nada. O teste utiliza as definições guardadas.
Pré-visualização do e-mail Enviado de uma encomenda real e e-mail de teste enviado.
## O que os seus clientes recebem
O bloco mostra a transportadora, o número de seguimento numa fonte legível e o botão de seguimento. Quando uma encomenda tem vários pacotes, cada um é numerado com o seu próprio botão. A versão texto do e-mail contém as mesmas informações.
O e-mail Enviado com o bloco de seguimento.
Num telemóvel, com dois pacotes.
## Conta do cliente
Com a opção ativada, a página de detalhes da encomenda e a página de seguimento para visitantes mostram um cartão de seguimento com a transportadora, o número, um botão **Copiar** e o botão de seguimento. O cartão usa os textos do bloco e adapta-se a Classic, Hummingbird e aos respetivos temas filho.
Cartão de seguimento na página de detalhes da encomenda.
O mesmo cartão num telemóvel.
## Fila e atividade
O separador **Fila e atividade** lista os e-mails retidos, com filtros por estado (retido, enviado, falhado, cancelado). **Enviar agora** e **Não enviar** atuam sobre um e-mail; **Processar a fila agora** executa de imediato a tarefa cron. Um e-mail falhado é reenviado automaticamente três vezes e o motivo é mostrado.
O registo de atividade regista cada e-mail: seguimento adicionado, enviado sem número, retido, e-mail retido enviado, e-mail Em trânsito ignorado, e-mail de teste.
E-mails retidos e registo de atividade.
## Posição manual e variáveis
Com a posição manual, adicione estas variáveis ao seu modelo de e-mail (Design > Tema de e-mail, a pasta mails do seu tema ou um módulo de edição de e-mails):
- `{df_tracking_block}`: o bloco completo, versão HTML.
- `{df_tracking_block_txt}`: o bloco completo, versão texto.
- `{df_tracking_number}`: o número ou os números de seguimento, separados por vírgulas.
- `{df_tracking_url}`: o link de seguimento do primeiro pacote.
- `{df_carrier_name}`: o nome ou os nomes da transportadora.
O separador Ajuda: como funciona, variáveis e perguntas frequentes.
## Resolução de problemas
### O cliente recebeu o e-mail sem número de seguimento
A encomenda passou a Enviado antes de o número ser introduzido. Ative a retenção no separador Definições. A tabela Atividade mostra cada e-mail com ou sem número.
### O botão de seguimento não aparece
A transportadora não tem um link de seguimento utilizável. Abra o separador Transportadoras, use uma sugestão ou cole o link da transportadora e clique em **Testar**.
### Os e-mails retidos não são enviados
O número foi escrito por um módulo de transportadora, ou o prazo terminou, mas a tarefa cron não é executada. O separador Visão geral mostra um aviso quando esta não é executada há mais de 2 horas. Configure-a com o URL ou a linha de comandos, ou clique em **Processar a fila agora**.
### O e-mail está no idioma errado
O e-mail usa o idioma da encomenda. Se o PrestaShop não tiver modelo neste idioma, envia o idioma predefinido: a pré-visualização indica-lhe que versão é usada.