Conceitos
Privacidade e eliminação
Os dados das pessoas precisam de um âmbito próprio, quem elimina os seus dados fica eliminado e os segredos nunca saem da AttendBeacon.
Os dados pessoais precisam de people:read
Nomes, endereços de e-mail, empresas, números de telefone, respostas a perguntas de inscrição, compradores em encomendas e faturas: tudo o que diz quem alguém é precisa do âmbito people:read. Sem ele, a API continua a responder, com as pessoas como ids:
{
"attendeeId": "b3ac0008-0000-4000-8000-000000000000",
"ticketTypeName": "Conference pass",
"firstName": null,
"lastName": null,
"email": null,
"answers": null,
"status": "active",
"valid": true,
"personalData": "withheld"
}Assim, um painel que conta bilhetes, uma sincronização do programa ou um assistente de IA que reporta vendas não precisa de dados pessoais, e não os deve receber. Uma chamada cujo propósito é uma pessoa, como pesquisar participantes pelo nome ou ler contactos comerciais, é recusada sem o âmbito (peopleScope).
Os oradores e os patrocinadores estão na página pública do evento, por isso os seus nomes não são aqui dados pessoais; o endereço de e-mail de um orador é, e precisa de people:read.
Alguém que eliminou os seus dados
Um participante pode eliminar os seus dados na app do evento (Mais › Eliminar os meus dados). A partir desse momento:
- a API responde sobre ele com
"erased": true,"personalData": "erased"e nada pessoal, sejam quais forem os âmbitos da chave; - a pesquisa nunca o encontra;
- as respostas guardadas para um Idempotency-Key que o nomeavam são eliminadas;
- o webhook
attendee.erasedavisa de imediato todos os pontos de acesso, apenas pelo id.
Quando receber attendee.erased, elimine ou anonimize a sua própria cópia desse participante. O seu bilhete foi cancelado se o evento ainda estava para acontecer (ticketCancelled), e não é enviado um attendee.cancelled separado. As faturas mantêm o comprador tal como foi impresso, porque a lei obriga a conservar as faturas durante sete anos.
Módulos desligados
Um organizador pode desligar funcionalidades por evento, em Módulos do evento. Enquanto um módulo está desligado, as suas rotas respondem 409 com "code": "moduleOff" e o nome do módulo, e as suas ferramentas MCP dizem o mesmo. Nada é eliminado: quando é ligado de novo, os dados voltam.
| Módulo | Rotas |
|---|---|
addons | Complementos e códigos de desconto |
checkin | Portas, leituras nas portas, contagens de entradas e registo de entrada |
sponsors | Patrocinadores e níveis de patrocínio |
leads | Contactos comerciais |
cfp | Propostas ao convite a oradores |
crew | Equipa operacional e turnos |
feedback | Inquéritos e avaliações de sessões |
payments | Faturas e notas de crédito |
budget | O resumo do orçamento |
sharekit | A classificação do kit de partilha |
Nunca numa resposta
- Chaves de API, segredos de assinatura de webhooks (exceto uma vez, quando são criados), chaves de fornecedores de pagamentos.
- O código de um bilhete, que dá entrada ao seu titular, e os códigos de acesso dos tipos de bilhete.
- O token pessoal de um link do kit de partilha.
- O endereço completo de um ponto de acesso de webhook: a query fica oculta, porque um endereço do Power Automate leva aí a sua chave.
- O registo das chaves nunca guarda uma query string, um corpo ou uma resposta.
Onde ficam os dados
A AttendBeacon funciona na União Europeia (Sweden Central). O que a sua integração copia para fora é da sua responsabilidade: não o guarde mais tempo do que precisa, e aja quando receber attendee.erased.