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.
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
- No Mailchimp, abra PerfilExtrasChaves de API (Profile › Extras › API keys) e crie uma chave.
- Copie a chave. Ela termina com o datacenter da conta, como
-us21. - 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.

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
- No painel do Vipter, abra GeralIntegraçõesCRM e e-mail marketingMailchimp.
- Em Conexão, preencha os campos numerados.

| # | Campo | O que colar |
|---|---|---|
| 1 | Chave de API | A chave de API do passo 1, com o final -us21 ou parecido. |
| 2 | ID do público | O ID do público do passo 1. |
| 3 | Status de contatos novos (opcional) | Como um contato novo entra no público: pending, subscribed ou transactional. Em branco, pending. Veja abaixo. |
| 4 | Tags padrão | As tags dos eventos que ficarem em branco em Tags por evento. Pode ficar vazio. |
- Em Tags por evento, informe as tags de cada evento, separadas por vírgula, como
pix-geradoem PIX gerado ecliente, comprouem Pedido pago. - Em Eventos enviados, desmarque o que você não quer enviar.
- 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
| Valor | O 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. |
subscribed | A pessoa entra inscrita na hora. Use só se o seu checkout já coleta o consentimento para e-mail marketing. |
transactional | O 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)
- Em Tags por oferta, escolha a Oferta.
- Informe as Tags, como
curso-x. - 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
- 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. - 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,
memberoutags. 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
-us21ou 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
- Entenda os valores por evento e as regras por oferta.
- Para os e-mails da compra, como confirmação e acesso, conecte um provedor de e-mail.
Conectar o HubSpot
Crie e atualize o contato no HubSpot a cada evento de venda, marque quem pagou como cliente e abra um negócio para cada pedido pago, no pipeline e na etapa que você escolher.
Conectar o Brevo
Crie e atualize o contato no Brevo a cada evento de venda e coloque o comprador nas listas que você escolher por evento e por oferta.