参加者とは、面接を受ける人、つまり候補者、研修生、または学生のこと
です。まず参加者を作成し、その後で面接（セッション）を予約します。
参加者は1つのテンプレートに属します。そのため、同じメールアドレスが2つの
異なるテンプレートの下で2人の異なる参加者として登場することもあります。
各フィールドをわかりやすく
本人のメールアドレス。アカウント内で一意である必要があります。招待はここに送信されます。
あなたのシステム（ATS、LMS、アプリ）における本人のID。すべての
Webhookで返されるため、当社のIDを保存しなくても結果を突き合わせられます。
AIを助けるための基本情報: { title, organization, experienceLevel, location }。
さらに詳しい情報: { skills: [...], education, languages: [...] }。
本人の履歴書へのリンク。AIがこれを読むことで、より適切な質問ができます。
後で人を見つけるために選ぶラベル。例: ["senior", "remote"]。
追加手順をステップごとに
参加者を開く
チームダッシュボードで、左サイドバーの参加者をクリックします。
参加者を追加する
追加（または新規参加者）をクリックします。
氏名とメールアドレスを入力する
この2つは必須です。メールアドレスは面接の招待が送信される先です。
ロールを選ぶ
この人を評価する対象のロールを選択します。
保存する
保存します。参加者がリストに表示され、スケジュールできる状態になります。
テンプレートを選ぶ
この人がどの role_id に対するものかを決めます。
氏名とメールアドレスを入力する
この2つは必須です。メールアドレスに招待が届きます。
自分のIDを追加する
external_id に、自分のシステムでの本人のIDを設定します。後々の手間が省けます。
リクエストを送信する
curl -X POST "https://www.intervyo.ai/api/v1/participants?accountSlug=<slug>" \
-H "x-api-key: iv_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"name": "Jane Smith",
"email": "[email protected]",
"external_id": "greenhouse-8821",
"role_id": "ce1cd564-...",
"profile": { "title": "Software Engineer", "experienceLevel": "senior" }
}'
IDを保存する
レスポンスで参加者の id が返されます。これを使ってセッションをスケジュールします。
大量のリストがありますか？
一括インポート
エンドポイントを使えば、1回の呼び出しで最大500人を追加できます。
重複したメールアドレスは自動的にスキップされます。 ユースケースごとの例
履歴書つきの、ATS から取り込んだ候補者。{
"name": "Jane Smith",
"email": "[email protected]",
"external_id": "greenhouse-8821",
"role_id": "ce1cd564-...",
"profile": { "title": "Software Engineer", "experienceLevel": "senior" },
"resume_url": "https://.../jane-resume.pdf",
"tags": ["senior", "backend"]
}
スキルを学習中の従業員。IDは人事レコードです。{
"name": "Carlos Reyes",
"email": "[email protected]",
"external_id": "workday-44120",
"role_id": "ce1cd564-...",
"profile": { "title": "Account Executive", "organization": "West Region" },
"tags": ["q3-cohort"]
}
練習中の学生。情報は最小限に。挨拶できる程度で十分です。{
"name": "Priya Patel",
"email": "[email protected]",
"external_id": "user_98213",
"role_id": "ce1cd564-...",
"profile": { "title": "New Grad", "experienceLevel": "entry" }
}
次のステップ
参加者を作成する（API）
エンドポイントの完全なリファレンス。
