# Bloopi — Artigos da Central de Ajuda

## Índice de Artigos

1. [Como criar minha primeira conta na Bloopi](#como-criar-minha-primeira-conta-na-bloopi)
2. [Como criar um produto na Bloopi](#como-criar-um-produto-na-bloopi)
3. [Como configurar o checkout](#como-configurar-o-checkout)
4. [Como adicionar um domínio próprio ao checkout](#como-adicionar-um-dominio-proprio-ao-checkout)
5. [Como configurar parcelamento no cartão de crédito](#como-configurar-parcelamento-no-cartao-de-credito)
6. [Como ativar PIX no checkout](#como-ativar-pix-no-checkout)
7. [Como criar cupons de desconto](#como-criar-cupons-de-desconto)
8. [Como criar uma assinatura recorrente](#como-criar-uma-assinatura-recorrente)
9. [Como funciona o motor de cobrança recorrente](#como-funciona-o-motor-de-cobranca-recorrente)
10. [Como gerenciar assinantes](#como-gerenciar-assinantes)
11. [Como criar um order bump](#como-criar-um-order-bump)
12. [Como criar um upsell pós-compra](#como-criar-um-upsell-pos-compra)
13. [Como criar um funil de vendas completo](#como-criar-um-funil-de-vendas-completo)
14. [Como configurar o pixel do Meta (Facebook/Instagram)](#como-configurar-o-pixel-do-meta)
15. [Como configurar o Google Ads no checkout](#como-configurar-o-google-ads-no-checkout)
16. [Como configurar o TikTok Pixel](#como-configurar-o-tiktok-pixel)
17. [Como ativar o programa de afiliados](#como-ativar-o-programa-de-afiliados)
18. [Como um afiliado pode se cadastrar](#como-um-afiliado-pode-se-cadastrar)
19. [Como fazer o primeiro saque](#como-fazer-o-primeiro-saque)
20. [Como interpretar o relatório de vendas](#como-interpretar-o-relatorio-de-vendas)
21. [Como integrar com Shopify](#como-integrar-com-shopify)
22. [Como configurar webhooks](#como-configurar-webhooks)
23. [Como usar a API da Bloopi](#como-usar-a-api-da-bloopi)
24. [Como configurar o tema TikTok Shop](#como-configurar-o-tema-tiktok-shop)
25. [Como adicionar depoimentos ao checkout](#como-adicionar-depoimentos-ao-checkout)
26. [Como funciona o timer de escassez](#como-funciona-o-timer-de-escassez)
27. [Como configurar a página de obrigado](#como-configurar-a-pagina-de-obrigado)
28. [Como ver o rastreamento UTM das vendas](#como-ver-o-rastreamento-utm-das-vendas)
29. [Como ativar 2FA na conta](#como-ativar-2fa-na-conta)
30. [Como funciona o prazo de disponibilização do saldo](#como-funciona-o-prazo-de-disponibilizacao-do-saldo)

---

## Como criar minha primeira conta na Bloopi

1. Acesse https://bloopi.com.br/cadastro
2. Preencha nome completo, email e senha
3. Confirme o email recebido na caixa de entrada
4. Complete o onboarding com CPF ou CNPJ
5. Adicione sua chave PIX para receber saques
6. Aguarde a aprovação da conta (normalmente em até 24h úteis)

Após aprovação, você já pode criar produtos e ativar seu checkout.

---

## Como criar um produto na Bloopi

1. No dashboard, acesse o menu **Produtos**
2. Clique em **Novo produto**
3. Preencha nome, descrição e tipo (único ou recorrente)
4. Adicione imagem de capa
5. Configure o preço e parcelamento
6. Clique em **Salvar**

O produto criado já gera automaticamente um link de checkout padrão que pode ser compartilhado.

---

## Como configurar o checkout

1. Acesse **Produtos** > selecione o produto > aba **Checkout**
2. Escolha o tema visual (padrão, sales page, TikTok Shop)
3. Configure as cores principais e logo
4. Selecione os métodos de pagamento disponíveis para esse produto
5. Ative ou desative elementos de conversão (timer, prova social, depoimentos)
6. Salve e visualize o checkout antes de publicar

Cada produto tem configurações de checkout independentes.

---

## Como adicionar um domínio próprio ao checkout

1. Acesse **Configurações** > **Domínios**
2. Clique em **Adicionar domínio**
3. Insira o subdomínio desejado (ex: checkout.seunegocio.com.br)
4. Copie o CNAME fornecido pela Bloopi
5. No painel do seu provedor de domínio (Registro.br, GoDaddy, Cloudflare, etc.), adicione um registro CNAME apontando para o valor fornecido
6. Aguarde a propagação de DNS (pode levar até 24h)
7. A Bloopi ativa o certificado SSL automaticamente

---

## Como configurar parcelamento no cartão de crédito

1. Acesse **Produtos** > selecione o produto > **Configurações de preço**
2. Em **Parcelamento**, defina o número máximo de parcelas (até 12x)
3. Configure se o juros são absorvidos por você ou repassados ao comprador
4. Taxa de juros por parcelamento é configurável
5. Salve as configurações

O checkout exibirá automaticamente as opções de parcelamento para o comprador.

---

## Como ativar PIX no checkout

1. Acesse **Produtos** > selecione o produto > **Checkout** > **Métodos de pagamento**
2. Ative a opção **PIX**
3. Configure o tempo de expiração do QR Code (padrão: 30 minutos)
4. Salve

Após o pagamento PIX ser confirmado, o comprador recebe acesso ao produto automaticamente.

---

## Como criar cupons de desconto

1. Acesse **Produtos** > selecione o produto > **Cupons**
2. Clique em **Novo cupom**
3. Defina o código (ex: PROMO20)
4. Escolha o tipo: percentual (ex: 20%) ou valor fixo (ex: R$ 30)
5. Configure limite de usos (opcional)
6. Configure data de validade (opcional)
7. Salve

O comprador insere o código no checkout e o desconto é aplicado automaticamente.

---

## Como criar uma assinatura recorrente

1. Acesse **Produtos** > **Novo produto**
2. Em **Tipo**, selecione **Recorrente**
3. Configure o intervalo de cobrança: semanal, mensal, trimestral, semestral ou anual
4. Defina o valor da assinatura
5. Configure período de trial (opcional): gratuito por X dias ou pago
6. Configure número máximo de cobranças se quiser prazo definido
7. Salve e configure o checkout

O motor de cobrança recorrente da Bloopi cuida automaticamente de todas as renovações.

---

## Como funciona o motor de cobrança recorrente

O motor de assinaturas da Bloopi executa cobranças automáticas nas datas de renovação de cada assinante.

**Fluxo de cobrança:**
1. Na data de vencimento, o sistema tenta cobrar o cartão salvo do assinante
2. Se aprovado: ciclo renovado, assinante mantém acesso, produtor recebe
3. Se recusado: status muda para "vencida" e o sistema agenda retentativas

**Retentativas automáticas:**
- 1ª tentativa: data de vencimento
- 2ª tentativa: 3 dias após falha
- 3ª tentativa: 5 dias após falha
- 4ª tentativa: 7 dias após falha
- Após todas as tentativas falharem: assinatura cancelada automaticamente

**Notificações:**
- Assinante é notificado por email em cada falha de cobrança com link para atualizar cartão
- Produtor é notificado sobre assinaturas vencidas

---

## Como gerenciar assinantes

1. Acesse **Assinaturas** no menu lateral
2. Veja a lista completa de assinantes com status em tempo real
3. Filtre por produto, status, período
4. Clique em um assinante para ver detalhes e histórico de cobranças

**Ações disponíveis por assinante:**
- Pausar assinatura (cobrança não executada enquanto pausada)
- Cancelar assinatura (com ou sem acesso até fim do período pago)
- Ver histórico completo de cobranças e falhas

**Métricas no topo da tela:**
- MRR (Receita Recorrente Mensal)
- Total de assinantes ativos
- Churn do período
- Novas assinaturas

---

## Como criar um order bump

1. Acesse **Produtos** > selecione o produto > **Order Bumps**
2. Clique em **Novo Order Bump**
3. Selecione o produto que será ofertado como order bump
4. Configure título, descrição e imagem do offer
5. Configure o preço do order bump (pode ser diferente do preço padrão do produto)
6. Ative e salve

O order bump aparece dentro do checkout antes do botão de pagamento. O comprador marca uma caixa para adicionar à compra com um clique.

---

## Como criar um upsell pós-compra

1. Acesse **Produtos** > selecione o produto > **Upsells**
2. Clique em **Novo Upsell**
3. Selecione o produto que será ofertado
4. Configure a página do upsell: headline, descrição, vídeo (opcional)
5. Configure o preço especial do upsell
6. Configure o que acontece se o comprador aceitar (redirecionamento) ou recusar (downsell ou página de obrigado)
7. Ative e salve

O upsell aparece imediatamente após o pagamento ser aprovado, sem precisar inserir dados do cartão novamente.

---

## Como criar um funil de vendas completo

Um funil completo na Bloopi tem as seguintes etapas:

1. **Checkout principal** — produto principal com order bumps configurados
2. **Upsell 1** — oferta de produto complementar de maior valor
3. **Downsell** (opcional) — versão mais acessível caso o comprador recuse o upsell
4. **Upsell 2** (opcional) — segunda oferta pós-compra
5. **Página de obrigado** — entrega do produto e próximos passos

Para construir o funil:
1. Acesse **Funis** > **Novo Funil**
2. Use o visual builder para conectar as etapas
3. Configure as transições (aceitar upsell → próximo passo, recusar → downsell)
4. Ative o funil
5. Acompanhe métricas de conversão por etapa no dashboard do funil

---

## Como configurar o pixel do Meta (Facebook/Instagram)

1. Acesse **Produtos** > selecione o produto > **Rastreamento** > **Meta Pixel**
2. Insira o ID do Pixel do Meta (formato numérico, ex: 1234567890123)
3. Opcionalmente, insira o token de acesso da Conversions API para rastreamento server-side
4. Configure quais eventos disparar: ViewContent, InitiateCheckout, Purchase
5. Salve

**Eventos disparados automaticamente:**
- `PageView`: ao abrir o checkout
- `ViewContent`: ao visualizar o produto
- `InitiateCheckout`: ao começar a preencher o formulário
- `AddPaymentInfo`: ao selecionar método de pagamento
- `Purchase`: após pagamento aprovado (com value e currency)

Cada produto usa o pixel do próprio produtor — os dados de conversão vão para a conta de anúncios correta.

---

## Como configurar o Google Ads no checkout

1. Acesse **Produtos** > selecione o produto > **Rastreamento** > **Google Ads**
2. Insira o ID de conversão (formato: AW-XXXXXXXXXX)
3. Insira o rótulo da conversão
4. Configure o valor da conversão (dinâmico = valor da venda, ou fixo)
5. Salve

O evento de conversão é disparado no momento da confirmação do pagamento com `transaction_id` único para deduplicação.

---

## Como configurar o TikTok Pixel

1. Acesse **Produtos** > selecione o produto > **Rastreamento** > **TikTok Pixel**
2. Insira o Pixel ID do TikTok (alfanumérico)
3. Opcionalmente, insira o token de acesso da TikTok Events API
4. Salve

**Eventos disparados:**
- `ViewContent`: ao abrir o checkout
- `InitiateCheckout`: ao começar o preenchimento
- `CompletePayment`: após pagamento confirmado (com value e currency)

---

## Como ativar o programa de afiliados

1. Acesse **Produtos** > selecione o produto > **Afiliados**
2. Ative o programa de afiliados para esse produto
3. Configure a comissão: percentual (ex: 30%) ou valor fixo (ex: R$ 50)
4. Configure o período de cookie (quantos dias após o clique o afiliado recebe crédito)
5. Configure aprovação automática ou manual de novos afiliados
6. Salve

Você receberá solicitações de afiliados que podem ser aprovadas no menu **Afiliados** > **Solicitações**.

---

## Como um afiliado pode se cadastrar

1. O afiliado acessa a página de afiliados do produto (link fornecido pelo produtor)
2. Preenche nome e email
3. Aguarda aprovação do produtor (se aprovação manual) ou recebe link imediatamente (se automática)
4. Com o link de afiliado em mãos, promove o produto
5. Acompanha cliques, conversões e comissões no painel de afiliado

---

## Como fazer o primeiro saque

1. Acesse **Financeiro** > **Saques**
2. Verifique o saldo disponível para saque
3. Clique em **Solicitar saque**
4. Confirme a chave PIX cadastrada (CPF, email, telefone ou chave aleatória)
5. Confirme o valor
6. O saque é processado em até 1 dia útil

**Importante:** Para cartão de crédito, o saldo fica disponível em D+5 dias úteis após a venda. PIX fica disponível imediatamente.

---

## Como interpretar o relatório de vendas

Acesse **Relatórios** > **Vendas** para visualizar:

- **Receita bruta**: total faturado no período
- **Receita líquida**: receita bruta menos taxas e estornos
- **Ticket médio**: valor médio por transação
- **Transações aprovadas**: número de vendas concluídas
- **Taxa de conversão**: visitantes do checkout que compraram
- **Método de pagamento**: distribuição entre cartão, PIX e boleto
- **Origem das vendas**: de qual UTM/campanha vieram as vendas

Use os filtros de período, produto e método de pagamento para análises específicas.

---

## Como integrar com Shopify

1. Acesse **Integrações** > **Shopify**
2. Clique em **Conectar loja Shopify**
3. Insira a URL da sua loja Shopify (ex: minha-loja.myshopify.com)
4. Autorize a conexão no painel do Shopify
5. Configure quais produtos sincronizar
6. Ative a sincronização de pedidos

Após integração, vendas feitas pelo checkout Bloopi são registradas automaticamente no Shopify como pedidos.

---

## Como configurar webhooks

1. Acesse **Configurações** > **Webhooks**
2. Clique em **Novo Webhook**
3. Insira a URL do endpoint que receberá os eventos
4. Selecione os eventos que deseja receber:
   - `payment.approved`
   - `payment.declined`
   - `payment.refunded`
   - `subscription.created`
   - `subscription.renewed`
   - `subscription.canceled`
   - `subscription.past_due`
5. Salve

A Bloopi enviará um POST com payload JSON para a URL configurada em cada evento. Em caso de falha (resposta não-200), tentativas automáticas são realizadas.

---

## Como usar a API da Bloopi

A Bloopi oferece API REST para integração programática.

**Autenticação:** Bearer token com sua API Key (gerada em Configurações > API)

**Endpoints principais:**
- `POST /v1/payment-intents` — criar intenção de pagamento
- `GET /v1/payment-intents/{id}` — consultar status de pagamento
- `GET /v1/transactions` — listar transações
- `GET /v1/products` — listar produtos
- `GET /v1/subscriptions` — listar assinaturas

Documentação completa: https://ai.bloopi.com.br/pt-BR/api

---

## Como configurar o tema TikTok Shop

1. Acesse **Produtos** > selecione o produto > **Checkout** > **Tema**
2. Selecione **TikTok Shop**
3. Configure as informações da "loja" (nome, avaliação, número de vendidos)
4. Configure as variantes do produto se aplicável
5. Configure o timer da oferta relâmpago
6. Configure a seção de avaliações (nota e número de avaliações)
7. Salve

O checkout TikTok Shop apresenta o fluxo em etapas: produto → seleção de variante → resumo do pedido → pagamento → confirmação PIX.

---

## Como adicionar depoimentos ao checkout

1. Acesse **Produtos** > selecione o produto > **Checkout** > **Prova Social**
2. Ative a seção de depoimentos
3. Clique em **Adicionar depoimento**
4. Preencha nome, foto (opcional), texto e avaliação em estrelas
5. Adicione quantos depoimentos quiser (recomendado: 3 a 5)
6. Organize a ordem de exibição
7. Salve

---

## Como funciona o timer de escassez

O timer de escassez cria urgência no checkout exibindo uma contagem regressiva.

**Configuração:**
1. Acesse **Produtos** > selecione o produto > **Checkout** > **Timer**
2. Ative o timer
3. Configure o tempo (ex: 30 minutos)
4. Customize a mensagem (ex: "Oferta expira em:")
5. Escolha a cor de fundo e texto
6. Salve

**Comportamento:** O timer começa quando o comprador abre o checkout. É por sessão — cada visitante tem seu próprio contador.

---

## Como configurar a página de obrigado

1. Acesse **Produtos** > selecione o produto > **Página de Obrigado**
2. Configure título e subtítulo
3. Adicione vídeo de boas-vindas (URL do YouTube ou Vimeo)
4. Configure botão de acesso ao produto (URL da área de membros, WhatsApp, etc.)
5. Adicione links adicionais (comunidade, suporte, material complementar)
6. Configure pixel de conversão adicional se necessário
7. Salve

A página de obrigado é exibida após pagamento aprovado e após aceitação/recusa de upsells.

---

## Como ver o rastreamento UTM das vendas

1. Acesse **Relatórios** > **Origem das Vendas**
2. Veja a distribuição de vendas por:
   - `utm_source` (ex: facebook, google, tiktok, organic)
   - `utm_medium` (ex: cpc, email, social)
   - `utm_campaign` (nome da campanha)
3. Filtre por produto e período

Os UTMs são capturados automaticamente da URL do checkout e associados a cada venda. Mesmo que o comprador visite o checkout múltiplas vezes, o UTM da primeira visita é preservado.

---

## Como ativar 2FA na conta

1. Acesse **Configurações** > **Segurança**
2. Clique em **Ativar autenticação de dois fatores**
3. Escaneie o QR Code com Google Authenticator, Authy ou similar
4. Insira o código de 6 dígitos para confirmar
5. Salve os códigos de recuperação em local seguro

Após ativação, o código 2FA será solicitado a cada novo login.

---

## Como funciona o prazo de disponibilização do saldo

**Cartão de crédito:**
- Vendas aprovadas ficam disponíveis em D+5 dias úteis
- Ex: venda aprovada na segunda-feira → saldo disponível na segunda-feira seguinte

**PIX:**
- Pagamentos confirmados ficam disponíveis para saque imediatamente

**Boleto:**
- Após compensação bancária (normalmente D+2 úteis), o saldo fica disponível

**Chargebacks e disputas:**
- Valores em disputa ficam retidos até resolução
- Se a disputa for resolvida a seu favor: valor liberado
- Se perdida: valor debitado do saldo disponível
