# Como corrigir o addon Form Abandonment que não captura dados no WordPress

O WPForms Form Abandonment não funciona quando a licenca não e Pro ou superior, quando a opção Disable User Cookies esta ligada, ou quando a captura de leads não foi ativada no formulário, fazendo as entradas abandonadas nunca chegarem em WPForms Entries.

## O que é WPForms Form Abandonment que não captura dados?

O WPForms Form Abandonment e um addon que captura entradas parciais quando o visitante comeca a preencher um formulário mas sai antes de enviar. Ele dispara quando o usuário move o mouse para fora da área do navegador ou clica em um link externo, salvando o que foi digitado até ali como uma entrada do tipo Abandoned. O objetivo e transformar abandono em lead: você recupera nome, e-mail ou telefone de quem desistiu e pode fazer o follow-up. Segundo a documentação oficial, o addon exige uma licenca de nível Pro ou superior do WPForms.

Quando o addon não captura dados, o sintoma e sempre o mesmo: nenhuma entrada com o tipo Abandoned aparece em WPForms, Entries, mesmo com gente claramente desistindo do formulário. As causas reais são especificas e estão na doc do plugin: a captura de leads não foi ativada nas configurações do formulário, a opção Disable User Cookies do WPForms esta marcada (o addon depende desse cookie para rastrear o abandono), o formulário so coleta campos que o addon não salva, ou a opção escolhida exige e-mail ou telefone e o visitante saiu antes de preencher qualquer um dos dois.

## Como identificar

- Nenhuma entrada com o tipo 'Abandoned' aparece na coluna 'Type' em WPForms, Entries, mesmo após vários visitantes desistirem do formulário.
- A aba 'Form Abandonment' não aparece dentro de Settings no construtor de formulários, indicando que o addon não esta instalado ou ativo.
- O addon Form Abandonment aparece como 'Inactive' ou pede atualização de licenca na tela WPForms, Addons.
- As notificações por e-mail de abandono nunca chegam, mesmo com a opção 'Enable for abandoned forms entries' marcada.
- Campos como upload de arquivo, assinatura ou cartao de credito ficam vazios nas poucas entradas abandonadas que são salvas.

**Antes de começar:** Antes de mexer em licenca, cookies ou opções de GDPR de um site em producao, faca um backup do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para poder reverter caso o comportamento dos formulários mude.

## Como prevenir

- Mantenha a licenca Pro ou superior do WPForms ativa e verificada, já que o Form Abandonment deixa de funcionar se a licenca cair de nível ou expirar.
- Documente que a opção Disable User Cookies precisa ficar desmarcada nos sites que usam o addon, para evitar que um ajuste de privacidade desligue a captura sem querer.
- Inclua sempre um campo de e-mail ou telefone nos formulários com captura de abandono, para que a regra padrão de salvamento tenha um dado de contato para guardar.
- Ao montar formulários voltados a leads, evite depender so de campos não suportados (upload, assinatura, cartao) e revise periodicamente WPForms, Entries para confirmar que entradas Abandoned continuam chegando.

Erros relacionados

- [Como corrigir entradas que não salvam no banco de dados no WPForms](https://full.services/wp-fixer/corrigir-entries-nao-salvam-wpforms/)
- [Como corrigir o Post Submissions que não cria posts no WPForms](https://full.services/wp-fixer/corrigir-post-submissions-wpforms/)
- [Como corrigir o Survey and Polls que não exibe resultados no WPForms](https://full.services/wp-fixer/corrigir-survey-polls-resultados-wpforms/)

## Causa

- A licenca do WPForms e inferior a Pro: a documentação oficial classifica o Form Abandonment como recurso que exige nível de licenca Pro ou superior, entao em Lite, Basic ou Plus o addon nem instala.
- A opção 'Enable Form Abandonment Lead Capture' não foi ativada em Settings, Form Abandonment dentro daquele formulário específico; sem o toggle ligado, o addon não monitora o abandono.
- A configuração 'Disable User Cookies' esta marcada nas opções do WPForms: a doc afirma que o addon não funciona com esse cookie desativado, pois ele depende do cookie para rastrear o abandono, mesmo com o GDPR Enhancements desligado.
- O formulário usa a opção 'Save only if email address or phone number is provided' e o visitante saiu antes de digitar e-mail ou telefone, entao a entrada parcial e descartada por regra.
- O formulário coleta apenas campos não suportados pelo addon (Password, Signature, File Upload, Stripe Credit Card, Square ou Authorize.Net), que não tem o valor salvo durante o abandono segundo a documentação.

## Como resolver

1. Confirme a licenca Pro e instale o addon: O Form Abandonment exige licenca de nível Pro ou superior. Em WPForms, Settings, General, confirme que a chave de licenca esta verificada nesse nível. Depois va em WPForms, Addons, encontre o Form Abandonment Addon e clique em Install Addon e Activate.

```
Painel WP -> WPForms -> Settings -> General -> verificar a License Key (nível Pro+)
Painel WP -> WPForms -> Addons -> Form Abandonment Addon -> Install Addon -> Activate
```

2. Ative a captura de leads no formulário: Abra o formulário no construtor, va até a aba Form Abandonment dentro de Settings e ligue a opção Enable Form Abandonment Lead Capture. Sem esse toggle ligado naquele formulário específico, o addon não registra nenhum abandono.

```
Painel WP -> WPForms -> All Forms -> abra o formulário -> Settings -> Form Abandonment
Ligue 'Enable Form Abandonment Lead Capture'
Clique em Save no topo do construtor
```

3. Reative os cookies de usuário do WPForms: A documentação oficial diz que o addon não funciona quando Disable User Cookies esta marcado, pois o rastreamento de abandono depende desse cookie. Em WPForms, Settings, General, desmarque essa opção para o addon voltar a capturar.

```
Painel WP -> WPForms -> Settings -> General
Desmarque a caixa 'Disable User Cookies'
Clique em Save Settings
```

4. Ajuste a regra de quando salvar a entrada abandonada: Se nenhuma entrada esta sendo salva, troque a opção de captura. Save only if email address or phone number is provided so guarda quem deixou contato; Always save abandoned entries guarda qualquer abandono, útil para diagnosticar se o problema e a regra de salvamento.

```
No construtor -> Settings -> Form Abandonment
Selecione 'Always save abandoned entries' para teste
Salve e abandone o formulário você mesmo movendo o mouse para fora da janela
```

5. Confira os campos suportados e o registro das entradas: Campos Password, Signature, File Upload, Stripe Credit Card, Square e Authorize.Net não tem o valor salvo no abandono segundo a doc. Garanta que o formulário tem ao menos um campo comum (nome, e-mail, telefone) e confira a coluna Type em WPForms, Entries procurando o rotulo Abandoned.

```
No construtor -> Fields -> confirme campos comuns (Name, Email, Phone)
Painel WP -> WPForms -> Entries -> selecione o formulário
Procure a coluna 'Type' com o valor 'Abandoned'
```


## Código

```php
<?php
// Garante que o cookie de usuario do WPForms (necessario ao Form Abandonment)
// nunca seja desligado por outro plugin ou filtro de privacidade.
add_filter( 'wpforms_setting', 'full_force_wpforms_user_cookies', 20, 3 );
function full_force_wpforms_user_cookies( $value, $key, $default ) {
    if ( 'disable_user_cookies' === $key ) {
        return false; // mantem os cookies de usuario ativos
    }
    return $value;
}
```

## Perguntas frequentes

### Por que o Form Abandonment do WPForms não captura nenhum dado

Na maioria dos casos a captura não foi ativada no formulário ou a opção Disable User Cookies esta marcada. Ligue Enable Form Abandonment Lead Capture em Settings, Form Abandonment e desmarque Disable User Cookies em WPForms, Settings, General.

### Qual licenca do WPForms e preciso ter para usar o Form Abandonment

A documentação oficial classifica o Form Abandonment como recurso de nível Pro ou superior. Em licencas Lite, Basic ou Plus o addon não fica disponível para instalação, entao confirme o nível da sua chave de licenca.

### Por que a opção Disable User Cookies quebra o Form Abandonment

O addon depende do cookie de usuário do WPForms para rastrear quando alguem abandona o formulário. A doc afirma que ele não funciona com Disable User Cookies marcado, mesmo com o GDPR Enhancements desligado, entao mantenha essa caixa desmarcada.

### Onde aparecem as entradas abandonadas no WPForms

Elas aparecem em WPForms, Entries com uma coluna Type marcando o valor Abandoned quando a entrada veio de um abandono. Se nada com esse rotulo aparece, a captura provavelmente não esta ativa ou os cookies estão desligados.

### Quais campos o Form Abandonment não consegue salvar

Segundo a documentação, os campos Password, Signature, File Upload, Stripe Credit Card, Square e Authorize.Net não tem o valor salvo durante o abandono. Inclua campos comuns como nome, e-mail e telefone para garantir que a entrada parcial traga dados úteis.

### Qual a diferenca entre salvar so com contato e sempre salvar o abandono

A opção Save only if email address or phone number is provided guarda apenas quem deixou um contato, ideal para gerar leads. Já a opção Always save abandoned entries guarda qualquer abandono, útil para diagnosticar se o problema esta na regra de salvamento.

### Como receber um e-mail quando alguem abandona o formulário

Em Settings, Notifications do formulário, marque a opção Enable for abandoned forms entries. Com ela ligada, o WPForms envia o alerta de abandono junto das notificações, permitindo o follow-up rápido do lead.

### Por que so algumas entradas abandonadas são salvas

Provavelmente esta ativa a opção de salvar so quando ha e-mail ou telefone, entao quem saiu antes de preencher esses campos e descartado. Para diagnosticar, mude temporariamente para Always save abandoned entries e observe se as entradas passam a aparecer.

**Fonte:** [WPForms Docs — How to Install and Use the Form Abandonment Addon](https://wpforms.com/docs/how-to-install-and-use-form-abandonment-with-wpforms/)