Configurar Klaviyo ou Mailchimp

Wavize sincroniza contactos para uma audiência específica

Klaviyo e Mailchimp têm páginas de configuração separadas. Cada integração requer uma chave API, um identificador de lista/audiência, modo de sincronização e estado ativo. Ao editar, deixar o campo da chave vazio mantém o segredo já guardado.

Perfil apenas cria ou atualiza o perfil sem pretender obter consentimento para marketing. O duplo opt-in inicia o processo de confirmação do fornecedor: o contacto só se torna subscritor após a ação esperada.

Segurança comum
Crie uma chave dedicada Wavize, copie-a apenas uma vez no formulário encriptado, não a envie por e-mail nem em captura, e revogue-a assim que for exposta.

Configurar Klaviyo com uma chave privada

Wavize usa os endpoints do servidor: a chave pública de seis caracteres, chamada Site ID, não é adequada.

1. Criar a chave

   No Klaviyo: Settings > API keys > Private API Keys > Create Private API Key. É necessário um papel Owner, Admin ou Manager. Dê-lhe o nome Wavize e copie o valor que começa por pk_ assim que for criada.

2. Escolher permissões

   A verificação lê contas e lista; a sincronização cria/atualiza perfis e, em duplo opt-in, subscrições. Conceda no mínimo leitura de accounts/lists e escrita de profiles/subscriptions relativos aos endpoints.

3. Encontrar o identificador da lista

   Abra Audience > Lists & Segments e selecione a lista-alvo. Copie o ID da lista a partir das suas definições ou URL, não o nome exibido. Wavize valida-o com /lists/{id}.

Configurar Mailchimp com chave e Audience ID

A chave Mailchimp Marketing API normalmente contém o data center após um hífen, por exemplo -us21.

1. Criar a chave

   No Mailchimp: ícone Perfil > Profile > Extras > API keys > Create A Key. Nomeie como Wavize, gere e copie imediatamente: o Mailchimp apenas mostra o nome e os primeiros caracteres depois.

2. Manter o sufixo do data center

   Wavize extrai o sufixo depois do último hífen para usar o host API correto. Uma chave truncada sem -usXX não pode ser roteada corretamente.

3. Encontrar Audience ID

   Em Audience > All contacts > Settings > Audience name and defaults, copie Audience ID. Não é o nome público nem um identificador de campanha.

Escolher entre perfil apenas ou duplo opt-in

O modo deve corresponder à base legal e ao texto apresentado no widget.

• Perfil apenas

  Klaviyo recebe um perfil; Mailchimp usa o status transactional. O contacto não é tratado como subscritor marketing e pode ser usado para fins permitidos não promocionais.

• Duplo opt-in

  Klaviyo inicia uma tarefa de subscrição de perfil; Mailchimp coloca o membro em pending. O endereço deve confirmar de acordo com o fornecedor antes de ficar ativo para marketing.

• Campos sincronizados

  E-mail válido obrigatório, telefone E.164 se existir, nome, apelido, organização, localização e propriedades Wavize úteis. Os campos Mailchimp FNAME/LNAME devem existir ou ser compatíveis na audiência.

Verificar e testar com um contacto real de teste

Wavize testa primeiro a conta e audiência antes de ativar a sincronização.

1. Verificação Klaviyo

   O servidor acede a /accounts depois /lists/{id}. Um 403 indica geralmente falta de permissão; um 404 indica um ID de lista de conta errada.

2. Verificação Mailchimp

   O servidor acede a /ping depois /lists/{id}. Um erro de data center vem normalmente do sufixo da chave; uma audiência não encontrada, de um ID incorrecto.

3. Contacto de teste

   Submeta um endereço da equipa via widget, verifique a criação na Wavize e a chegada ao fornecedor. Em duplo opt-in, abra e confirme a mensagem antes de concluir.

Rotação e incidente

Uma chave nova não substitui automaticamente a antiga na Wavize.

• Criar — Nova chave dedicada com as mesmas permissões mínimas.
• Atualizar e testar — Introduza o novo valor, mantenha audiência e modo, e verifique.
• Revogar — Apague a chave antiga no fornecedor apenas depois do teste ter sucesso.