API de Vendas
Fonte da base de participantes e das vendas. Alimenta os pontos e o dashboard.

Verificando…

1. Credenciais da API

Fornecidas pela CVP. Token de autenticação (VENDAS_API_TOKEN) e endpoint da API de vendas.

URL base da APIEndpoint fornecido pela CVP

Caminho das vendasParte final da URL, ex.: vendas

Token da APIVENDAS_API_TOKEN — criptografado

2. Sincronismo

Com que frequência a plataforma busca novos participantes e vendas na CVP.

FrequênciaRecomendado: diário

Importar

Ao importar, criar participante novoBase de usuários vem daqui

Ainda não sincronizado.

Os participantes importados aparecem em Participantes

Firebase Cloud Messaging (FCM)
Notificações push no navegador e no app instalado (PWA).

Conectado

1. App Web — credenciais do cliente

Firebase Console → Configurações do projeto → aba Geral → seção "Seus apps" → app Web → Configuração do SDK.

API KeyapiKey

Auth DomainauthDomain

Project IDprojectId

Messaging Sender IDmessagingSenderId

App IDappId

Measurement ID (opcional)measurementId

2. Chave Web Push (VAPID)

Firebase Console → Configurações do projeto → aba Cloud Messaging → Certificados push da Web → "Gerar par de chaves". Sem isso o navegador não consegue assinar a inscrição.

VAPID — chave públicaVai no cliente (getToken / subscribe)

VAPID — chave privadaFica só no servidor

3. Servidor de envio

Firebase Console → Contas de serviço → "Gerar nova chave privada" (arquivo JSON). É o que autentica o backend para disparar os pushes (API HTTP v1).

Service Account (JSON)

Enviar arquivo .json

serviceAccountKey.json

Client e-mailclient_email do JSON

Private keyprivate_key do JSON

Server key (legado)Só se ainda usar a API legada

4. Padrões da notificação

Título padrãoUsado quando o envio não define título

Ícone192×192 px

URL ao clicarTela aberta ao tocar na notificação

Assunto VAPIDContato exigido pelo protocolo

Credenciais criptografadas

Google Gemini
Motor de IA do Parceiro CVP. Sem esta chave ele não responde.

Não configurado

1. Acesso (Google AI Studio) — recomendado

Gere a chave em aistudio.google.com → Get API key. É o caminho mais simples e barato.

API Key *Fica só no servidor; nunca é exposta ao app do participante

Modelo padrãoPode ser sobrescrito na tela do Parceiro CVP

2. Alternativa corporativa (Vertex AI)

Use se a CVP já tiver Google Cloud e precisar de faturamento/governança corporativa.

Project IDProjeto no Google Cloud

RegiãoMais próxima = menor latência

Service Account (JSON)

Enviar arquivo .json

Credencial do backend

3. Controle de custo

Limites de segurança para a conta não estourar. Ao atingir o teto, o Parceiro CVP passa a responder só pelo cache local.

Teto de tokens por mêsBloqueia novas chamadas ao atingir

Alerta de consumo (%)Avisa o gestor por e-mail

Tempo limite por resposta (s)Evita conversas travadas

Configure a personalidade e os arquivos em Parceiro CVP (IA)

E-mail (SMTP)
Servidor de envio dos e-mails para os participantes.

Não configurado

1. Servidor de envio

Funciona com qualquer provedor SMTP: Gmail/Workspace, Brevo, SendGrid, Mailgun, Amazon SES, Zoho ou o e-mail da própria empresa. Pegue estes dados no painel do seu provedor.

Servidor SMTP *Ex.: smtp-relay.brevo.com · smtp.gmail.com · email-smtp.sa-east-1.amazonaws.com
Não é o seu login — o login vai no campo Usuário.

Porta587 = TLS (recomendado) · 465 = SSL · 25 = sem criptografia

CriptografiaCombine com a porta

UsuárioNormalmente o e-mail completo

Senha ou chave SMTPNo Brevo use a chave SMTP (SMTP & API → Gere uma nova chave). No Gmail, uma senha de app — nunca a senha da conta.

2. Remetente

Como o participante vê o e-mail na caixa de entrada. O endereço precisa ser verificado no seu provedor, senão ele recusa o envio.

E-mail do remetente *Aparece como remetente

Nome do remetenteAparece antes do e-mail

3. Testar

Envia um e-mail real para conferir se está tudo certo. Salve antes de testar.

Enviar teste para

O resultado aparece aqui.

A senha fica só no servidor, nunca é exposta ao app

Notificações push
Avisos no celular/navegador do participante, mesmo com o app fechado.

Não configurado

Chaves VAPID

O push usa o padrão VAPID — não precisa de conta em serviço nenhum, nem de custo. Gere o par de chaves uma única vez: a pública vai para o navegador do participante e a privada fica no servidor. Não gere de novo depois, senão todos os aparelhos já inscritos param de receber.

Estado

Verificando…

Exige HTTPS para funcionar (em localhost também funciona).

Envie as notificações em Comunicação → Push

WhatsApp (Baileys)
Dispara mensagens e responde os participantes com o Parceiro CVP.

Não configurado

1. Serviço

O WhatsApp roda num serviço Node separado (pasta whatsapp/, comando npm start). Ele fica só na máquina do servidor — não exponha esta porta na internet.

URL do serviço *Endereço interno do serviço Node

Token do serviçoPrecisa ser igual ao WPP_TOKEN do serviço

2. Ritmo de envio

Importante: o Baileys conecta como WhatsApp Web (não é API oficial). Mandar muitas mensagens seguidas é o caminho mais rápido para o número ser bloqueado pela Meta. Mantenha um intervalo e use um chip dedicado.

Intervalo entre envios (ms)3000 = 3 segundos entre cada mensagem

AssinaturaTexto acrescentado ao final de cada mensagem

Parear o celular em Comunicação → WhatsApp

Incentivale
Premiação / resgate parceiro

Conectado

URL da API

Usuário

Senha

Credenciais criptografadas

Magalu
Catálogo de resgate

Conectado

Token da API

ID do seller

Credenciais criptografadas

Supabase
Armazenamento

Conectado

URL

Anon key

Credenciais criptografadas