日本のパートナー向け

Disposition Sync APIを使用する日本のパートナー向けの追加要件です。

法的注意

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

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

連携前の準備

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

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

Indeed エントリー連携を有効化してから、Disposition Sync 連携を開始してください。

連携を完了した後、go-live 日より前の応募者ステータスデータを送信します。ATS 内の雇用主に連絡し、その過去データの開始日について合意します。

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

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

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

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

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

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

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

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

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

応募者ステータス
応募者ステータス		ATS からの raw status の例	要件
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 件送信します。

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

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

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