> ## Documentation Index
> Fetch the complete documentation index at: https://intervyo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 参加者

> 参加者とは何か、各フィールドをわかりやすく解説し、追加方法を説明します。採用、トレーニング、模擬面接の例つき。

**参加者**とは、**面接を受ける人**、つまり候補者、研修生、または学生のこと
です。まず参加者を作成し、その後で面接（セッション）を予約します。

参加者は1つのテンプレートに属します。そのため、同じメールアドレスが2つの
異なるテンプレートの下で2人の異なる参加者として登場することもあります。

## 各フィールドをわかりやすく

<ParamField path="name" type="string" required>
  本人のフルネーム。
</ParamField>

<ParamField path="email" type="string" required>
  本人のメールアドレス。アカウント内で一意である必要があります。招待はここに送信されます。
</ParamField>

<ParamField path="role_id" type="uuid">
  この人を評価する対象のロール。
</ParamField>

<ParamField path="external_id" type="string">
  **あなたの**システム（ATS、LMS、アプリ）における本人のID。すべての
  Webhookで返されるため、当社のIDを保存しなくても結果を突き合わせられます。
</ParamField>

<ParamField path="profile" type="object">
  AIを助けるための基本情報: `{ title, organization, experienceLevel, location }`。
</ParamField>

<ParamField path="background" type="object">
  さらに詳しい情報: `{ skills: [...], education, languages: [...] }`。
</ParamField>

<ParamField path="resume_url" type="url">
  本人の履歴書へのリンク。AIがこれを読むことで、より適切な質問ができます。
</ParamField>

<ParamField path="tags" type="string[]">
  後で人を見つけるために選ぶラベル。例: `["senior", "remote"]`。
</ParamField>

## 追加手順をステップごとに

<Tabs>
  <Tab title="ダッシュボード（UI）">
    <Steps>
      <Step title="参加者を開く">
        チームダッシュボードで、左サイドバーの**参加者**をクリックします。
      </Step>

      <Step title="参加者を追加する">
        **追加**（または**新規参加者**）をクリックします。
      </Step>

      <Step title="氏名とメールアドレスを入力する">
        この2つは必須です。メールアドレスは面接の招待が送信される先です。
      </Step>

      <Step title="ロールを選ぶ">
        この人を評価する対象の**ロール**を選択します。
      </Step>

      <Step title="保存する">
        保存します。参加者がリストに表示され、スケジュールできる状態になります。
      </Step>
    </Steps>
  </Tab>

  <Tab title="API">
    <Steps>
      <Step title="テンプレートを選ぶ">
        この人がどの `role_id` に対するものかを決めます。
      </Step>

      <Step title="氏名とメールアドレスを入力する">
        この2つは必須です。メールアドレスに招待が届きます。
      </Step>

      <Step title="自分のIDを追加する">
        `external_id` に、自分のシステムでの本人のIDを設定します。後々の手間が省けます。
      </Step>

      <Step title="リクエストを送信する">
        ```bash theme={null}
        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": "jane@example.com",
            "external_id": "greenhouse-8821",
            "role_id": "ce1cd564-...",
            "profile": { "title": "Software Engineer", "experienceLevel": "senior" }
          }'
        ```
      </Step>

      <Step title="IDを保存する">
        レスポンスで参加者の `id` が返されます。これを使ってセッションをスケジュールします。
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Tip>
  大量のリストがありますか？
  [一括インポート](/api-reference/participants/post-participants-bulk)
  エンドポイントを使えば、1回の呼び出しで最大500人を追加できます。
  重複したメールアドレスは自動的にスキップされます。
</Tip>

## ユースケースごとの例

<Tabs>
  <Tab title="採用">
    履歴書つきの、ATS から取り込んだ候補者。

    ```json theme={null}
    {
      "name": "Jane Smith",
      "email": "jane@example.com",
      "external_id": "greenhouse-8821",
      "role_id": "ce1cd564-...",
      "profile": { "title": "Software Engineer", "experienceLevel": "senior" },
      "resume_url": "https://.../jane-resume.pdf",
      "tags": ["senior", "backend"]
    }
    ```
  </Tab>

  <Tab title="トレーニング">
    スキルを学習中の従業員。IDは人事レコードです。

    ```json theme={null}
    {
      "name": "Carlos Reyes",
      "email": "carlos@yourco.com",
      "external_id": "workday-44120",
      "role_id": "ce1cd564-...",
      "profile": { "title": "Account Executive", "organization": "West Region" },
      "tags": ["q3-cohort"]
    }
    ```
  </Tab>

  <Tab title="模擬面接">
    練習中の学生。情報は最小限に。挨拶できる程度で十分です。

    ```json theme={null}
    {
      "name": "Priya Patel",
      "email": "priya@student.edu",
      "external_id": "user_98213",
      "role_id": "ce1cd564-...",
      "profile": { "title": "New Grad", "experienceLevel": "entry" }
    }
    ```
  </Tab>
</Tabs>

## 次のステップ

<CardGroup cols={2}>
  <Card title="セッション" icon="message-circle" href="/jp/concepts/sessions">
    参加者のために実際の面接を予約します。
  </Card>

  <Card title="参加者を作成する（API）" icon="terminal" href="/api-reference/participants/post-participants">
    エンドポイントの完全なリファレンス。
  </Card>
</CardGroup>