Skip to main content
O Pilot Status permite controlar por quanto tempo dados sensíveis (PII) são armazenados. Existem duas camadas independentes:
  1. Retenção no nível da chave de API — por quanto tempo os logs de mensagens enviadas mantêm PII.
  2. Modo de PII por número — se as mensagens de chat recebidas/enviadas e as conversas são armazenadas ou não.

​
Retenção no nível da chave de API

Configurada por chave de API na página API Keys (/api-keys):
  • retentionDays > 0 — a PII nos logs de mensagens enviadas é mantida por até N dias.
  • retentionDays = 0 — a PII não é persistida.
Mesmo com a retenção desativada, os eventos de webhook ainda são entregues — campos sensíveis (por exemplo, destinationNumber, content) podem ficar vazios, mas IDs, timestamps, status e metadados de rastreamento permanecem.

​
Modo de PII por número

Cada número de WhatsApp é configurado de forma independente com um dos três modos (definido nas configurações do número no painel):

​
Efeito no painel

​
Efeito nos endpoints de leitura v1

GET /v1/conversations, GET /v1/messages/unread e GET /v1/messages/group aplicam a mesma restrição:

​
Dados de Flow

Um Flow do WhatsApp guarda três registros próprios, e as janelas deles são fixas na plataforma — não são o retentionDays da chave de API, nem o piiRetentionDays do número.
Por que as trocas ganham um dia a mais que as respostas. Uma troca é capturada enquanto o cliente ainda preenche o formulário, minutos antes da submissão que cria a linha da resposta. Com 30 dias iguais as trocas expirariam primeiro, e uma resposta nos seus últimos minutos de vida publicaria um submitted vazio ao lado de respostas que estiveram lá o tempo todo.
Num número RELAY_ONLY nenhuma troca é guardada — não é linha apagada: não há linha. A chamada continua sendo decifrada e repassada ao seu endpoint, como tudo nesse modo; o que não fica é a cópia. Onde a redação de um número apaga uma cópia guardada do evento, o submitted volta null — nunca [], que se leria como respostas escondidas em vez de respostas ausentes. Na superfície de leitura, GET /v1/flows/{id}/responses, vazio escreve-se []: lá não há payload guardado para redigir, e um campo posto a nada desapareceria do JSON em vez de chegar vazio.
O arquivo de Flow re-hospedado sobrevive à resposta a que pertencia, numa URL pública. Quem tem o link lê o arquivo, e o link continua funcionando depois que as respostas deixaram de ser servidas em GET /v1/flows/{id}/responses. Decida isso antes que um Flow seu peça um documento de identidade a alguém.

​
O encaminhamento está sempre ativo

Independentemente do modo de PII, estes sempre funcionam:
  • Webhooks de saída (eventos de entrega e eventos recebidos)
  • A integração com o Chatwoot (receber e responder)
  • Envio de mensagens
Apenas o armazenamento e a releitura são afetados.

​
Relacionados