WEBHOOK • KIWIFY

Como conectar a Kiwify ao YouPro Track

Siga este passo a passo para configurar o webhook da Kiwify e permitir que o YouPro Track receba os eventos de compra aprovada, reembolso e chargeback.

Antes de começar

Para realizar essa configuração, acesse a Kiwify com a mesma conta onde estão os produtos que você deseja rastrear no YouPro Track.

!

Atenção ao client_secret

O client_secret é uma informação sensível e só pode ser visualizado uma vez. Copie e guarde em local seguro antes de fechar a janela.

01

Acesse os webhooks da Kiwify

Na Kiwify, clique em Apps no menu lateral e depois selecione Webhooks.

Tela inicial da Kiwify com menu Apps e opção Webhooks destacados.
02

Crie um novo webhook

Dentro da tela de webhooks, clique em Criar webhook.

Tela de webhooks da Kiwify com botão Criar webhook destacado.
03

Copie a URL gerada no YouPro Track

No YouPro Track, copie a URL exibida na janela de conexão da Kiwify. Essa é a URL que será colada dentro da Kiwify.

Janela do YouPro Track com URL do webhook para copiar.
04

Configure o webhook na Kiwify

Na Kiwify, dê um nome para a integração, como YouPro Track. Depois, cole a URL copiada no campo URL do Webhook, mantenha os produtos desejados selecionados e marque os eventos Compra aprovada, Reembolso e Chargeback. Em seguida, clique em Criar.Atenção: não clique no botão Testar Webhook nesta etapa. O teste ainda não irá funcionar, porque a configuração no YouPro Track só será finalizada depois que você criar e colar a API Key.

Modal da Kiwify para criar webhook com nome, URL e eventos Compra aprovada, Reembolso e Chargeback selecionados.
05

Avance no YouPro Track

Depois de criar o webhook na Kiwify, volte ao YouPro Track e clique em Já fiz, próximo.

Janela do YouPro Track com botão Já fiz, próximo destacado.
06

Acesse a área de API da Kiwify

Volte para a Kiwify, clique em Apps no menu lateral e depois selecione API.

Tela de Apps da Kiwify com opção API destacada.
07

Crie uma nova API Key

Na tela de API, clique em Criar API Key.

Tela de API da Kiwify com botão Criar API Key destacado.
08

Nomeie a API Key e selecione os endpoints

Dê um nome para a API Key, como YouPro Track. Depois, selecione todos os endpoints disponíveis e clique em Criar.

Modal da Kiwify para criar API Key com endpoints selecionados e botão Criar destacado.
09

Copie o client_secret gerado

Copie o client_secret gerado pela Kiwify.Atenção: por segurança, esse código não poderá ser visualizado novamente. Copie antes de fechar a janela e salve em um local seguro.

Modal da Kiwify com client_secret e botão Copiar client_secret destacado.
10

Cole o client_secret no YouPro Track

Volte ao YouPro Track, cole o client_secret no campo Token personalizado e clique em Salvar e continuar.

Janela do YouPro Track com campo Token personalizado e botão Salvar e continuar destacados.
11

Teste ou conclua a configuração

O YouPro Track vai exibir a etapa de verificação. Você pode clicar em Testar webhook agora ou clicar direto em Concluir.O teste é opcional, mas ajuda a confirmar se a conexão principal foi configurada corretamente.

Janela do YouPro Track com opção Testar webhook agora e botão Concluir.
12

Entenda o resultado do teste

Se você testar o webhook, os primeiros itens devem aparecer em verde. O último item pode aparecer com erro caso ainda não exista um link de tracking registrado em uma conversão real.Se os itens principais estiverem verdes, a integração principal está correta. O último item pode aparecer com erro quando ainda não houve rastreamento real por link do YouPro Track.Depois, clique em Concluir.

Resultado do teste do webhook no YouPro Track com verificações verdes e uma falha no link de tracking.
13

Integração concluída

Quando a Kiwify aparecer com o selo Conectada, a integração foi concluída com sucesso.

Linha da Kiwify no YouPro Track com selo Conectada.

Pronto, integração finalizada.

Agora a Kiwify já está conectada ao YouPro Track para enviar os eventos selecionados pelo webhook.