Skip to content
Comece com 100 créditos de verificação grátis
Qualisend
Guia de integração

Conectar o ActiveCampaign à Qualisend

A Qualisend verifica os endereços de e-mail da sua conta do ActiveCampaign e grava cada resultado no próprio contato, em cinco campos personalizados, para você deixar os endereços ruins fora dos seus envios. Este guia mostra a configuração, as verificações em tempo real, os agendamentos e como resolver os erros mais frequentes.

Conexão via
API URL e API key
Quem pode conectar
Proprietário ou Administrador do espaço de trabalho
Grava
5 campos personalizados
Nunca altera
Inscrições, associação a listas ou tags
Custo
1 crédito por endereço verificado
Por limpeza
Até 1.000.000 contatos

Neste guia, os nomes dos menus do ActiveCampaign estão em inglês; se você usa o ActiveCampaign em português, eles podem aparecer traduzidos. A página do ActiveCampaign na Qualisend também está em inglês por enquanto.

Atualizado em

Antes de começar

  • Uma conta na Qualisend. Crie a sua se ainda não tiver.
  • A função de Proprietário ou Administrador no seu espaço de trabalho da Qualisend para conectar; as demais funções estão em quem pode fazer o quê.
  • Um usuário do ActiveCampaign que consiga abrir Settings → Developer e editar contatos e campos personalizados. A Qualisend usa a API key desse usuário.
  • Créditos suficientes para os contatos que você quer verificar.

Conecte e faça uma primeira limpeza

  1. 1

    Abra o ActiveCampaign na Qualisend

    Na Qualisend, clique em Integrações na barra lateral e depois no card ActiveCampaign, em E-mail marketing.

    Página Integrações da Qualisend com o card do ActiveCampaign destacado em E-mail marketing
  2. 2

    Copie a API URL e a API key

    No ActiveCampaign, clique em Settings (o ícone de engrenagem) e depois em Developer. Na seção API Access, use Copy API Url e Copy API Key. Proteja a API key como se fosse uma senha.

    Página Settings, Developer do ActiveCampaign: a seção API Access com os campos URL e Key e seus botões de copiar, e o botão Manage Webhooks logo abaixo
  3. 3

    Cole os dois valores e conecte

    De volta à Qualisend, cole os valores em API URL e API key e clique em Connect. A verificação leva alguns segundos. Se der certo, a página mostra Connected e o endereço da sua conta, por exemplo youraccount.api-us1.com. A URL funciona com ou sem /api/3 no final.

    Formulário de conexão do ActiveCampaign na Qualisend, com API URL e API key preenchidas
  4. 4

    Escolha o que limpar

    Em What to clean, escolha All contacts ou uma lista. Logo abaixo, a Qualisend mostra quantos contatos encontrou e o máximo de créditos que a limpeza pode consumir. Depois, em What to do with the results, escolha:

    • Tag contacts with results grava cada resultado no contato, dentro do ActiveCampaign. Apesar do nome, a opção preenche campos personalizados, e não tags do ActiveCampaign.
    • Verify & export a clean list não mexe no ActiveCampaign. Em vez disso, você baixa os resultados.

    Deixe Repeat em Just once, a menos que queira uma limpeza automática. O mesmo formulário também está em Limpeza em massa.

    Página do ActiveCampaign na Qualisend, já conectada, com a lista Newsletter selecionada: 1.240 contatos, até 1.240 créditos
  5. 5

    Inicie a limpeza

    Clique em Verify & clean. A Qualisend abre a página de resultados da limpeza, que mostra Preparando sua lista… enquanto lê os contatos do ActiveCampaign. Depois disso, os endereços são verificados; a página de resultados explica o resto.

    Página de resultados da Qualisend da limpeza da lista Newsletter do ActiveCampaign, com Verificação concluída e a divisão dos resultados
  6. 6

    Confira um contato no ActiveCampaign

    Com Tag contacts with results, os campos são gravados depois que todos os endereços são verificados. Abra no ActiveCampaign qualquer contato dessa lista: Qualisend Status e os demais campos da Qualisend trazem o resultado dele. Um campo fica vazio quando não há nada a registrar, como Qualisend Flags em um endereço sem sinalizadores.

    Detalhes de um contato do ActiveCampaign: Qualisend Status deliverable, Score 98, Reason accepted_email, Flags vazio e a data da verificação

Campos gravados nos seus contatos

Com Tag contacts with results, a Qualisend preenche cinco campos personalizados em cada contato que verifica. Ela cria os campos na primeira vez que grava resultados e os deixa disponíveis em todas as suas listas. Cada novo resultado substitui o anterior.

CampoO que contém
Qualisend StatusTextodeliverable, risky, undeliverable ou unknown
Qualisend ScoreTextoUm número de 0 a 100, gravado como texto
Qualisend ReasonTextoUm código: accepted_email, low_deliverability, low_quality, invalid_email, invalid_domain, rejected_email, timeout, unavailable_smtp ou unknown
Qualisend FlagsTextoQualquer combinação de free_mail, disposable, role, catch_all, full_mailbox, disabled, separados por vírgulas. Fica vazio quando nenhum se aplica.
Qualisend CheckedDataO dia da verificação

Para saber o que significa cada status, consulte o guia de status.

Use os campos no ActiveCampaign

Para manter endereços ruins fora das campanhas, crie um segmento que deixe de fora os contatos cujo Qualisend Status seja undeliverable. Inclua também risky se quiser segurar esses contatos; a seção O que fazer com cada resultado sugere uma ação para cada status e para os principais sinalizadores. Filtre por Status, e não por Score: o Score é gravado como texto, por isso as comparações “maior que” e “menor que” não são confiáveis.

Verifique novos contatos em tempo real

A Qualisend pode verificar cada novo contato assim que ele é adicionado ao ActiveCampaign e gravar o resultado nos mesmos cinco campos. Você ativa o recurso na Qualisend com um clique, e a Qualisend cria o webhook na sua conta do ActiveCampaign.

Para formulários hospedados por você, consulte a API de verificação (em inglês).

  1. 1

    Escolha uma lista e as origens

    Na página do ActiveCampaign na Qualisend, localize Real-time verify-on-signup e clique em Set up. É preciso ter a função de Proprietário ou Administrador.

    Em List, mantenha All lists ou escolha a lista em que o seu formulário de cadastro inclui as pessoas. Em Check contacts added, duas origens já vêm marcadas: By a contact (formulários de cadastro e landing pages) e By the API (o seu site, a sua loja e outros apps conectados).

    Cada contato adicionado por essas origens é verificado e consome um crédito. Marque By any user ou By system processes só se os contatos adicionados pela sua equipe ou pelas suas automações também precisarem ser verificados. Conectar um novo app ao ActiveCampaign pode adicionar pela API muitos contatos já existentes de uma só vez.

    Card de tempo real da Qualisend com a opção All lists selecionada, By a contact e By the API marcados e o botão Turn on real-time checks
  2. 2

    Ative as verificações

    Clique em Turn on real-time checks. A Qualisend adiciona à sua conta do ActiveCampaign um webhook chamado Qualisend real-time verification, que envia somente eventos Contact Added. Não há URL para copiar nem nada para configurar no ActiveCampaign.

    Em seguida, o card mostra Active e Real-time checks are on, com a sua lista e as suas origens. Clique em Change para alterá-las ou em Turn off para excluir o webhook.

    Card de tempo real da Qualisend mostrando Active e Real-time checks are on, com o webhook Qualisend real-time verification marcado como Working
  3. 3

    Teste com um cadastro

    Cadastre-se em um dos seus formulários com um endereço que você controla. Depois de um ou dois minutos, abra esse contato no ActiveCampaign e procure Qualisend Status. O card na Qualisend também mostra quando chegou a última verificação.

    Não teste com Send sample data no ActiveCampaign: essa opção envia um contato fictício, que pode consumir um crédito.

  4. 4

    Segure o e-mail de boas-vindas até sair o resultado

    Na automação que envia o seu e-mail de boas-vindas, coloque antes dele um Wait de alguns minutos e, em seguida, um If/Else em Qualisend Status. Envie, a não ser que o status seja undeliverable; assim, contatos ainda não verificados continuam recebendo o e-mail.

    Os campos da Qualisend só aparecem no ActiveCampaign depois que os primeiros resultados são gravados. Se ainda não for possível escolher Qualisend Status, aguarde o resultado do seu contato de teste ou faça uma limpeza com Tag contacts with results.

  • Só são verificados os contatos adicionados depois que você ativa o recurso. Para verificar os contatos que você já tem, faça uma limpeza.
  • Resultados instantâneos, como endereços não entregáveis ou descartáveis, costumam chegar ao ActiveCampaign em menos de um minuto. Os demais precisam primeiro de uma verificação ao vivo da caixa de e-mail. Uma verificação que não termina em 15 minutos é gravada como unknown.
  • Cada endereço é verificado no máximo uma vez a cada 7 dias, mesmo que o ActiveCampaign o envie de novo.
  • Os contatos importados só são enviados se você ativar Trigger webhooks nas configurações avançadas da importação, opção que vem desativada por padrão. Nesse caso, cada um consome um crédito; por isso, em uma importação grande, prefira fazer uma limpeza.
  • O ActiveCampaign envia o contato inteiro; a Qualisend usa apenas o endereço de e-mail.
  • As verificações em tempo real consomem créditos; o que acontece quando eles acabam é igual em todas as plataformas.
  • Prefere adicionar o webhook você mesmo ou chamá-lo pela ação Webhook de uma automação? Abra Set it up manually instead no card para ver as etapas e a URL do seu webhook. A URL contém uma chave secreta do seu espaço de trabalho, então não a compartilhe.

Limpeza automática agendada

Para limpar uma lista ou todos os contatos com regularidade, escolha em Repeat um intervalo de limpeza automática e só depois clique em Verify & clean; Limpezas automáticas agendadas explica como os agendamentos funcionam. Se a última limpeza dessa origem ainda estiver em andamento na data da próxima, a nova espera a anterior terminar.

Na página do ActiveCampaign, um agendamento também pode mostrar:

  • Last run: no contacts: a lista estava vazia.
  • Skipped - reconnect ActiveCampaign: o ActiveCampaign estava desconectado na data da limpeza.
Scheduled auto-cleans na Qualisend: a lista Newsletter limpa a cada 14 dias, com a próxima data e um botão Cancel

Créditos e limites

  • Os créditos são contados como em qualquer plataforma: veja Como os créditos são contados.
  • Cada limpeza, inclusive as automáticas, verifica todos os contatos da lista escolhida (ou de All contacts), até 1.000.000.
  • O seletor de listas mostra as suas primeiras 100 listas.

Desconectar

Na página do ActiveCampaign na Qualisend, clique em Disconnect. A desconexão é imediata, sem etapa de confirmação. Só um Proprietário ou Administrador pode desconectar.

Se for desconectar de vez, cancele antes as suas limpezas automáticas. Elas ficam ocultas enquanto o ActiveCampaign estiver desconectado.

Depois que você desconecta:

  • A Qualisend apaga a sua API key e a sua API URL.
  • Os campos da Qualisend e os valores deles continuam no ActiveCampaign.
  • A Qualisend exclui o webhook de tempo real que ela criou. Um webhook que você mesmo adicionou continua no ActiveCampaign, mas para de funcionar; para excluí-lo, vá a Settings → Developer e abra Manage Webhooks.
  • Os resultados anteriores continuam no seu espaço de trabalho da Qualisend.

Se você conectar de novo mais tarde, ative outra vez as verificações em tempo real.

Se você clicar em Reset API Key no ActiveCampaign, desconecte e conecte de novo com a nova API key e, depois, ative outra vez as verificações em tempo real. Ao conectar, também é removido um webhook antigo da Qualisend que não pôde ser excluído na desconexão.

Solução de problemas

“ActiveCampaign rejected that API URL or key. Check them and try again.”

O ActiveCampaign não aceitou essa combinação de URL e API key, ou a URL não aponta para a sua conta. Copie os dois valores de novo em Settings → Developer, na seção API Access.

“Couldn't load ActiveCampaign: could not load activecampaign lists”

A Qualisend não conseguiu ler as suas listas. A API key pode ter sido redefinida no ActiveCampaign, ou o ActiveCampaign pode estar fora do ar. Desconecte e conecte de novo com a API key atual.

“0 contacts - nothing to clean here”

A lista escolhida está vazia. Escolha outra lista ou All contacts. Se você clicar em Verify & clean mesmo assim, aparece “no addresses found in that source”.

Minha lista não aparece no seletor

O seletor mostra as suas primeiras 100 listas. Escolha All contacts ou fale conosco.

Nenhum dos meus contatos tem os campos da Qualisend

Confira se você escolheu Tag contacts with results e se não interrompeu a limpeza. A API key tem as permissões do usuário do ActiveCampaign a quem ela pertence; por isso, use a API key de um usuário que possa editar contatos e campos personalizados e faça a limpeza de novo. Se ainda assim não funcionar, fale conosco informando o nome e o horário da limpeza.

Alguns contatos não têm os campos da Qualisend

Os campos são gravados em lotes depois que todos os endereços são verificados: alguns minutos na maioria das listas, mais nas muito grandes. Se alguns continuarem vazios depois disso, faça a limpeza de novo. Ela consome créditos outra vez, então escolha a menor lista que inclua esses contatos. Limpezas interrompidas e Verify & export a clean list não gravam campos.

Não consigo escolher Qualisend Status em uma automação

Os campos são criados na primeira vez que resultados são gravados. Faça uma limpeza com Tag contacts with results e tente de novo.

Os novos contatos não estão sendo verificados

Clique em Manage no card de tempo real. Em Webhooks in ActiveCampaign that send to Qualisend, cada webhook aparece como Working, Needs a fix ou Can't check, e aquele que precisa de correção indica o que mudar. Depois, confira a origem do contato: importações só são enviadas com Trigger webhooks ativado, e os contatos que a sua equipe adiciona exigem By any user. Se o seu saldo zerou, as verificações são ignoradas, e não colocadas na fila. Se o card mostra Active, mas os novos contatos não recebem os campos, a API key pode ter sido redefinida. Desconecte e conecte de novo com a API key atual.

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.