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

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

法的注意

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

連携の概要

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

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

ローンチの前に、Indeed エントリー連携が有効になっていることを確認してください。

ローンチ時には、ローンチ日より前の応募者ステータスデータも送信します。そのデータの開始日について、ATS内の各採用企業と合意してください。

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

Indeedが提供するテストクライアントを使用してください。すべてのテスト用応募者ステータスで、indeedApplyIDに本番値を設定します。このIDは、Indeed エントリー連携を通じて届く各応募のペイロードに含まれています。本番値以外を使用すると、APIがエラーを返す可能性があります。

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

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

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

日本では、Indeedの標準応募者ステータスの代わりに、次の表のステータスをdispositionStatusに設定します。採用企業がステータスラベルをカスタマイズしている場合は、各ラベルを対応するステータスにマッピングしてください。

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	必須

本番のIndeed エントリー連携のindeedApplyID値を使用して、テスト呼び出しを少なくとも20件送信します。各呼び出しで、APIがエラーを返さないこと、およびレスポンスのfailedDispositionsが空であることを確認してください。

すべてのテスト呼び出しが成功したら、テクニカルサポートのメールスレッドに返信してください。その後、Indeedはデータをレビューし、連携が動作していることと応募者ステータスが正確であることを確認します。

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

ローンチ当日は、各採用企業と合意した開始日からの応募者ステータスデータを送信するバッチジョブを実行します。ジョブが完了したら、応募者ステータスデータの継続的な送信を開始します。