日本のパートナー向けの要件

応募者ステータス連携APIを使用する日本のパートナー向けの追加要件です。

法的注意

本APIの使用に関する Indeed との書面による同意がない限り、Indeed のAPIの使用に追加API規約およびガイドラインが適用されることに同意したことになります。

応募者ステータス連携APIの概要については、応募者ステータス連携APIガイドをご覧ください。日本のパートナーは、このページの手順を完了し、そのガイドの要件も満たす必要があります。

連携前の準備

Indeedは、パートナー設定の一環としてアプリを設定します。応募者ステータス連携APIへのアクセスをリクエストするには、Indeedに連絡してください。

Indeedに次の情報を共有してください。

Indeed エントリー連携が有効になっていることを確認してから、応募者ステータス連携を開始してください。

連携を完了した後、ローンチ日より前の応募者ステータスデータを送信します。ATS内の採用企業に連絡し、その過去データの開始日について合意してください。

Indeedがアクセスを有効にした後、テクニカルサポートチームまたは日本のATSチームがメールでケースに返信します。その後、連携のコーディングを開始できます。技術チームとの今後の連絡は、すべてメールで行います。

Indeedが提供するテストクライアントを使用してください。すべてのテスト用応募者ステータスで、indeedApplyIdに本番値を設定します。Indeedは、Indeed エントリー連携を通じて送信される各応募のペイロードにこのIDを含めます。

indeedApplyIdが本番値でない場合、APIはエラーを返す可能性があります。

テスト中、Indeedは応募者ステータス連携APIを通じて送信された応募者ステータスデータをサンドボックスデータベースに保存します。このデータベースに送信されたデータは、メトリクスと分析から除外されます。

連携が次のガイドラインに従っていることを確認してください。

応募者ステータスは、できるだけリアルタイムに近い形で送信します。応募者ステータス連携APIを使用して、応募が経由するすべての応募者ステータスを送信してください。
システム内でステータスが変わるたびに応募者ステータスデータを送信してください。各変更を送信できない場合でも、少なくとも1日1回のスケジュールで送信します。
すべてのindeedApplyIdについて、dispositionStatusをNEWに設定した応募者ステータスを少なくとも1件送信してください。このステータスは、ATSが応募を受信した時点を表します。
Indeed Apply IDはuniversalApplyIdとして渡すこともできます。
リクエストを送信する前に、応募者ステータスをstatusChangeDateTimeの昇順、つまり古い順に並べ替えてください。
可能な場合は、複数の応募者ステータスを1つのリクエストにまとめます。1リクエストあたり25件を超えて送信しないでください。

dispositionStatusを、日本で必要なステータスに設定してください。Indeedの標準応募者ステータスの代わりに、これらのステータスを使用します。

ATSがまだすべての必須ステータスをサポートしていない場合でも、応募者ステータス連携APIの利用は開始できます。不足しているステータスは後で追加してください。

採用企業がステータスラベルをカスタマイズしている場合は、各ラベルを対応するステータスにマッピングしてください。

応募者ステータス
応募者ステータス		ATSの生ステータスの例	要件
1	`NEW`	New Applied Received New candidate	必須
2	`POSITIVELY_SCREENED`	Passed first review Application Approved	必須
3	`INTERVIEW`	Scheduling interview Fixed interview date Interview phase First round interview Final interview Passed interview	必須
4	`OFFER_MADE`	Offer Offering	必須
5	`HIRED`	Hired Placed	必須
6	`NOT_SELECTED`	Employer rejected Release	必須
7	`WITHDRAWN`	Candidate withdrew Offer declined	必須
8	`ONBOARDED`	Onboarded Already joined	必須

応募者ステータスデータを送信したときにエラーが返らないことを確認してください。実装を検証するには、本番プロダクトのindeedApplyIdを使用したテスト呼び出しを少なくとも20件送信します。

応募者ステータスデータでエラーが返らなくなったら、テクニカルサポートのメールスレッドに返信してください。Indeedは、連携が想定どおりに動作し、応募者ステータスが正確であることを確認するためにデータをレビューします。

Indeedが実装をレビューした後、チームは設定を本番モードに切り替え、本番クライアントを通じて応募者ステータスデータの送信を開始するよう依頼します。

ローンチ当日は、合意した開始日から過去の応募者ステータスデータを送信するバッチジョブを実行してください。ジョブの完了後、応募者ステータスデータを継続的に送信するよう連携を設定します。