Pesquisar artigos na Base de Dados de Conhecimento

Diletec – Abandono de Pedido (WooCommerce)

Produto (licença): ID 81
Compatibilidade: WordPress 5.8+, WooCommerce 5.0+
Idioma da doc: PT‑BR (plugin com PT‑BR, EN, ES)

1) Visão geral

O plugin Diletec – Abandono de Pedido envia automaticamente um e‑mail ao cliente quando um pedido ficar com status “pending” por 1 hora após a criação. Diferente de “abandono de carrinho”, aqui nos guiamos pelo pedido gerado, exibindo itens, valores e links para pagar ou ver o pedido.

Principais benefícios

  • Recuperação de vendas sem esforço.

  • Templates por idioma (PT‑BR, EN, ES) prontos para uso.

  • Multi‑moedas: valores exibidos na moeda do pedido (sem conversão).

  • Anti‑duplicidade: cada pedido recebe e‑mail uma única vez.

  • Licenciamento robusto com verificação automática.

2) Requisitos

  • WordPress 5.8+

  • WooCommerce 5.0+

  • Acesso para instalar plugins

  • Agendador do WordPress (WP‑Cron) habilitado

Dica: para melhor entregabilidade de e‑mail, configure SMTP (DKIM/SPF/DMARC no domínio do remetente).

3) Instalação e ativação

  1. Acesse Plugins → Adicionar novo → Enviar plugin e envie diletec-order-abandon.zip ou crie a pasta wp-content/plugins/diletec-order-abandon/ e coloque o arquivo diletec-order-abandon.php dentro.

  2. Ative em Plugins.

  3. Verifique se o WooCommerce está ativo.

4) Licenciamento (ID 81)

O plugin exige token de licença por domínio.

Caminho: WooCommerce → Diletec – Abandono de Pedido
Digite o Token da licença e salve.

5) Configuração de templates (CRW)

Caminho: WooCommerce → Templates (CRW)
Há um par Assunto/Corpo por idioma: PT‑BR, EN, ES.

Placeholders disponíveis

  • {customer_name} – Nome do cliente

  • {order_number} – Número do pedido

  • {order_date} – Data do pedido

  • {order_total} – Total do pedido (formatação WooCommerce)

  • {order_items_table} – Tabela de itens

  • {order_pay_url} – Link para pagamento

  • {order_view_url} – Link para visualizar pedido

O corpo aceita HTML. Incluímos um rodapé informando que o envio foi automático.

Exemplo rápido (PT‑BR)

Assunto: Você deixou seu pedido #{order_number} pendente
Corpo HTML:
<h2>Olá {customer_name}, ficou faltando concluir seu pedido.</h2>
<p>Notamos que o pedido <strong>#{order_number}</strong>, feito em {order_date}, ainda está pendente de pagamento.</p>
{order_items_table}
<p><strong>Total:</strong> {order_total}</p>
<p><a href="{order_pay_url}" target="_blank">Pagar agora</a> | <a href="{order_view_url}" target="_blank">Ver pedido</a></p>

6) Lógica de disparo (como funciona)

  • O agendador do WP (WP‑Cron) roda uma rotina a cada 10 minutos.

  • A rotina procura pedidos com status pending e criados há ≥ 1 hora.

  • Para cada pedido elegível, envia 1 e‑mail e marca o pedido com a meta _diletec_abd_email_sent para evitar duplicidade.

  • Idiomas: a seleção baseia‑se no país de cobrança do pedido (ex.: BR → PT‑BR; países hispânicos → ES; caso contrário, EN). Se o país não estiver definido, usamos o locale do site.

  • Moeda: usamos a moeda do próprio pedido (via WooCommerce).

Cobertura inicial: após ativar, a primeira varredura considera também pedidos pendentes antigos (de dias atrás), caso não tenham sido marcados como enviados.

7) Teste rápido (homologação)

  1. Faça um pedido real no site de teste com um gateway que deixe o status em pending (ex.: boleto/offline).

  2. Não conclua o pagamento.

  3. Aguarde 1 hora; o cron rodará (até 10 min de janela) e enviará o e‑mail.

  4. Verifique a caixa de e‑mail do cliente.

  5. Confirme no pedido a meta _diletec_abd_email_sent.

Para acelerar em ambientes de desenvolvimento: rode o cron manualmente (wp cron event run diletec_abd_cron) via WP‑CLI, apenas após a 1h de atraso ser verdadeira.

8) Entregabilidade de e‑mail

  • Configure SMTP no WordPress.

  • Garanta registros SPF, DKIM e DMARC no domínio do remetente.

  • Evite palavras de spam no template (ex.: “grátis!!!”).

  • Teste em contas diferentes (Gmail/Outlook/Corp.).

9) Cron / Agendamentos

  • O plugin registra o evento diletec_abd_cron (cada 10 min).

  • Trava antirace (transient) por 5 min evita duplicidade de varreduras.

  • Verificação de licença diária: diletec_abd_license_cron.

WP‑CLI (opcional, admins avançados)

# Listar eventos
wp cron event list | grep diletec
# Rodar imediatamente (use com cautela)
wp cron event run diletec_abd_cron
wp cron event run diletec_abd_license_cron

Em hospedagens com pouco tráfego, considere ativar um cron real do sistema chamando wp-cron.php periodicamente.

10) Perguntas frequentes (FAQ)

1. Ele envia e‑mail para pedidos antigos?
Sim. Na primeira varredura após a ativação, pedidos pending com mais de 1 hora (mesmo de dias atrás) são elegíveis. Para evitar, cancele os pedidos antigos ou marque‑os como já tratados antes de ativar.

2. Posso mudar o atraso de 1 hora?
Na versão 1.0.0, o atraso é fixo em 1 hora. Se precisar de outro valor, entre em contato para personalização.

3. Envia mais de um e‑mail por pedido?
Não. Usamos a meta _diletec_abd_email_sent para garantir um envio único por pedido.

4. Vai converter moeda?
Não. Exibimos os valores na moeda do pedido, usando a formatação do WooCommerce.

5. O link de pagamento funciona com qualquer gateway?
Usamos get_checkout_payment_url(true). Gateways padrão funcionam; gateways muito customizados podem não suportar o botão “Pagar agora”.

6. O WP‑Cron não está rodando. O que fazer?
Configure um cron do sistema chamando wp-cron.php, ou rode manualmente via WP‑CLI. Verifique caches e desative desativadores de cron.

7. Como traduzir o painel do plugin?
A interface suporta arquivos .po/.mo. Os templates de e‑mail já estão prontos em PT/EN/ES e podem ser editados na tela de templates.

8. Posso personalizar o HTML do e‑mail?
Sim. A tela de templates aceita HTML. Evite CSS complexo; priorize estilos inline simples.

9. Como licenciar staging e produção?
Cada domínio precisa de token válido. Use tokens específicos para cada ambiente.

10. Por que o plugin desativou sozinho?
Após 3 falhas consecutivas na verificação de licença. Corrija o token/conexão e reative.

11) Solução de problemas

  • Nenhum e‑mail enviado:

    • Verifique se há pedidos pending com 1h+.

    • Confirme que o WP‑Cron está rodando.

    • Teste envio básico de e‑mail do WordPress/SMTP.

    • Cheque se o pedido já possui a meta _diletec_abd_email_sent.

  • Licença em erro:

    • Cheque token, domínio e conectividade externa.

    • Use o botão “Checar licença agora”.

    • Após 3 falhas, o plugin se desativa; reative após corrigir.

  • Template sem links:

    • Garanta {order_pay_url} e {order_view_url} no HTML.

    • Teste com um pedido de exemplo.

12) Boas práticas para conversão

  • Mantenha o assunto claro e curto.

  • Use gatilho de urgência/escassez com moderação.

  • Deixe o botão “Pagar agora” visível no topo.

  • Inclua o telefone/WhatsApp de suporte no rodapé.

13) Limitações (v1.0.0)

  • Atraso fixo de 1 hora (sem painel para alterar).

  • Não há reenvio automático (apenas 1 e‑mail).

  • Sem relatórios no painel (use relatórios de pedidos do WooCommerce).

14) Segurança e privacidade

  • O plugin só usa dados do pedido para compor o e‑mail.

  • Não armazena dados fora do WordPress.

  • Respeite LGPD/GDPR: informe o cliente sobre comunicações transacionais.

15) Desinstalação

  • Desativar em Plugins.

  • Remoção do arquivo do plugin.

  • As metas em pedidos existentes podem permanecer para histórico (_diletec_abd_email_sent).

16) Changelog

1.0.0

  • Versão inicial: disparo de abandono de pedido (1h), templates PT/EN/ES, licença ID 81, anti‑duplicidade, suporte multi‑moeda.

17) Suporte

  • Antes de abrir ticket, revise as seções FAQ e Solução de problemasInclua nas solicitações: versão do WP/Woo, logs de e‑mail/SMTP, se o cron está ativo e um exemplo de pedido (ID).

Você achou esse artigo útil?