Segurança e LGPD na API do WhatsApp da FlashConnect
A FlashConnect isola os dados de cada empresa no próprio banco de dados (RLS), guarda as credenciais da Meta só no servidor e assina com HMAC-SHA256 os eventos que envia ao seu sistema. Chaves de API têm permissões por escopo, aparecem uma única vez e podem ser revogadas na hora. Os dados ficam no Brasil (São Paulo), e a sua empresa é a controladora dos dados dos seus contatos, como manda a LGPD.
Atualizado em
Como os dados de cada empresa ficam separados?
Todo dado de negócio (conversas, contatos, mensagens, agentes, templates) pertence a uma empresa, e o próprio banco de dados impede leitura cruzada por meio de regras de segurança por linha (RLS, Row Level Security). Mesmo que alguém tente acessar o registro de outra empresa pelo endereço certo, a resposta é "não encontrado".
A conta de operação da FlashConnect, usada pela nossa equipe para administrar clientes, não lê o conteúdo das conversas, dos contatos nem das mídias dos clientes.
Onde ficam as credenciais da Meta?
A conexão é feita pela janela oficial da Meta, sem você passar senha para ninguém. O token de acesso que a Meta entrega fica numa tabela sem nenhum acesso pelo navegador nem pela API: só as funções do servidor conseguem lê-lo.
Você pode revogar o acesso da FlashConnect à sua conta da Meta a qualquer momento, nas configurações do negócio na Meta, em Integrações. A revogação interrompe o acesso, mas não apaga os dados já armazenados; para isso, veja a exclusão de dados abaixo.
Como funcionam as chaves de API?
- O segredo da chave (
ck_live_…) aparece uma única vez, na criação. Guardamos só o hash SHA-256, então nem nós conseguimos recuperá-lo. - Cada chave recebe só os escopos de que precisa, como
messages:read(ler mensagens) oumessages:send(enviar). Chave sem o escopo recebeESCOPO_INSUFICIENTE. - A revogação vale na hora (
CHAVE_REVOGADA) e não pode ser desfeita. Hash e escopos de uma chave existente não podem ser alterados. - Só o dono e os administradores da conta criam e revogam chaves.
A conexão com o Claude e outras IAs usa as mesmas chaves e escopos, ou login autorizado por dono ou administrador. Veja a documentação da API REST e como conectar o Claude por MCP.
Como os webhooks são protegidos?
- Da Meta para a FlashConnect: a assinatura HMAC da Meta é conferida no corpo cru antes de qualquer leitura dos dados, e cada mensagem é gravada uma única vez, mesmo que a Meta a entregue de novo.
- Da FlashConnect para o seu sistema: cada evento sai assinado com HMAC-SHA256 e um carimbo de tempo, para o seu sistema rejeitar eventos alterados ou repetidos depois de 5 minutos. Há novas tentativas automáticas e um identificador de entrega para evitar processamento duplicado.
- Destinos de webhook precisam ser
https. Endereços internos (localhost, redes privadas, metadados de nuvem) são recusados.
Código de verificação em Node e Python em webhooks da FlashConnect.
Quem da equipe pode fazer o quê?
| Papel | O que pode |
|---|---|
| Dono | Tudo, inclusive assinatura e cartão. O último dono não pode ser removido. |
| Administrador | Gerencia equipe, chaves de API, webhooks, agentes, produtos e conhecimento. |
| Atendente | Atende as conversas. Vê agentes, produtos e conhecimento, mas não altera; não mexe em chaves nem webhooks. |
As permissões são aplicadas no banco de dados, não só na tela. Mais em equipe e distribuição.
As ações ficam registradas?
Sim. Ações sensíveis, como criar chave de API, mudar a assinatura e alterar conversas, ficam num registro de auditoria da empresa, com quem fez, o quê e quando.
Como ficam pagamento e arquivos?
- Cartão: os dados vão por HTTPS direto ao Asaas, que guarda o cartão na assinatura. Guardamos só a bandeira e os 4 últimos dígitos; o número completo não entra em log nem no nosso banco.
- Mídia: fotos, áudios e documentos ficam em armazenamento próprio e são entregues por link assinado que vale 1 hora.
- Infraestrutura: banco de dados e funções em São Paulo, com tráfego criptografado (HTTPS).
Como a FlashConnect trata os dados pela LGPD?
- A sua empresa é a controladora dos dados dos seus contatos e das conversas. A FlashConnect é operadora: trata esses dados só para executar o serviço, sob a sua instrução.
- Retenção: mensagens e contatos ficam guardados enquanto durar a assinatura. Encerrada a assinatura, são eliminados em até 90 dias, salvo obrigação legal.
- Direitos dos titulares: pedidos de acesso, correção ou eliminação vão para privacidade@castilhoia.com. Confirmamos em até 2 dias úteis.
- Exclusão da empresa: o dono da conta pede por e-mail a privacidade@castilhoia.com, com o nome da empresa. Confirmamos em até 5 dias úteis e concluímos em até 30 dias.
- Exportação de dados pelo painel ainda não está disponível. Até lá, os dados podem ser lidos pela API.
Documentos completos: Política de Privacidade, Termos de Uso e instruções de exclusão de dados.
A conexão em si segue as regras da Meta; veja o que é a API oficial do WhatsApp.
Perguntas frequentes
A FlashConnect está de acordo com a LGPD?
A FlashConnect trata os dados das conversas como operadora, sob instrução da sua empresa, que é a controladora. Os dados ficam no Brasil, isolados por empresa, e pedidos de titulares são atendidos pelo e-mail privacidade@castilhoia.com.
Outra empresa pode ver as minhas conversas?
Não. O banco de dados isola cada empresa com regras de segurança por linha (RLS). Até a conta de operação da FlashConnect fica sem acesso ao conteúdo das conversas.
Onde ficam os meus dados?
Em servidores em São Paulo, no Brasil, com tráfego criptografado por HTTPS.
O que acontece se uma chave de API vazar?
Revogue a chave no painel: ela para de funcionar na hora. Como cada chave tem só os escopos necessários, uma chave de leitura vazada não consegue enviar mensagens.
Como peço a exclusão dos dados da minha empresa?
O dono da conta envia um e-mail para privacidade@castilhoia.com com o nome da empresa. A confirmação sai em até 5 dias úteis e a exclusão é concluída em até 30 dias.
A FlashConnect guarda o número do meu cartão?
Não. Os dados do cartão vão direto para o Asaas, nosso parceiro de pagamento, que faz as cobranças. Guardamos só a bandeira e os 4 últimos dígitos.
Quer usar a FlashConnect?
O acesso está sendo liberado por convite. Fale com a gente no WhatsApp.
Pedir convite no WhatsApp