#Integrar Whop

Crie uma integração de entrada na Clickmax, cole o Token da API da sua conta Whop, registre a URL gerada no webhook da Whop — e cada evento com e-mail passa a criar ou atualizar um contato (com a tag whop), enquanto os pagamentos aprovados viram vendas na Clickmax.

Antes de começar

• Papel de workspace: Proprietário, Administrador, Editor ou Colaborador. Os papéis Financeiro, Convidado e Atendente não têm acesso a Integrações.
• Plano:
• Da sua conta Whop você precisa de uma API key criada com a função Admin. A Clickmax consulta a sua conta e o catálogo de produtos da Whop; com uma função de menos permissão, essas consultas falham e o seletor de produtos fica vazio.
• A chave também precisa ler o e-mail do membro — sem ele a Clickmax não identifica o comprador e descarta o evento.
• O Token do webhook (o signing secret) é gerado pela própria Whop quando você cria o webhook, então ele só existe depois do passo 6.

#Passo a passo

1. Na Clickmax, abra Integrações e selecione o card Whop.
2. Em outra aba, acesse o painel da Whop e faça login na sua conta de vendedor.
3. Na Whop, acesse a aba Developer > Account API Keys > Create. Em Herdar permissões da função, selecione Admin e copie a chave (whop_…).
4. Na Clickmax, cole a chave no campo Token da API, informe um Apelido para a integração e, no campo Token, cole qualquer valor temporário — ele será substituído pelo signing secret no passo 8. Clique em Criar integração.
5. A Clickmax gera uma URL de webhook. Copie essa URL.
6. Na Whop, acesse Developer > Webhooks > Create webhook e cole a URL copiada.
7. Selecione os eventos que quer receber. Marque todos para ter o histórico completo — a tabela em O que passa a chegar mostra o que cada um faz na Clickmax.
8. Copie o signing secret exibido na coluna Secret da tabela de webhooks, volte à Clickmax e substitua o valor do campo Token pelo secret copiado.
9. Clique em Concluir integração.

#O que passa a chegar

Cada evento com e-mail cria ou atualiza um contato com a tag whop, registra uma atividade no histórico do contato e pode disparar automações. Parte deles também registra uma venda.

Pontos que costumam gerar dúvida:

• Pagamento aprovado e fatura paga marcam o contato como cliente. Ativação de assinatura também.
• Pagamento em processamento (payment.pending) é o intervalo em que a Whop ainda está liquidando a cobrança, como em transferência bancária. A venda entra com status Aguardando e passa a Aprovada ou Falha quando a Whop confirma — é sempre a mesma venda, não duas.
• Venda com status Aguardando não conta como faturamento. Os indicadores de receita, o ticket médio e o LTV do contato somam apenas vendas aprovadas.
• Reembolso só muda a venda quando é concluído. Um reembolso aberto ou que falhou dispara a automação e entra no histórico, mas não altera o status da venda.
• Assinaturas e faturas não registram venda. A cobrança de cada ciclo chega como um pagamento próprio, e a fatura é liquidada por um pagamento — registrar as duas contaria o mesmo dinheiro duas vezes.
• Renovação de assinatura chega como um novo pagamento aprovado, então cada ciclo cobrado é uma venda própria.
• Cancelamento agendado e cancelamento desfeito são gatilhos separados. A Whop usa um único evento (membership.cancel_at_period_end_changed) para as duas direções, e a Clickmax separa — assim uma automação de retenção não dispara para quem acabou de desistir de cancelar.
• Eventos sem o e-mail do comprador são ignorados, porque sem e-mail não é possível identificar o contato.

#Moeda

A venda guarda a moeda em que a Whop cobrou, e as telas de venda exibem o valor nela. Quando você vende em mais de uma moeda, os indicadores mostram uma moeda por vez — somar moedas diferentes num único total não diria nada — e um seletor permite alternar entre elas.

Cobranças em cripto (BTC, ETH, APE) e em ouro (XAU) são registradas, mas valores muito pequenos podem aparecer como zero: a Clickmax guarda valores com duas casas decimais.

#Filtro por produto

Nos gatilhos você pode filtrar pelo produto: a Clickmax lista os produtos direto da sua conta Whop usando o Token da API.

Se você tiver mais de uma integração da Whop no mesmo workspace, cada uma usa o seu próprio Token da API e, portanto, mostra o catálogo da conta dela. Nesse caso aparece um campo Conta acima do produto, para você escolher de qual integração quer listar. Com uma integração só, o campo não aparece.

#Relacionados

• Todas as integrações
• Criar sua primeira automação — reaja aos pagamentos da Whop
• Integrar Guru e Integrar Yever

#Se não funcionou

• Não consigo criar a integração: confira se a chave colada no campo Token da API é uma API key válida da Whop, criada em Developer > Account API Keys. Veja os códigos de erro.
• Nenhum evento chega: confira se o campo Token contém o signing secret exibido pela Whop na criação do webhook — secret divergente faz a Clickmax rejeitar a entrega. Veja os códigos de erro.
• Um evento específico não chega: eventos sem o e-mail do comprador são descartados (a Clickmax não consegue resolver o contato). Confira se a API key tem a permissão de leitura de e-mail do membro. Veja os códigos de erro.
• Nada chega, mesmo com o secret correto: confira a versão de API escolhida ao criar o webhook na Whop. A integração espera o formato de payload em que o produto e o comprador vêm aninhados no evento; se você selecionou uma versão mais nova, recrie o webhook mantendo a versão padrão.
• A venda ficou com status Aguardando e não mudou: a Whop só envia a confirmação quando a liquidação termina. Confira na Whop se o pagamento saiu de "pending"; se saiu e a Clickmax não atualizou, verifique se os eventos payment.succeeded e payment.failed estão marcados no webhook.