Notificações por e-mail

O Correios Updater dispara dois e-mails — um pro cliente quando o status muda, outro pro admin quando uma entrega falha. Você gerencia ambos em WooCommerce → Configurações → E-mails.

E-mail do cliente: andamento da entrega

ID: wc_correios_status_updater_status_changed Destinatário: o e-mail de cobrança do pedido.

Quando é enviado

• Sempre que o plugin processa um evento novo dos Correios pro pedido (entregue, saiu pra entrega, aguardando retirada).
• Apenas se o e-mail estiver habilitado em WooCommerce → Configurações → E-mails.
• Apenas se o pedido tem menos de 40 dias desde que foi criado.

Configurações disponíveis

• Habilitar/Desabilitar — liga ou desliga.
• Assunto — suporta {site_title} e {order_number}. Padrão: [{site_title}] Oba! O pedido {order_number} está mais perto de você!
• Cabeçalho — texto que aparece no topo do e-mail.
• Conteúdo — corpo do e-mail. Suporta {tracking_code}. Padrão:

Olá! O status do seu pedido acaba de ser atualizado pelos Correios.

Você pode acompanhar o status da entrega no site dos Correios. O código de rastreio é: {tracking_code}

Para sua conveniência, colocamos as últimas atualizações sobre sua entrega logo abaixo.

Template

Arquivo padrão: templates/emails/correios-tracking-update.php. Pra customizar, copie pra seu-tema/woocommerce/emails/correios-tracking-update.php.

Variáveis disponíveis no template:

• $order — objeto WC_Order.
• $email_heading — texto do cabeçalho.
• $tracking_update_message — corpo processado.
• $events — array com todos os eventos retornados pelos Correios.
• $code — código de rastreio.
• $sent_to_admin — false (é e-mail de cliente).

E-mail do admin: falha na entrega

ID: wc_correios_status_updater_delivery_failed Destinatário: o(s) e-mail(s) configurado(s) (padrão: e-mail do admin do WordPress).

Quando é enviado

• Sempre que o plugin detecta um evento de falha (entrega não realizada, devolução, recusa, retenção em alfândega, etc).
• Apenas se o e-mail estiver habilitado.

Configurações disponíveis

• Habilitar/Desabilitar.
• Destinatário(s) — separe vários por vírgula.
• Assunto — padrão: [{site_title}] Houve uma falha na entrega do pedido #{order_number}
• Cabeçalho.
• Conteúdo — suporta vários placeholders. Padrão:

Olá! O status do rastreamento do pedido #{order_number} acaba de ser atualizado pelos Correios e houve um problema na entrega ao cliente.

O código de rastreio associado é: {tracking_code}

Descrição: {description}

Detalhes: {details}

Ação: {action}

Para sua conveniência, colocamos as últimas atualizações sobre a entrega logo abaixo.

Placeholders disponíveis

• {order_number} — número do pedido.
• {order_id} — ID do pedido.
• {date} — data de criação.
• {tracking_code} — código de rastreio que falhou.
• {description} — descrição vinda dos Correios.
• {details} — detalhes adicionais (quando os Correios retornam).
• {action} — ação recomendada pelos Correios.
• {site_title} — nome do site.

Template

Arquivo padrão: templates/emails/correios-delivery-failed.php. Customize copiando pra seu-tema/woocommerce/emails/correios-delivery-failed.php.

Bloqueando e-mails programaticamente

Pra impedir o envio em casos específicos (ex: pedidos de teste), use o filtro wc_correios_status_updater_trigger_email. Exemplo:

add_filter( 'wc_correios_status_updater_trigger_email', function( $should_send, $events, $code, $order ) {
    if ( $order->get_meta( 'is_test_order' ) ) {
        return false;
    }
    return $should_send;
}, 10, 4 );

Mais filtros relacionados em Filtros disponíveis.

E-mails não estão chegando?

Veja Solução de problemas — a seção sobre e-mails cobre os cenários mais comuns.