Google Docs

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 de cliente no corpo do pedido de 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 é gerido num único ponto de controlo: a caducidade aciona uma atualização automática, os tokens de atualização rotativos são persistidos e uma atualização rejeitada pelo fornecedor traduz-se num aviso visível para restabelecer a ligação — nunca em funcionalidades avariadas em silêncio. A revogação funciona a partir de qualquer um dos lados: desligue aqui ou revogue nas definições de segurança do próprio fornecedor.

A2Escrever semântica e fluxo de dados

Cada movimento de dados é uma ação explícita com um resultado registado. As gravações ocorrem com o seu clique — ou automaticamente apenas quando ativa uma regra (o envio automático na contratação está desativado por predefinição, por fornecedor). As leituras — importações de pessoas, contas ou ficheiros — são executadas quandoprime o botão Importar, desduplicam em relação ao que já possui (clientes por nome, pessoas por e-mail), ignoram em vez de substituir e reportam com transparência o que foi criado versus o que foi ignorado, razão pela qual executar novamente qualquer importação é seguro por conceção.

Cada ação escreve uma linha no diário de atividade da aplicação (ats_app_activity): o que foi executado, quando, para que registo e o resultado — incluindo o texto de erro do próprio fornecedor na íntegra quando algo falha. Os relatórios de utilização dentro do ATS agregam esse mesmo diário, pelo que os relatórios de integração e a realidade da integração não podem divergir.

Tudo o que sai do caminho do pedido — distribuição de notificações, entrega de webhooks, registo de atividades, correio — é executado em threads de segundo plano do tipo "disparar e esquecer". Um endpoint externo lento nunca pode fazer com que a interface encrave, e um efeito secundário falhado é registado em vez de ser repetido silenciosamente gerando inconsistência.

A3Considerações operacionais

As ligações são ao nível da organização e restritas aos perfis de proprietário e administrador; os recrutadores utilizam as funcionalidades alimentadas por uma ligação, mas não podem ligar, desligar ou reconfigurar. Desligar remove imediatamente as credenciais armazenadas e interrompe as funcionalidades dependentes de forma visível, e não silenciosa. Os dados já importados continuam a ser seus e editáveis.

As pessoas importadas chegam marcadas como importadas com predefinições de privacidade conservadoras — não é assumido nenhum consentimento para quem nunca preencheu o seu formulário de candidatura, e aplicam-se as predefinições de retenção. Tudo o que escreve é seu para levar: as exportações em CSV e a aplicação Exportação de Dados abrangem os mesmos locais que o próprio produto lê. A saída é tão aberta quanto a entrada — por conceção, e não por concessão.

A4Posicionamento na topologia de integração

Esta integração já está disponível no registo. 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.