#Integrar Kiwify

Crie a integração na Clickmax com o Token do webhook e uma API Key da Kiwify (client_id, client_secret e account_id) e cadastre a URL gerada na Kiwify. A partir daí, cada evento com e-mail cria ou atualiza um contato (com a tag kiwify), registra a atividade no histórico do contato, atualiza a venda na Clickmax e pode disparar uma automação.

A API Key é o que deixa você escolher os produtos da sua conta Kiwify nos gatilhos de automação.

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.
• Acesso à sua conta Kiwify, para abrir Apps → Webhook e Apps → API.

#Passo a passo

1. Na Clickmax, abra Integrações, clique em Explorar Integrações e escolha Kiwify em Vendas e Pagamentos.
2. Em outra aba, acesse a Kiwify. No menu lateral, vá em Apps → Webhook e clique em Criar webhook. Copie o Token exibido e cole no campo Token da Clickmax.
3. Na Kiwify, vá em Apps → API → Criar API Key, dê um nome e deixe marcada a permissão Produtos. Em Seus dados para conectar com a API, copie o client_id, o client_secret e o account_id e cole nos campos de mesmo nome na Clickmax.
4. Informe um Nome para a integração, deixe o Status ativo e clique em Criar integração. A Clickmax confere a API Key na Kiwify antes de criar.
5. A Clickmax gera uma URL de webhook. Copie essa URL.
6. Na Kiwify, no webhook que você está criando, cole a URL no campo URL, escolha os produtos e marque os eventos: compra aprovada, compra recusada, compra reembolsada, chargeback, boleto gerado, Pix gerado, carrinho abandonado, assinatura renovada, assinatura atrasada e assinatura cancelada.
7. Salve o webhook na Kiwify e, na Clickmax, clique em Concluir integração.

#O que cada evento gera

O valor gravado na venda é o total pago pelo comprador. Vendas da Kiwify registradas antes desta mudança mostram o valor da sua comissão. Boletos e Pix que vencem sem pagamento continuam como pendentes, porque a Kiwify não avisa o vencimento, e não entram na receita.

Todos os eventos podem ser usados como gatilho de automação: no seletor de gatilhos, abra Eventos externos → Kiwify e escolha o produto. A lista de produtos vem direto da sua conta Kiwify, e você também pode cadastrar um produto pelo ID.

#Relacionados

• Hub de integrações
• Criar sua primeira automação: reaja aos eventos da Kiwify
• Integrar Hotmart
• Referência de webhooks
• Vendas

#Se não funcionou

• Nada chega e a Kiwify mostra erro de autenticação: o Token colado não confere com a assinatura da requisição. Copie de novo o token do webhook (passo 2). Veja os códigos de erro.
• A integração não é criada e aparece um erro de credencial: o client_id ou o client_secret não correspondem a uma API Key da Kiwify, ou a chave foi apagada. Confira em Apps → API ou crie uma nova.
• Aparece que a credencial não consegue ler produtos: o account_id está errado ou a API Key está sem a permissão Produtos. Edite a API Key na Kiwify e marque Produtos.
• Minha integração Kiwify é antiga e o gatilho não lista meus produtos: integrações criadas antes de a API Key ser pedida não têm as credenciais. Cadastre o produto pelo ID no próprio gatilho, ou crie a integração de novo seguindo o passo a passo acima.
• O contato não aparece: a Clickmax só cria o contato quando o evento traz o e-mail do comprador.
• Você não encontra o menu Integrações: seu papel no workspace não tem acesso. Veja o que fazer sem permissão.