Integração com Klaviyo

A integração nativa com o Klaviyo permite que você sincronize automaticamente seus membros e eventos de indicação para criar fluxos de email marketing poderosos.

Esta é uma integração Outbound (Saindo da plataforma). O Rafobase envia dados para o Klaviyo.

🚀 Funcionalidades

Sincronização de Perfis: Cria ou atualiza perfis no Klaviyo quando membros entram no programa.
Propriedades Customizadas: Envia dados do programa (código de cupom, saldo) como propriedades do perfil.
Eventos em Tempo Real: Dispara eventos (Metrics) para gatilhos de fluxos (Flows).

📊 Dados Sincronizados

Propriedades do Perfil

Todo membro sincronizado terá as seguintes propriedades customizadas no Klaviyo:

Propriedade	Descrição	Exemplo
`rafobase_referral_code`	O código de cupom único do membro	`NUT-JOAOS-A7B3C`
`rafobase_available_balance`	Saldo atual disponível para resgate	`150.00`
`rafobase_pending_balance`	Saldo pendente (em garantia)	`50.00`

Eventos (Metrics)

O Rafobase envia os seguintes eventos que você pode usar para iniciar fluxos:

`Joined Referral Program`

Mapeado do evento interno coupon.created. Disparado quando um novo membro é cadastrado.

Uso: Enviar email de boas-vindas com o código de cupom.

`Made Successful Referral`

Mapeado do evento interno referral.created. Disparado quando uma indicação é registrada (venda realizada).

Uso: Parabenizar o membro pela indicação.

`Commission Available`

Mapeado do evento interno wallet.balance_available. Disparado quando o período de garantia acaba e o saldo fica disponível.

Uso: Incentivar o resgate ou uso do crédito.

🛠️ Configuração

Obter Chave API Privada

Acesse sua conta Klaviyo
Vá para Settings → API Keys
Crie uma Private API Key com escopo Full Access (ou permissões de Profiles e Events)

Configurar no Rafobase

Acesse o Painel Administrativo (/app/settings)
Vá para a aba Integrations
Cole sua API Key no campo Klaviyo API Key
Ative a integração

Testar Integração

O sistema verificará automaticamente a conexão. Se bem-sucedido, verá um status "Connected".

Além do envio de dados para o Klaviyo, a integração também suporta importação bidirecional. Perfis existentes no Klaviyo podem ser importados como membros do programa de indicação diretamente pelo painel administrativo.

Acesse Settings → Klaviyo → Sync
O sistema listará perfis do Klaviyo que ainda não são membros
Selecione os perfis desejados e importe

A importação cria membros com cupons gerados automaticamente e sincroniza os dados de volta para o Klaviyo.

💡 Exemplos de Fluxos

Email de Boas-Vindas

Gatilho: Evento Joined Referral Program

"Olá {{ first_name }}! Bem-vindo ao nosso programa de indicação.

Seu código exclusivo é: **{{ person.rafobase_referral_code }}**

Compartilhe com amigos e ganhe 10% de comissão em cada venda!"

Notificação de Recompensa

Gatilho: Evento Commission Available

"Parabéns {{ first_name }}!

Você tem **R$ {{ event.amount }}** disponíveis para resgate na sua carteira.

Aproveite agora!"

Klaviyo