Webhooks

A1Connection architecture

Este aplicativo é baseado em configurações: o que você salva é aplicado diretamente pela plataforma — nenhuma vinculação com contas de terceiros está envolvida. As configurações são validadas ao salvar, armazenadas por organização e entram em vigor na próxima solicitação.

As alterações são imediatas e reversíveis; a remoção da configuração interrompe o comportamento de forma visível. Como em qualquer conector, os segredos (caso existam) são armazenados criptografados e exibidos apenas como sinalizadores de presença.

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.