Conectar o MailerLite à Qualisend
A Qualisend verifica os seus assinantes do MailerLite e grava cada resultado em cinco campos do assinante, que você pode usar em segmentos para tirar os endereços ruins das suas campanhas. Este guia cobre a conexão, a escolha da origem, as verificações em tempo real de novos assinantes, os agendamentos e os erros que podem aparecer.
- Conexão via
- Um API token do MailerLite
- Origens
- Assinantes ativos: todos, por grupo ou por segmento
- Grava
- 5 campos de assinante
- Nunca altera
- O status do assinante nem os grupos dele
- Tempo real
- Com um clique: a Qualisend cria o webhook
- Por limpeza
- Até 1.000.000 assinantes ativos
Os menus, botões e campos do MailerLite aparecem em inglês neste guia; se você usa o MailerLite em outro idioma, eles podem estar traduzidos. A página do MailerLite na Qualisend também está em inglês por enquanto.
Atualizado em
Antes de começar
- Uma conta na Qualisend. Você pode criar uma de graça.
- A função de Proprietário ou Administrador da Qualisend, necessária para conectar o MailerLite (quem pode fazer o quê).
- Acesso a Integrations → API na sua conta do MailerLite, para criar um API token.
- Créditos suficientes para os assinantes ativos que você pretende verificar.
Conecte o MailerLite
- 1
Encontre o MailerLite na Qualisend
Na barra lateral da Qualisend, entre em Integrações e abra o card MailerLite, no grupo E-mail marketing.
- 2
Crie um API token no MailerLite
No MailerLite, vá a Integrations → API, clique em Generate new token e copie o token. Guarde-o em sigilo, como uma senha. As verificações em tempo real precisam de um token que possa gerenciar webhooks: se o MailerLite oferecer opções de acesso ao criar o token, dê acesso total a ele.
- 3
Cole o token e conecte
De volta à Qualisend, cole o token em MailerLite API key e clique em Connect. A Qualisend confere o token com o MailerLite, o que leva alguns segundos. Em seguida, aparece “MailerLite connected.” e o rótulo Connected ao lado do nome do MailerLite.
O que você pode limpar
Em What to clean, o seletor oferece três tipos de origem:
- Subscribers, com uma única opção, All subscribers: todos os assinantes ativos da conta. Assinantes com outro status, como descadastrados, com bounce ou não confirmados, ficam de fora.
- Groups: os membros ativos de um grupo. O seletor lista os seus primeiros 1.000 grupos.
- Segments: as pessoas que o MailerLite inclui naquele segmento no momento. O seletor lista os seus primeiros 300 segmentos.
Para All subscribers e para os grupos, a linha abaixo do seletor mostra quantos assinantes ativos a Qualisend encontrou e quantos créditos a limpeza pode usar no máximo. Os segmentos não mostram número ali, porque as contagens de segmentos do MailerLite não são confiáveis; eles são contados durante a leitura.
Se o MailerLite não retornar os seus segmentos, só aparecem Subscribers e Groups. Recarregue a página mais tarde para vê-los de novo.
Faça uma limpeza
- 1
Escolha uma origem e o que fazer
Escolha uma origem em What to clean e uma opção em What to do with the results:
- Tag contacts with results registra cada resultado nos campos da Qualisend do assinante. Não adiciona tags do MailerLite nem move ninguém de grupo.
- Verify & export a clean list verifica os endereços sem alterar nada no MailerLite; você baixa os resultados.
Por enquanto, deixe Repeat em Just once; os agendamentos são explicados mais abaixo. O mesmo formulário fica também na página Limpeza em massa.
- 2
Inicie e acompanhe o progresso
Clique em Verify & clean. Uma mensagem confirma o que a Qualisend está lendo, e a página de resultados aparece. Enquanto os assinantes são lidos do MailerLite, ela mostra Preparando sua lista…; no caso de um segmento, o número de linhas é só uma estimativa até lá. A verificação começa assim que a leitura termina, e a página de resultados funciona como em qualquer outra plataforma.
- 3
Confira um assinante no MailerLite
Se você escolheu Tag contacts with results, a Qualisend grava os campos em lotes depois que a limpeza inteira termina; com centenas de milhares de assinantes, conte com algumas horas. Depois, abra no MailerLite um assinante dessa origem: Qualisend Status e os outros campos da Qualisend mostram o resultado dele.
Os campos da Qualisend no MailerLite
Tag contacts with results grava cinco campos personalizados em todo assinante verificado, inclusive nos que dão unknown. A Qualisend cria esses campos na sua conta assim que grava resultados pela primeira vez, e um resultado novo sempre sobrescreve o anterior. Nada mais muda no assinante: status, grupos e consentimento ficam como estão.
| Campo | O que contém |
|---|---|
| Qualisend StatusTexto · qualisend_status | O veredito: deliverable, risky, undeliverable ou unknown |
| Qualisend ScoreNúmero · qualisend_score | Um número de 0 a 100 |
| Qualisend ReasonTexto · qualisend_reason | O motivo, na forma de um código como accepted_email, invalid_domain ou timeout |
| Qualisend FlagsTexto · qualisend_flags | Sinais extras, separados por vírgulas: free_mail, disposable, role, catch_all, full_mailbox ou disabled. Em branco quando não há nenhum. |
| Qualisend CheckedData · qualisend_checked | A data da verificação |
O guia de status explica cada veredito.
Tire os endereços ruins dos seus envios
Para deixar endereços ruins fora de uma campanha, crie no MailerLite um segmento com uma condição em Qualisend Status que exclua undeliverable e envie para esse segmento. Exclua também risky se preferir ser rigoroso; O que fazer com cada resultado indica uma ação para cada veredito.
Qualisend Score é um campo numérico, então as condições de segmento podem compará-lo: por exemplo, para segurar tudo o que ficar abaixo de uma pontuação escolhida por você.
Excluir ou descadastrar os endereços ruins fica a seu critério; a Qualisend nunca faz isso.
Verifique novos assinantes assim que entram
As verificações em tempo real conferem cada novo assinante pouco depois de o MailerLite avisar sobre ele e gravam o resultado nesses mesmos cinco campos. Basta um clique para ativá-las, porque é a Qualisend que cria o webhook dentro da sua conta do MailerLite.
Para formulários de cadastro no seu próprio site, você também pode verificar os endereços antes que cheguem ao MailerLite com a API de verificação (em inglês).
- 1
Escolha quais assinantes verificar
Na página do MailerLite na Qualisend, clique em Set up no card Real-time verify-on-signup; essa ação exige a função de Proprietário ou Administrador. Em Which subscribers to check, escolha:
- All new subscribers: todos que se inscrevem pelos seus formulários. Importações e cadastros pela API também podem contar.
- Only when someone joins a group: escolha o grupo em Choose a group…. Assinantes existentes que forem adicionados a esse grupo também são verificados.
- 2
Ative as verificações em tempo real
Clique em Turn on real-time checks: um webhook chamado Qualisend real-time verification, criado pela Qualisend, aparece na sua conta do MailerLite; não há nada para copiar e colar. Depois, o card mostra Real-time checks are on. Change altera a configuração, e Turn off exclui o webhook de novo.
- 3
Faça um teste
Inscreva-se em um dos seus formulários do MailerLite com um endereço seu. Depois de um minuto, atualize a página da Qualisend: o card indica a hora da última verificação recebida, e o campo Qualisend Status do assinante traz o resultado.
- 4
Adie o e-mail de boas-vindas até o resultado chegar
Na automação do MailerLite responsável pelo e-mail de boas-vindas, inclua uma espera curta antes do envio e, em seguida, uma condição em Qualisend Status: mande o e-mail sempre que o status não for
undeliverable, para que quem ainda não teve a verificação concluída também o receba.Os campos da Qualisend só passam a existir no MailerLite depois que resultados são gravados pela primeira vez. Se Qualisend Status ainda não estiver na lista, aguarde o resultado do assinante de teste ou limpe um grupo com Tag contacts with results selecionado.
- Um mesmo endereço só é verificado de novo depois de 7 dias, seja qual for a opção escolhida.
- Assinantes que ainda não confirmaram o double opt-in são verificados; os descadastrados, os com bounce e os marcados como junk são ignorados.
- Importações e cadastros pela API também podem disparar verificações. Antes de uma importação grande, leia Verificações em tempo real, que também explica os créditos e o que acontece com o saldo zerado.
- Em Webhooks pointing at Qualisend, o card lista os webhooks do MailerLite que enviam dados para cá e mostra Working, Needs a fix ou Can't check ao lado de cada um. Um webhook com problema vem com uma nota dizendo o que está errado.
- Prefere uma automação? A seção Set it up manually instead do card explica como adicionar uma etapa Webhook, disponível nos planos pagos do MailerLite, a uma automação que começa com When subscriber joins a group. A URL dessa etapa identifica o seu espaço de trabalho: guarde-a só para você.
Agende a limpeza
Em Repeat, escolha de quanto em quanto tempo repetir e clique em Verify & clean: a limpeza roda agora e depois se repete (como os agendamentos funcionam). Cada origem tem um só agendamento, então agendar a mesma origem de novo substitui o anterior. Se a execução anterior deste agendamento ainda não terminou (incluindo a gravação dos resultados), a próxima espera e tenta de novo cerca de uma hora depois.
Os agendamentos ficam em Scheduled auto-cleans, na página do MailerLite, onde uma execução também pode aparecer como:
- Last run: no contacts: o grupo, ou a conta inteira, não tinha assinantes ativos.
- Skipped - reconnect MailerLite: o MailerLite não estava conectado na data da execução. Quando você conectar de novo, o agendamento continua a partir da próxima data.
Limites e créditos
- Em cada execução, inclusive nas automáticas, são lidos até 1.000.000 assinantes ativos da origem. Numa origem maior, cada execução limpa os primeiros 1.000.000.
- Os créditos de que uma limpeza precisa são reservados no início, com base na contagem do próprio MailerLite. Um segmento não tem contagem confiável, então a Qualisend reserva uma estimativa de até 5.000 créditos e acrescenta mais durante a leitura.
- Se o seu saldo acabar enquanto os assinantes ainda estão sendo lidos, a Qualisend para de ler e limpa os assinantes que já tem.
- Os créditos reservados além do que foi de fato lido voltam quando a leitura termina. As demais regras de créditos estão em Como os créditos são contados.
Desconecte ou reconecte
Clique em Disconnect na página do MailerLite. Não há etapa de confirmação, e só quem tem a função de Proprietário ou Administrador consegue fazer isso.
O que acontece em seguida:
- A Qualisend remove o seu API token e exclui do MailerLite o webhook Qualisend real-time verification que ela criou. Se isso falhar, uma mensagem avisa; nesse caso, exclua você mesmo o webhook em Integrations → API, Webhooks.
- Os seus assinantes mantêm os campos da Qualisend e os valores já gravados.
- Os agendamentos continuam, mas cada execução mostra Skipped - reconnect MailerLite até você conectar de novo.
- Uma limpeza que ainda esteja lendo assinantes termina com Falha na verificação, e uma que ainda esteja gravando resultados para de gravá-los.
- Os resultados de limpezas anteriores ficam guardados na Qualisend.
Para conectar de novo, cole um token como nos primeiros passos. Depois de reconectar, as verificações em tempo real ficam desativadas, então ative-as outra vez.
Se a Qualisend avisar que a URL do seu webhook de tempo real mudou, cole a nova URL em todas as automações do MailerLite que enviam assinantes para a Qualisend.
Solução de problemas
“MailerLite rejected that API key. Check it and try again.”
“Couldn't reach MailerLite — try again.”
“MailerLite is busy. Try again in a minute.”
“Couldn't load MailerLite: could not load mailerlite groups”
“That group no longer exists in MailerLite. Pick another one.”
“0 active subscribers - nothing to clean here”
“MailerLite didn't let the saved API key manage webhooks. Reconnect with a key that has full access, or set it up manually (below).”
Meu segmento não mostra o número de assinantes
Nenhum dos meus assinantes recebeu os campos da Qualisend
Alguns assinantes estão sem os campos
Minha limpeza falhou
Os novos assinantes não estão sendo verificados
Veja também
Obter ajuda
Ainda não resolveu? Use o formulário de contato ou escreva para hello@qualisend.com. Informe a mensagem que aparece na tela e mais ou menos quando ela surgiu.