Nó Kiwify

O nó de workflow Kiwify chama a Kiwify API para buscar pedidos, produtos e dados de afiliados. Use-o em workflows de infoproduto para consultar detalhes de compra, enviar mensagens de entrega no WhatsApp ou gerenciar notificações de afiliados.

ID do nó no editor: kiwify_request
Base URL: https://api.kiwify.com.br/v1/
Auth: Authorization: Bearer {{kiwify_api_key}}

O que faz

• Envia requisições HTTP autenticadas para endpoints REST da Kiwify
• Suporta GET, POST, PUT e DELETE
• Retorna status HTTP, data de resposta e headers de resposta
• Inclui templates de operação para pedidos, produtos e afiliados

Pré-requisitos

1. Uma conta Kiwify (produtor ou gestor de afiliados)
2. API key no painel Kiwify → configurações Apps / API
3. Chave de integração kiwify_api_key em Configurações → Chaves de API

Como configurar

Passo 1 — Definir credenciais

1. Na Kiwify, gere uma API key nas configurações da conta
2. No WhatsWave Configurações → Chaves de API, adicione:
   • Nome: kiwify_api_key
   • Valor: sua Kiwify API key

Header padrão: Authorization: Bearer {{kiwify_api_key}}

Passo 2 — Adicionar o nó

Arraste Kiwify da paleta Marketing para o canvas do workflow.

Passo 3 — Escolher um template de operação

Passo 4 — Configurar campos da requisição

Exemplo — buscar pedido após webhook (GET):

• URL: https://api.kiwify.com.br/v1/orders/{{trigger.body.order_id}}
• Method: GET

Exemplo — listar pedidos recentes (GET):

• URL: https://api.kiwify.com.br/v1/orders?status=paid
• Method: GET

Exemplo — listar produtos (GET):

• URL: https://api.kiwify.com.br/v1/products
• Method: GET

Parâmetros de query para filtragem (status, data, produto) dependem da versão da API Kiwify — consulte a documentação Kiwify para parâmetros atuais.

Passo 5 — Usar dados da resposta

Inspecione a saída de execução para os caminhos exatos de campo:

Order ID: {{kiwify_1.data.id}}
Customer email: {{kiwify_1.data.customer.email}}
Product: {{kiwify_1.data.product.name}}

Use um nó JavaScript para transformar respostas aninhadas quando necessário.

Saídas do nó

Eventos em tempo real vs polling de API

O nó Kiwify consulta a API — não recebe notificações push por si só. Para notificações de compra em tempo real:

1. Configure webhooks Kiwify nas configurações de produto/conta Kiwify
2. Aponte a URL do webhook para um workflow com Gatilho Webhook do WhatsWave
3. Use este nó Kiwify nesse workflow para buscar detalhes completos do pedido por order ID

Consulte Webhooks recebidos.

Dicas e boas práticas

• Padrão webhook + GET — o webhook dispara na compra; o nó Kiwify busca dados completos de pedido/cliente
• Armazene IDs de pedido Kiwify em contatos WhatsWave como campos customizados
• Use Listar produtos para referenciar dinamicamente nomes de produto em mensagens
• Listar afiliados suporta fluxos de gestão de afiliados e notificação de comissão
• Filtre pedidos por status (paid, refunded, etc.) para direcionar o follow-up correto
• Nunca exponha API keys em mensagens WhatsApp ou rótulos de nós
• Teste payloads de webhook no histórico de execução antes de mapear variáveis
• Workflows Kiwify e Hotmart costumam ser paralelos — use o nó correspondente ao seu marketplace

Exemplos de casos de uso

Webhook de compra → entrega WhatsApp

1. Gatilho Webhook — evento de pedido aprovado Kiwify
2. Kiwify GET — buscar pedido por ID
3. Enviar mensagem — "Olá {{customer_name}}! Sua compra foi confirmada. Acesso: {{product_access_url}}"

Notificação de reembolso para equipe de suporte

1. Gatilho Webhook — evento de reembolso Kiwify
2. Kiwify GET — buscar detalhes do pedido
3. Enviar mensagem — notificar grupo WhatsApp de suporte com informações do pedido

Boas-vindas a novo afiliado

1. Gatilho Webhook — novo afiliado aprovado
2. Kiwify GET — buscar detalhes do afiliado
3. Enviar mensagem — boas-vindas com link de afiliado e instruções

Resumo diário de vendas

1. Gatilho agendado — todo fim de tarde
2. Kiwify GET — listar pedidos pagos do dia
3. JavaScript — agregar totais
4. Enviar mensagem — relatório diário ao proprietário

FAQ

Por que 401 Unauthorized?
kiwify_api_key inválida ou ausente. Verifique a chave em Configurações → Chaves de API.

Este nó pode criar pedidos?
Os templates focam em operações de leitura. Para ações de escrita, configure URLs POST customizadas conforme a documentação da API Kiwify.

Qual a diferença entre webhook e este nó?
Webhooks empurram eventos ao WhatsWave instantaneamente. Este nó puxa dados da Kiwify — use ambos juntos para automações mais ricas.

Como obtenho order_id de um webhook?
Inspecione o payload do webhook no histórico de execução. O nome do campo varia por tipo de evento — comum: trigger.body.order_id ou trigger.body.data.order.id.

Kiwify ou Hotmart — qual nó usar?
Use o nó do marketplace onde você vende. Muitos produtores usam ambos — crie workflows separados por plataforma.

Por que os dados da resposta estão vazios?
Verifique o status HTTP na saída. 404 significa order ID incorreto; 403 pode indicar que a API key não tem permissão para aquele recurso.

Referência da API

Relacionados

• Visão geral de Marketing
• Nó Hotmart
• Webhooks recebidos
• Variáveis no workflow