Que dados uma reserva deixa e para onde eles vão
Os guias de privacidade para ferramentas de agenda costumam começar pela papelada: contrato de operador, lista de suboperadores, cláusulas de transferência. Tudo isso importa, e o Cal.com publicou um guia longo sobre GDPR que cobre bem esses pontos. Mas antes da papelada existe uma pergunta mais concreta, a que qualquer pessoa que peça para ver ou apagar seus dados vai fazer: onde eles estão?
Este post responde isso para o Cal, lido do código. É o mapa de que você precisa para escrever seu aviso de privacidade, responder a um pedido de exclusão ou decidir se o self-host faz sentido para você.
A linha: o que o Cal guarda de cada reserva
Cada reserva é uma linha na tabela calendar_bookings. Estes são os campos pessoais e operacionais:
| Campo | O que é |
|---|---|
invitee_name, invitee_email |
Nome e email de quem reservou. Sempre obrigatórios |
starts_at, ends_at, timezone |
Horário e fuso horário da pessoa |
locale |
Idioma em que a pessoa reservou (para os emails saírem nesse idioma) |
answers |
As respostas às suas perguntas próprias, em JSON |
status, cancel_reason |
Confirmada, cancelada, não compareceu ou aguardando pagamento, e o motivo se cancelou |
host_user_id |
Quem do seu time atende (no round-robin) |
meeting_url, google_event_id |
Link da videochamada e referência ao evento do Google |
manage_token |
O token do link para reagendar ou cancelar |
payment_status, amount_cents, currency, stripe_session_id |
Só se o tipo de evento cobra |
O que não está na linha: o endereço IP, o navegador, o dispositivo. O endpoint de reservas usa o IP para barrar abuso (até 10 tentativas a cada 10 minutos por IP) numa tabela de limites que se apaga sozinha quando a janela termina. Nossa política de privacidade traz os detalhes, junto com os logs de curta duração do provedor de hospedagem.
A coluna que pede mais cuidado é answers. Uma pergunta de texto livre como "Algo que devemos saber?" convida respostas que você não quer guardar: um diagnóstico médico, um problema jurídico, dados de outra pessoa.
As cópias: para onde cada reserva viaja
Quando alguém confirma, o Cal faz cinco coisas além de salvar a linha. Cada uma deixa uma cópia em outro lugar:
- Emails. A confirmação para o convidado (com
.ics), o aviso para o anfitrião e cada lembrete. No zerosoft Cloud eles saem pelo Resend. Levam nome, horário, local e o link de gestão. - Google Calendar, se você conectou. É criado um evento na sua agenda com o título do tipo de evento, o nome da pessoa, o email dela como convidada e uma descrição com nome e email. As respostas não vão para o Google.
- CRM. Cada reserva cria o contato se ele não existir (nome e email) e uma atividade de reunião na ficha dele. O corpo dessa atividade inclui as respostas. Se a pessoa cancelar depois, a atividade recebe o motivo.
- Webhooks e Flow. Os eventos
booking.created,booking.rescheduledebooking.cancelledmandam para as suas URLs o nome, o email, o horário, as respostas e, se houver, o pagamento. O que o receptor faz com isso já é responsabilidade sua. - Stripe, se você cobra. A sessão de Checkout fica na sua conta do Stripe, com o que o Stripe exigir para cobrar.
Esse mapa é o que você vai precisar no dia em que alguém escrever. Guarde junto do seu aviso de privacidade.
Quem responde pelo quê
Para as reservas que você recebe, o controlador dos dados é você: decide o que perguntar, para quê e por quanto tempo. No zerosoft Cloud, o zerosoft trata esses dados em seu nome, e os provedores que operam a nuvem (Vercel para hospedagem, Turso para o banco de dados, Resend para os emails) estão na política de privacidade. Google, Stripe e os receptores dos seus webhooks só entram se você os conectar.
Com o self-host a cadeia encurta: você escolhe o servidor, o banco e o provedor de email, e o código AGPLv3 está aí para qualquer pessoa do seu time conferir este mapa. Para um time que precisa que os dados não saiam de um país, é o caminho mais direto. Como referência, o Cal.com diz nesse mesmo guia que a hospedagem dele na União Europeia é para empresas com 50 usuários ou mais e estava em acesso antecipado.
Coletar menos a partir do formulário
O dado mais barato de proteger é o que nunca é guardado. Nas Perguntas de cada tipo de evento:
- Prefira sim/não ou número a texto livre. As perguntas próprias podem ser de texto, número ou sim/não. "Você já usa um CRM?" responde o mesmo que "Conte sobre a sua situação" e deixa menos texto solto.
- Marque como opcional o que você não precisa de jeito nenhum. Cada pergunta tem sua caixa de obrigatória.
- Diga o que não enviar. Na mensagem de boas-vindas do tipo de evento, uma linha como "Não inclua dados de saúde nem de outras pessoas neste formulário" evita problemas.
- Revise as perguntas a cada trimestre. A pergunta que você criou para uma campanha continua lá coletando dados.
Como responder a um pedido de exclusão
Alguém escreve: "Apaguem tudo o que vocês têm sobre mim." Com o mapa acima, o caminho é este:
- Cal. Cancelar uma reserva não a apaga: ela fica como cancelada, com o histórico. Hoje o Cal não tem um botão para apagar uma reserva específica; apagar um tipo de evento apaga todas as reservas dele, o que raramente é o que você quer. No zerosoft Cloud, o canal para um pedido pontual é privacy@zerosoft.ai, que consta na política de privacidade. No self-host você faz isso no banco (o SQL está abaixo).
- CRM. Apague o contato pela ficha. Confira se ele não ficou numa lista ou num deal.
- Google Calendar. Apague o evento à mão. Se a pessoa era convidada, a cópia na agenda dela é dela.
- Webhooks. O que chegou na sua planilha, no seu banco ou na sua automação precisa ser apagado lá.
- Stripe. Pagamentos têm regras próprias de retenção por motivos fiscais; confira as do Stripe e as do seu país antes de apagar.
- Responda com data. Diga à pessoa o que você apagou e onde.
Para o self-host, este SQL apaga as reservas de um email e os lembretes pendentes delas. Faça um backup antes:
DELETE FROM calendar_workflow_runs
WHERE booking_id IN (SELECT id FROM calendar_bookings WHERE invitee_email = 'pessoa@exemplo.com');
DELETE FROM calendar_reminders
WHERE booking_id IN (SELECT id FROM calendar_bookings WHERE invitee_email = 'pessoa@exemplo.com');
DELETE FROM calendar_bookings WHERE invitee_email = 'pessoa@exemplo.com';
O que falta, dito
- Apagar uma reserva pela interface. É a maior lacuna deste post.
- Retenção automática. Não existe uma regra do tipo "apagar reservas com mais de 24 meses". As reservas ficam guardadas enquanto você as mantiver.
- Exportar as reservas de uma pessoa. A API lista reservas com busca (
GET /api/v1/calendar/bookings?q=), o que serve para montar um pedido de acesso, mas não há um botão de "exportar tudo deste email".
Se alguma delas te trava, conte no feedback board. Enquanto isso, o mapa de cópias é o que mais vai te poupar tempo: um pedido de exclusão sem mapa leva uma tarde, e com mapa leva quinze minutos.