#Integrar Voomp

Crie a integração na Clickmax, copie a URL da integração gerada e cadastre um webhook na Voomp apontando para ela. A partir daí cada venda, assinatura, reembolso ou checkout abandonado da Voomp vira um contato e uma atividade na Clickmax.

Papel exigido: apenas Proprietário e Administrador gerenciam integrações — veja Papéis e permissões. Plano necessário:

Antes de começar: tenha acesso à conta da Voomp e saiba quais produtos quer integrar. Na Voomp o webhook é configurado uma vez e você escolhe os produtos dentro dele.

#Passo a passo

1. Na Voomp, abra o menu lateral direito → seu perfil → Configurações do sistema → aba Integrações e tokens, e copie o Webhook Token.
2. Na Clickmax, em Integrações, escolha Voomp, dê um apelido, cole o Webhook Token no campo Token e clique em Criar integração.
3. Copie a URL da integração gerada pela Clickmax.
4. Na Voomp, abra o menu lateral esquerdo → Integrações → Webhooks.
5. Em Selecione os produtos que deseja integrar, escolha os produtos (ou use selecionar todos).
6. Cole a URL da Clickmax no campo Enviar para a URL.
7. Em Quais variáveis deseja receber?, clique em selecionar todos.
8. Ligue os eventos que deseja receber e clique em Salvar integração.
9. Volte à Clickmax e clique em Concluir integração.

O passo 7 não é opcional. Sem selecionar todos as variáveis, o webhook chega sem os dados do comprador e a Clickmax não consegue criar o contato.

#Eventos recebidos

Cada evento da Voomp cria ou atualiza um contato com a tag voomp e registra uma atividade.

Todos esses eventos também ficam disponíveis como gatilho de automação, com filtro opcional por produto. Para o formato dos dados, veja a referência de webhooks e o catálogo de eventos.

#Aviso de vencimento de boleto: quantas vezes dispara

Na Voomp, Aviso de vencimento de boleto para assinatura permite ligar vários lembretes (7, 5, 3, 2 e 1 dia antes, no dia da renovação, e 1, 2, 3, 5, 7 e 30 dias depois). Todos eles chegam à Clickmax como o mesmo evento, e o aviso não informa qual dos lembretes é.

Na prática: uma automação nesse gatilho roda uma vez para cada lembrete ligado na Voomp. Se quiser um único disparo por ciclo, deixe apenas um lembrete ativo no painel da Voomp.

#Vendas e valores

A venda registrada usa sempre o valor total do pedido informado pela Voomp. Cada webhook da Voomp traz um único produto, então cada venda aparece com o seu produto.

Renovações de assinatura também chegam como Venda paga, então a receita recorrente entra normalmente no relatório de vendas.

#Produtos no gatilho da automação

A Voomp não disponibiliza uma lista de produtos para a Clickmax consultar. Por isso o seletor de produto do gatilho mostra os produtos que já chegaram por webhook — a lista cresce conforme as vendas acontecem. Enquanto o produto não apareceu, você pode adicioná-lo manualmente informando o id do produto na Voomp, ou deixar o gatilho sem produto para disparar em qualquer um.

#Relacionados

• Todas as integrações
• Contatos
• Automações
• Referência de webhooks

#Se não funcionou

• O contato não aparece: eventos sem o e-mail do comprador são ignorados. A causa mais comum é o passo 7 — volte ao webhook na Voomp e confirme que todas as variáveis estão selecionadas.
• A Voomp acusa erro ao enviar: confira se a URL cadastrada está correta e se o Token colado na Clickmax é o mesmo Webhook Token que aparece em Configurações do sistema → Integrações e tokens. Token diferente faz a Clickmax recusar o envio.
• Só alguns produtos recebem eventos: volte ao webhook na Voomp e confirme que o produto está marcado na lista de produtos integrados.
• A automação não dispara: confirme se o produto escolhido no gatilho é o mesmo do pedido. O gatilho sem produto dispara para qualquer produto da Voomp.
• A automação disparou várias vezes: se o gatilho é o aviso de vencimento de boleto, veja a seção sobre quantas vezes ele dispara.