SendGrid統合

A1Connection architecture

これはご自身でホストまたは管理するシステムへの直接接続です。フォームにご自身のインスタンスURLと認証情報を入力すると、保存前にライブコールで検証され、シークレットは保存時に暗号化されて保管されます。接続ページには状態（「接続済み」「保存済み ✓」など）のみが表示され、値自体が表示されることはありません。

認証情報は貴社のものであるため、ローテーション管理も自社で行えます。自社システムでキーを再発行し、新しいキーをここに貼り付けると、古いキーが上書きされる前にライブ検証によって確認が行われます。接続を解除すると、保存されている認証情報は即座に削除されます。

A2セマンティクスとデータフローの記述

すべてのデータ移動は、結果がログに記録される明示的なアクションです。書き込みはクリック時、またはルールを有効にした場合にのみ自動で実行されます（採用時の自動プッシュはプロバイダーごとにデフォルトで無効になっています）。読み取り（候補者、アカウント、ファイルのインポート）は「インポート」を押したときに実行され、既存データ（クライアントは名前、候補者はメールアドレス）と重複排除され、上書きではなくスキップされ、作成数とスキップ数が正確にレポートされるため、インポートの再実行は設計上安全です。

各アクションはアプリのアクティビティジャーナル（ats_app_activity）に1行書き込まれます。実行内容、日時、対象レコード、そして結果（障害発生時のベンダー自身のエラーテキストをそのまま含む）が記録されます。ATS内の利用状況レポートはこのジャーナルを集計するため、連携レポートと連携の実態が乖離することはありません。

通知の一斉送信、Webhook配信、アクティビティログの記録、メール送信など、リクエストパスから外れる処理はすべて非同期のバックグラウンドスレッドで実行されます。外部エンドポイントの応答が遅くてもインターフェースがフリーズすることはなく、失敗した副作用はログに記録され、不整合を引き起こすようなサイレントな再試行は行われません。

A3運用上の考慮事項

連携は組織レベルで管理され、オーナーおよび管理者ロールに制限されています。採用担当者は連携によって有効化された機能を使用できますが、接続、切断、再設定を行うことはできません。切断すると、保存されていた認証情報は直ちに削除され、依存する機能はサイレントではなく明確に停止します。すでにインポートされたデータは保持され、編集も可能です。

インポートされた人材はインポート済みとしてマークされ、厳格なプライバシーのデフォルト設定が適用されます。応募フォームに入力していない人物については同意を得たとはみなされず、データ保持のデフォルト設定が適用されます。 記録されたすべてのデータはお客様のものです。CSVエクスポートとData Exportアプリは、製品自体が読み取るのと同じデータストアを対象としています。データの取り出しは取り込みと同様に自由に行えるよう設計されており、これは妥協ではなく意図された仕様です。

A4連携トポロジーにおける位置付け

この連携機能は現在レジストリで利用可能です。 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.