Integração SendGrid

A1Connection architecture

Esta é uma ligação direta a um sistema que acolhe ou configura: o formulário aceita o URL da sua instância e a credencial, verifica-os com uma chamada em direto antes de guardar qualquer informação e armazena os segredos encriptados em repouso. As páginas de ligação mostram o estado ("ligado", "guardado ✓"), nunca os valores em si.

Como a credencial é sua, a rotação está nas suas mãos: substitua a chave no seu próprio sistema, cole a nova aqui e a verificação em direto confirma-a antes que a antiga seja substituída. A desconexão remove imediatamente a credencial armazenada.

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.