FernandoAcosta.Netdocs

Banner por e-mail

2 min de leituraAtualizado há 5 dias

O banner por e-mail insere uma imagem clicável nos e-mails de confirmação de pedido. O clique abre a pesquisa Ebit já pré-preenchida com os dados da compra.

É opcional — fica desativado até você preencher a URL.

Ativar

Em WooCommerce → Configurações → Integração → Ebit, preencha Banner por e-mail com a URL pública de uma imagem aprovada pelo Ebit.

Quando a URL está preenchida e o ID da Loja existe, o banner é injetado no e-mail.

Imagem precisa ser aprovada

O Ebit valida apenas banners que seguem a especificação visual deles. Use a arte fornecida pelo painel Ebit ou submeta a sua pra aprovação antes de subir.

Onde é injetado

Por padrão, o banner é colocado no hook woocommerce_email_order_details com prioridade 100.

Pra mudar pra outro hook do e-mail (por exemplo, o rodapé):

add_filter( 'wc_ebit_email_filter', function( $filter ) {
    return 'woocommerce_email_footer';
});

Regras de exibição

O banner só aparece se as 4 condições forem verdadeiras:

  1. ID da Loja está preenchido.
  2. Banner por e-mail está com URL.
  3. O e-mail não é destinado ao admin ($sent_to_admin é false).
  4. O pedido foi criado há menos de 24 horas.

Se o pedido tem mais de 24h, o banner não aparece — o cliente já passou da janela útil pra avaliar.

E-mails ignorados

Por padrão, o banner é suprimido em três tipos de e-mail:

  • failed_order — pedido com falha.
  • customer_refunded_order — pedido reembolsado.
  • cancelled_order — pedido cancelado.

Não faz sentido pedir avaliação Ebit em pedidos que não foram concluídos.

Pra suprimir em mais tipos (por exemplo, o e-mail de "processando"):

add_filter( 'wc_ebit_not_allowed_emails', function( $emails ) {
    $emails[] = 'customer_processing_order';
    return $emails;
});

A URL gerada no clique tem o formato:

https://newsurvey.ebit.com.br/Survey/Open/<ID-da-Loja>?storeId=...&transactionId=...&email=...

Todos os dados do pedido vão como query string. Pra customizar parâmetros desse link especificamente (sem afetar o banner da página de obrigado):

add_filter( 'wc_ebit_banner_link_params', function( $args, $order ) {
    $args['campanha'] = 'email-blackfriday';
    return $args;
}, 10, 2 );

Pra reescrever a URL inteira:

add_filter( 'wc_ebit_banner_link', function( $url, $order ) {
    return 'https://meu-dominio.com/avaliar/' . $order->get_id();
}, 10, 2 );

Próximos passos

Foi útil?