Documento publico de contratacao
Transparencia de integracoes, IA e riscos (minuta)
Mapa de integracoes, suboperadores, IA e risco WhatsApp.
1. Status do documento
Este texto e uma MINUTA TECNICA pendente de revisao juridica. Nao constitui politica aprovada, nao esta apto a producao e nao deve ser apresentado a titulares ou parceiros como documento final.
Versao da minuta: 0.1.0-minuta. Preparada em 2026-07-18.
Este aviso existe para decisao operacional rapida: o que entra/sai do Ofertal, com quais riscos.
2. Visao do fluxo de dados
Fontes externas (Meta Ads, Shopee, Mercado Livre, Evolution/WhatsApp) alimentam o painel. O Ofertal calcula metricas e recomendacoes localmente. A IA (DeepSeek) apenas narra ou responde com base em payloads ja calculados.
Persistencia principal: banco de dados PostgreSQL (Railway), com as tabelas do Better Auth. Mensagens WhatsApp: outro banco PostgreSQL (Railway) e Redis (Railway). Midia: armazenamento de arquivos S3.
3. Evolution API e WhatsApp nao oficial
Confirmado no codigo e no README: a conexao WhatsApp usa Evolution API (v2.x), nao a API oficial do WhatsApp Business.
Funcoes: pareamento por QR, estado da conexao, listagem/vinculo de grupos por JID, webhook de eventos de membros, sync de contagem, fila de mensagens outbound, captura de midia de fontes monitoradas.
Riscos que o operador precisa assumir
Bloqueio ou banimento do numero; queda de sessao; perda temporaria ou permanente de capacidade de envio; atraso ou falha de webhooks; divergencia entre estado Evolution e banco; impacto em grupos e campanhas que dependem do canal. O Ofertal nao elimina esses riscos.
- Telefones de participantes nao sao gravados em claro no painel: apenas hash SHA-256 com salt mantido no servidor.
- O numero pareado da operacao pode ser guardado no registro de conexao do painel, apenas para status operacional.
- Conteudo de mensagens enviadas/capturadas e dado operacional sensivel — minimize fontes monitoradas.
4. Transparencia de IA
Provedor confirmado: DeepSeek (api.deepseek.com), modelo configuravel (padrao deepseek-chat), chave apenas no servidor.
Modulos: briefing diario, insights-ai, offer-categories, data-chat.
Principio de produto: regras deterministicas calculam; a IA explica e conversa. Sem credencial de IA, o painel continua com os calculos.
- Nao envie segredos de integracao no chat; o desenho usa tools/payloads controlados, mas o operador deve evitar colar tokens.
- Caches guardam saida da IA e hash do input no banco de dados PostgreSQL (Railway).
- Localizacao do processamento DeepSeek e termos de subprocessamento: pendente de validacao juridica.
5. Suboperadores e integracoes
Lista derivada do repositorio. Coluna de evidencia separa o que o codigo confirma do que ainda exige DPA/localizacao.
| Servico | Papel | Finalidade | Evidencia | Transferencia / pendencia |
|---|---|---|---|---|
| Railway Postgres | infraestrutura | Banco de dados PostgreSQL (Railway) com as tabelas de autenticação Better Auth; dados operacionais, billing e caches de IA. | Confirmado no codigo | Regiao do serviço Railway e eventual transferencia internacional: pendente de validacao operacional. |
| Railway Postgres (fila do WhatsApp) | armazenamento | Fila e historico de mensagens WhatsApp, compartilhados com a Evolution API. | Confirmado no codigo | Provedor de hospedagem e regiao do Postgres Railway: pendente de validacao. |
| Railway Redis | fila | Transporte BullMQ da fila de envio WhatsApp. | Confirmado no codigo | Regiao e politica de retencao do Redis: pendente de validacao operacional. |
| Armazenamento de arquivos S3 | armazenamento | Armazenar midia capturada de mensagens monitoradas; acesso via proxy autenticado ou URL assinada de curta duracao. | Confirmado no codigo | Endpoint e regiao dependem do ambiente. Transferencia internacional: pendente de validacao. |
| DeepSeek | ia | Gerar briefing diario, narrativas de insights, categorias de ofertas e respostas do chat com dados ja calculados no servidor. | Confirmado no codigo | Chamada a API externa DeepSeek. Pais/regime de transferencia e clausulas contratuais: pendente de validacao juridica. |
| Meta Ads (Graph API) | anuncios | Importar gastos/resultados, sincronizar campanhas e aplicar escala/pausa de orcamento. | Confirmado no codigo | Dados trafegam com a infraestrutura da Meta. Localizacao e termos da Meta: pendente de validacao juridica. |
| Shopee Affiliate Open API | marketplace | Gerar short links e importar relatorios de conversao/comissao. | Confirmado no codigo | API de afiliados Shopee Brasil no codigo; transferencia e DPA: pendente de validacao. |
| Mercado Livre Afiliados | marketplace | Importar comissoes e gerar links de afiliado conforme endpoints configurados. | Confirmado no codigo | Endpoints configuraveis por env; localizacao e base legal com o marketplace: pendente de validacao. |
| Asaas | pagamento | Processar cobrancas Pix e cartao, assinatura recorrente, cancelamento, estorno e webhooks de cobranca. | Confirmado no codigo | DPA, prazo de retencao e localizacao do processamento: pendente de validacao juridica. |
| Evolution API (WhatsApp nao oficial) | mensageria | Parear numero WhatsApp, listar grupos, monitorar entradas/saidas, enviar fila de mensagens e capturar midia de fontes monitoradas. | Confirmado no codigo | Instancia Evolution e tipicamente self-hosted ou em infra propria (URL configuravel). Nao ha garantia de provedor unico no codigo. Risco operacional alto: ver documento de transparencia. |
Servico
Railway Postgres
Papel
infraestrutura
Finalidade
Banco de dados PostgreSQL (Railway) com as tabelas de autenticação Better Auth; dados operacionais, billing e caches de IA.
Evidencia
Confirmado no codigo
Transferencia / pendencia
Regiao do serviço Railway e eventual transferencia internacional: pendente de validacao operacional.
Servico
Railway Postgres (fila do WhatsApp)
Papel
armazenamento
Finalidade
Fila e historico de mensagens WhatsApp, compartilhados com a Evolution API.
Evidencia
Confirmado no codigo
Transferencia / pendencia
Provedor de hospedagem e regiao do Postgres Railway: pendente de validacao.
Servico
Railway Redis
Papel
fila
Finalidade
Transporte BullMQ da fila de envio WhatsApp.
Evidencia
Confirmado no codigo
Transferencia / pendencia
Regiao e politica de retencao do Redis: pendente de validacao operacional.
Servico
Armazenamento de arquivos S3
Papel
armazenamento
Finalidade
Armazenar midia capturada de mensagens monitoradas; acesso via proxy autenticado ou URL assinada de curta duracao.
Evidencia
Confirmado no codigo
Transferencia / pendencia
Endpoint e regiao dependem do ambiente. Transferencia internacional: pendente de validacao.
Servico
DeepSeek
Papel
ia
Finalidade
Gerar briefing diario, narrativas de insights, categorias de ofertas e respostas do chat com dados ja calculados no servidor.
Evidencia
Confirmado no codigo
Transferencia / pendencia
Chamada a API externa DeepSeek. Pais/regime de transferencia e clausulas contratuais: pendente de validacao juridica.
Servico
Meta Ads (Graph API)
Papel
anuncios
Finalidade
Importar gastos/resultados, sincronizar campanhas e aplicar escala/pausa de orcamento.
Evidencia
Confirmado no codigo
Transferencia / pendencia
Dados trafegam com a infraestrutura da Meta. Localizacao e termos da Meta: pendente de validacao juridica.
Servico
Shopee Affiliate Open API
Papel
marketplace
Finalidade
Gerar short links e importar relatorios de conversao/comissao.
Evidencia
Confirmado no codigo
Transferencia / pendencia
API de afiliados Shopee Brasil no codigo; transferencia e DPA: pendente de validacao.
Servico
Mercado Livre Afiliados
Papel
marketplace
Finalidade
Importar comissoes e gerar links de afiliado conforme endpoints configurados.
Evidencia
Confirmado no codigo
Transferencia / pendencia
Endpoints configuraveis por env; localizacao e base legal com o marketplace: pendente de validacao.
Servico
Asaas
Papel
pagamento
Finalidade
Processar cobrancas Pix e cartao, assinatura recorrente, cancelamento, estorno e webhooks de cobranca.
Evidencia
Confirmado no codigo
Transferencia / pendencia
DPA, prazo de retencao e localizacao do processamento: pendente de validacao juridica.
Servico
Evolution API (WhatsApp nao oficial)
Papel
mensageria
Finalidade
Parear numero WhatsApp, listar grupos, monitorar entradas/saidas, enviar fila de mensagens e capturar midia de fontes monitoradas.
Evidencia
Confirmado no codigo
Transferencia / pendencia
Instancia Evolution e tipicamente self-hosted ou em infra propria (URL configuravel). Nao ha garantia de provedor unico no codigo. Risco operacional alto: ver documento de transparencia.
6. Campos que exigem validacao juridica ou operacional
Nao inventamos estes dados. Antes da producao e obrigatorio preencher/validar:
- Razao social, CNPJ, endereco e qualificacao do controlador
- Encarregado/DPO e canal oficial do titular
- Prazos de retencao finais e rotina de exclusao
- DPAs e pais/regiao de cada suboperador
- Se hashes de participantes e mensagens exigem aviso/consentimento adicional nos grupos
- Parecer sobre uso continuado de API nao oficial de WhatsApp
- Mecanismo de aceite versionado dos documentos finais
- Validacao de isolamento por workspace em producao
7. Como usar este aviso na operacao
Antes de conectar WhatsApp, ative integracoes ou confiar em textos de IA, leia o status Legal no hub: se estiver minuta, nao ha cobertura de documento aprovado.
Duvidas de compliance sobem para juridico; duvidas de stack sobem para quem administra o Ofertal.