VipterCentral de Ajuda

Conectar o Mailchimp

Coloque o comprador no seu público do Mailchimp a cada evento de venda, com tags por evento e por oferta e confirmação por e-mail para quem ainda não é contato.

Admin ou DonoTodos os planosVerificado em 4 de out. de 2026

Com o Mailchimp conectado, cada evento de venda do Vipter cria ou atualiza o comprador no seu público do Mailchimp e aplica as tags que você definir, como pix-gerado, cliente ou curso-x. As jornadas e os segmentos do Mailchimp começam a partir dessas tags.

Antes de começar, vale ler como funcionam as automações.

Antes de começar

  • Uma conta no Mailchimp com um público (audiência) criado.
  • Papel Admin ou Dono no projeto do Vipter.

Passo 1: criar a chave de API e achar o ID do público

  1. No Mailchimp, abra PerfilExtrasChaves de API (Profile › Extras › API keys) e crie uma chave.
  2. Copie a chave. Ela termina com o datacenter da conta, como -us21.
  3. Abra PúblicoConfiguraçõesNome e padrões do público (Audience › Settings › Audience name and defaults) e copie o ID do público, como a1b2c3d4e5.
Página Chaves de API do Mailchimp com o botão para criar uma chave
Ilustração provisória: a tela real pode ter pequenas diferenças. O print definitivo entra em breve.

O ID do público não é o nome do público. Se o teste do passo 2 falhar no público, é quase sempre isso.

Guarde a chave com cuidado

Com a chave dá para ler e alterar os contatos da conta e enviar campanhas. Cole a chave só no Vipter. Depois de salva, o campo mostra só o final dela.

Passo 2: conectar no Vipter

  1. No painel do Vipter, abra GeralIntegraçõesCRM e e-mail marketingMailchimp.
  2. Em Conexão, preencha os campos numerados.
Cartão Conexão do Mailchimp no Vipter com a chave, o ID do público, o status de contatos novos, as tags por evento e as tags padrão
#CampoO que colar
1Chave de APIObrigatório · fica oculto depois de salvoA chave de API do passo 1, com o final -us21 ou parecido.
2ID do públicoObrigatórioO ID do público do passo 1.
3Status de contatos novos (opcional)OpcionalComo um contato novo entra no público: pending, subscribed ou transactional. Em branco, pending. Veja abaixo.
4Tags padrãoOpcionalAs tags dos eventos que ficarem em branco em Tags por evento. Pode ficar vazio.
  1. Em Tags por evento, informe as tags de cada evento, separadas por vírgula, como pix-gerado em PIX gerado e cliente, comprou em Pedido pago.
  2. Em Eventos enviados, desmarque o que você não quer enviar.
  3. Deixe ligado Ativo — enviar eventos para esta plataforma, clique em Salvar e depois em Testar conexão. O teste confere a chave e o ID do público.

Status de contatos novos

ValorO que acontece com quem ainda não está no público
pending (padrão)O Mailchimp manda um e-mail de confirmação, e a pessoa só entra no público depois de confirmar. A confirmação registra o consentimento que a LGPD pede para e-mail marketing.
subscribedA pessoa entra inscrita na hora. Use só se o seu checkout já coleta o consentimento para e-mail marketing.
transactionalO contato é guardado sem receber marketing.

O status só vale para contatos novos. Quem já está no público mantém o status que tem, e quem cancelou a inscrição continua fora.

Passo 3: usar tags por oferta (opcional)

  1. Em Tags por oferta, escolha a Oferta.
  2. Informe as Tags, como curso-x.
  3. Clique em Adicionar regra.

Opcional: as tags da oferta entram junto com as do evento quando a compra é confirmada (pedido pago, assinatura criada ou renovada). Carrinho abandonado, PIX gerado e estornos recebem só as tags do evento. A regra também vale para as outras ofertas do mesmo produto.

O que acontece a cada evento

  1. Contato: criado ou atualizado no público pelo e-mail, com nome (FNAME), sobrenome (LNAME) e telefone (PHONE). Se o campo de telefone do público recusar o número, por exemplo por estar no formato dos Estados Unidos, o contato vai sem o telefone.
  2. Tags: as do evento e, numa compra confirmada, as da regra da oferta. Uma tag que não existe é criada pelo Mailchimp.

As tags nunca são removidas. Use as tags de estorno, chargeback e cancelamento nos seus segmentos e jornadas.

Envios, novas tentativas e reenvio

  • enviado: contato e tags aplicados.
  • ignorado: a venda não tem e-mail (customer has no e-mail).
  • falhou: o motivo começa pela etapa, member ou tags. Uma recusa do Mailchimp, como chave ou público errados, não é repetida. Falhas passageiras ganham novas tentativas automáticas.

Depois de corrigir a causa, use Reenviar. Veja novas tentativas e reenvio.

Problemas comuns

  • O envio falhou com "invalid Mailchimp API key: it must end with the data center"

    A chave foi colada pela metade. Copie a chave inteira, com o final -us21 ou parecido.

  • A plataforma recusou as credenciais com código 404

    O ID do público está errado. Copie de novo em Nome e padrões do público.

  • O envio aparece como enviado, mas o contato não aparece no público

    Com pending, a pessoa só entra depois de confirmar o e-mail do Mailchimp. Até lá, ela fica como pendente.

O que fazer a seguir

Esta página ajudou?

Nesta página

Idioma