Facebook

A1Connection architecture

The connection uses OAuth 2.0 against the vendor's own consent screen. The authorisation request names the minimum scopes the features need — the exact scope list is shown in the security-flow panel below, pulled from the same provider registry the application uses. The code-for-token exchange happens entirely server-side (credenciais do cliente no corpo da requisição do token, per the vendor's token endpoint contract); tokens are stored encrypted at rest and are never rendered back to any screen — connection pages show presence, not values.

O ciclo de vida dos tokens é gerenciado em um ponto de controle centralizado: a expiração aciona uma atualização automática, os tokens de atualização rotacionados são persistidos e uma atualização rejeitada pelo provedor é exibida como uma solicitação visível de reconexão — nunca como recursos corrompidos silenciosamente. A revogação funciona de ambos os lados: desconecte aqui ou revogue nas próprias configurações de segurança do fornecedor.

A2Escrever semântica e fluxo de dados

Cada movimentação de dados é uma ação explícita com resultado registrado em log. As gravações ocorrem com o seu clique — ou automaticamente apenas onde você tiver ativado uma regra (o envio automático na contratação fica desativado por padrão, por provedor). As leituras — importações de pessoas, contas ou arquivos — são executadas quando você clica em Importar, realizam a desduplicação em relação ao que você já possui (clientes por nome, pessoas por e-mail), ignoram em vez de sobrescrever e relatam fielmente criados versus ignorados, razão pela qual reexecutar qualquer importação é seguro por definição.

Cada ação grava uma linha no registro de atividades do aplicativo (ats_app_activity): o que foi executado, quando, para qual registro e o resultado — incluindo o texto exato de erro do provedor quando algo falha. Os relatórios de uso dentro do ATS agregam esse mesmo registro, garantindo que os relatórios de integração e a realidade da integração nunca divirjam.

Tudo o que sai do caminho da solicitação — disparo de notificações, entrega de webhooks, registro de atividades em diário, e-mails — é executado em threads de segundo plano no modelo fire-and-forget. Um endpoint externo lento nunca fará a interface travar, e uma falha de efeito secundário é registrada em log em vez de ser repetida silenciosamente gerando inconsistências.

A3Considerações operacionais

As conexões são de nível organizacional e restritas às funções de proprietário e administrador; recrutadores utilizam os recursos habilitados por uma conexão, mas não podem conectar, desconectar ou reconfigurar. A desconexão remove as credenciais armazenadas imediatamente e interrompe os recursos dependentes de forma visível, não silenciosa. Os dados já importados continuam sob sua propriedade e editáveis.

Pessoas importadas chegam marcadas como importadas com padrões conservadores de privacidade — nenhum consentimento é presumido para quem nunca preencheu seu formulário de candidatura, e as regras padrão de retenção se aplicam. Tudo o que foi registrado é seu: as exportações em CSV e o aplicativo de Exportação de Dados abrangem os mesmos repositórios que o próprio produto consulta. A saída é tão acessível quanto a entrada — por definição de projeto, e não por concessão.

A4Posicionamento na topologia de integração

Esta integração já está disponível no catálogo hoje. One connection per provider unlocks every feature it powers, and the topology grid below shows the neighbouring connectors in the same capability area — statuses come from the same registry that drives the in-app hub, so this page can never claim more than the product does. For anything the catalogue does not cover, Webhooks and Zapier are the generic, documented escape hatch.