Voltar para documentação
Integrações

Integração Kiwify

Conecte sua conta Kiwify ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.

Conecte sua conta Kiwify ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.

Visão geral

Ao integrar a Kiwify, o Synchro Hub passa a:

  • Receber webhooks de vendas, reembolsos, chargebacks, assinaturas e carrinhos abandonados em tempo real.
  • Consultar a API da Kiwify para importar histórico e enriquecer dados.

Tempo estimado: 5 minutos. O que você vai precisar:

  • Conta Kiwify com perfil de Produtor (ou Co-produtor com permissão).
  • Workspace já criado no Synchro Hub.

Boa notícia: na Kiwify o webhook é registrado automaticamente pelo Synchro Hub via API. Você não precisa entrar no painel da Kiwify para configurar URL ou token.

Pré-requisitos

  • Estar logado no Synchro Hub com um workspace selecionado.
  • Ter acesso ao painel da Kiwify em dashboard.kiwify.com.br.

Passo 1 — Gerar as credenciais de API na Kiwify

  1. Entre no painel da Kiwify em dashboard.kiwify.com.br.
  2. No menu, vá em Apps → API.
  3. Clique em Criar API Key.
  4. Dê um nome (ex.: Synchro Hub) e marque todos os scopes disponíveis:
    • stats, products, events, sales, sales_refund, financial, affiliates, webhooks.
  5. Salve. A Kiwify exibirá:
    • Client ID
    • Client Secret
    • Account ID (identificador da sua conta, visível em Configurações → Conta)

Guarde os três valores — você vai colá-los no Passo 3.

Importante: o Client Secret só é exibido uma vez. Se perdê-lo, será necessário gerar uma nova API Key.

Passo 2 — Conectar a plataforma no Synchro Hub

  1. No menu lateral, acesse Integrações.
  2. Clique em + Adicionar Plataforma.

Tela de Integrações

  1. Selecione Kiwify e clique em Confirmar.

Modal de seleção de plataforma

Passo 3 — Salvar as credenciais (Client ID, Client Secret e Account ID)

  1. No card da Kiwify, clique em Atualizar credenciais.
  2. Preencha os campos com os valores do Passo 1:
    • Client ID
    • Client Secret
    • Account ID
  3. Clique em Salvar.

Modal de credenciais Kiwify

O Synchro Hub valida as credenciais em tempo real conectando-se à Kiwify. Se algo estiver errado, você verá uma mensagem de erro — nesse caso, confira os três valores e tente novamente.

Após salvar, o card passa a exibir Ativa / Conectado.

Card da integração Kiwify conectada

Passo 4 — Ativar o webhook (automático)

  1. No card da Kiwify, clique em Configurar Webhook.
  2. Na janela Webhook Kiwify, clique em Ativar Webhook.

Modal de ativação automática do webhook

O Synchro Hub usa a API da Kiwify para registrar automaticamente a URL e o token de assinatura — nenhuma configuração manual é necessária. Ao concluir, o card passa a exibir Webhook ativo.

Importante: se você remover ou alterar esse webhook manualmente no painel da Kiwify, os eventos podem parar de chegar. Use o botão Gerenciar Webhook no Synchro Hub para ajustes.

Verificação

Para confirmar que tudo está funcionando:

  1. Gere uma venda de teste na Kiwify (use um cupom de 100% em um produto seu ou uma compra real de valor baixo).
  2. Abra Vendas no menu lateral do Synchro Hub.
  3. A venda deve aparecer em até 1 minuto após a aprovação na Kiwify.

Solução de problemas

SintomaO que fazer
”Credenciais inválidas” ao salvarConfira se os três campos (Client ID, Client Secret e Account ID) estão corretos e se todos os scopes foram marcados ao criar a API Key.
Falha ao ativar webhookVerifique se o scope webhooks está habilitado na sua API Key da Kiwify.
Nenhuma venda chega após horasConfira em Apps → Webhooks no painel da Kiwify se o webhook do Synchro Hub continua ativo. Se foi removido, clique em Gerenciar Webhook no Synchro Hub para recriá-lo.
Vendas antigas não aparecemWebhooks só enviam eventos novos. Use a funcionalidade de Importação de Histórico (em breve) para backfill.

Perguntas frequentes

Tenho vários produtos na mesma conta Kiwify. Preciso integrar cada um? Não. A integração é feita pela conta (Account ID). Todos os produtos daquela conta enviam eventos para o mesmo webhook.

Posso reprocessar vendas antigas? A Kiwify permite reenvio manual de webhooks pela tela de Histórico de Webhooks. Alternativamente, aguarde a funcionalidade de importação de histórico no Synchro Hub (desde que seu plano contemple importação retroativa).

Como desconecto a integração? No card da Kiwify, clique em Remover. O Synchro Hub também desativa o webhook na Kiwify automaticamente. Os dados serão apagados da Synchro Hub.