Diagnóstico de formulários
O formulário mostra "Algo deu errado"? Roteiro para descobrir se o problema é credencial, lista, tag, URL ou a própria página.
Nesta página
Quando o visitante vê "Algo deu errado, tente novamente.", o serviço escolhido recusou o lead (ou o tipo de ação pós-captura não está definido). Este roteiro ajuda a achar a causa.
1. Confirme a ação pós-captura
Em Captura → Depois da Captura, o campo Tipo precisa estar definido (Redirecionar, Exibir mensagem ou Enviar arquivo). Se estiver vazio, o sistema responde com a mensagem de erro padrão. Veja Ação depois da captura.
2. Confira o serviço e as credenciais
| Serviço | O que costuma faltar |
|---|---|
| Webhook | URL vazia, ou endpoint respondendo 4xx/5xx. |
| Mautic | Domínio, usuário ou senha vazios; domínio com barra no final; API sem autenticação básica. |
| Mailchimp | API Key vazia ou Público (ID) vazio. |
| Active Campaign | Url ou Token vazios. |
| Kit | API Key vazia ou tag inexistente no Kit. |
| Mailer Lite | Api Token vazio ou e-mail inválido. |
| Send Pulse | Token (ID) ou Secret Key vazios; nome da lista diferente do cadastrado. |
| Get Response | Api Key vazia; nome da lista/campanha diferente do cadastrado. |
| RD Station | Chave com menos de 20 caracteres ou com símbolos. |
| Brevo | Api Key vazia ou Lista vazia. |
| Beehiiv | Api Key ou Publication ID vazios. |
| Converto | E-mail inválido. |
Cada integração tem seu artigo em Integrações.
3. Leia o log
O Converto registra o passo a passo das integrações no log de erros do PHP do servidor (por exemplo, wp-content/debug.log quando WP_DEBUG_LOG está ligado, ou o log do seu provedor). Cada linha começa com o nome do serviço entre colchetes:
| Prefixo | Serviço |
|---|---|
[MAUTIC] | Mautic |
[MAILCHIMP] | Mailchimp |
[AC] | Active Campaign |
[KIT] | Kit |
[MAILERLITE] | Mailer Lite |
[RDSTATION] | RD Station |
SUBSCRIBE - DEBUG COMPLETO | Fluxo geral do formulário (passos numerados [1] a [10]) |
Os logs informam, por exemplo, se a credencial estava vazia, o status HTTP da resposta e quais tags não foram encontradas. As chaves de API não são impressas por completo (no RD Station, apenas o tamanho e os últimos caracteres).
4. Sintomas frequentes
| Sintoma | Causa provável | Solução |
|---|---|---|
| Erro só para e-mails que já existem | O serviço recusa duplicados (por exemplo, Mailchimp e ActiveCampaign) | Use uma automação "criar ou atualizar" via Webhook ou trate duplicados no serviço. |
| Lead entra, mas sem tags | Tag com nome diferente ou inexistente | Confira o nome exato; em Active Campaign, GetResponse e Kit as tags precisam existir. |
| Kit retorna erro depois de criar o assinante | Tag não encontrada | Crie a tag no Kit. |
| Dois envios por lead no Webhook | Envio adicional existente no código | Deduplique por e-mail. Veja Webhook. |
| Respostas extras não chegam ao Mailchimp/Brevo… | Só o Webhook recebe campos personalizados | Use o Webhook. |
| "Nenhum arquivo para download" | Arquivo da ação pós-captura inacessível | Reenvie o arquivo na biblioteca e teste a URL. |
| Formulário não envia, sem mensagem | JavaScript bloqueado ou erro de conflito | Teste com outros plugins desativados e abra o console do navegador. |
| Caixa de aceite obrigatória travando o envio | Visitante não consentiu | Marque a caixa ou clique em Entendi no banner. Veja LGPD. |
5. Teste isolado
Crie um formulário de teste com o serviço Converto e envie. Se o lead aparecer em Contatos, o formulário e a página estão corretos e o problema está na integração externa.