A variável {tracking_code} retorna o(s) código(s) de rastreio do envio do pedido. Útil para mensagens em pedidos que já saíram mas ainda têm pagamento pendente (raro mas acontece) ou para mensagens de status pós-pagamento.
Não é o foco principal do plugin — a maior parte das cobranças vai pra pedidos que ainda nem saíram —, mas a variável existe e funciona pra cobrir cenários mistos.
Como o código é resolvido
O plugin tenta extrair o código de rastreio em ordem, agregando o que encontrar de cada fonte:
- Correios Automático (Infixs) — se a classe
Container::trackingService()está disponível. - WooCommerce Correios — se a função
wc_correios_get_tracking_codes()existe. - Melhor Envio — se a função
wc_melhor_envio_get_tracking_codes()existe.
Os códigos encontrados em todas as fontes são mesclados (sem duplicatas) e retornados como string separada por vírgulas:
{tracking_code} → AB123456789BR, NQ987654321BR
Integrações suportadas
| Plugin | Função/classe | Disponível em |
|---|---|---|
| Correios Automático (Infixs) | Container::trackingService() |
Versão moderna do plugin Correios da Infixs. Chamada disparada a partir da v1.7.0 do WC WhatsApp Pedidos Pendentes. |
| WooCommerce Correios | wc_correios_get_tracking_codes() |
Plugin oficial Correios (Claudio Sanches). |
| Melhor Envio | wc_melhor_envio_get_tracking_codes() |
Plugin Melhor Envio (Fernando Acosta) v3.0+. |
Se você usa o WooCommerce Correios legado E o Correios Automático novo no mesmo site, os códigos das duas fontes são exibidos juntos. Útil em migrações onde pedidos antigos têm rastreio em um plugin e os novos no outro.
Quando não há rastreio
Se nenhuma das três integrações está instalada — ou se o pedido ainda não tem código de rastreio — {tracking_code} é substituído por string vazia.
Mensagem com {tracking_code} em pedido sem envio
↓
Mensagem com em pedido sem envio
Por isso, evite mensagens que dependem do rastreio para pedidos pendentes. Use mensagens distintas:
- "Lembrete de pagamento" — sem
{tracking_code}, para pedidos não pagos. - "Confirmação de envio" — com
{tracking_code}, para pedidos pagos e despachados.
Testar
Para verificar se a variável funciona no seu site:
- Encontre um pedido que tem código de rastreio (em qualquer um dos plugins suportados).
- Crie uma mensagem temporária com texto
Teste rastreio: {tracking_code}. - Clique no botão dessa mensagem na lista de pedidos.
- O código aparece preenchido na URL do WhatsApp antes de você apertar Enter.
Próximo passo
- Variáveis dinâmicas das mensagens — todas as variáveis disponíveis.