> ## 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.

# 面接ウィジェットを埋め込む

> 候補者が自社ドメインを離れることなく intervyo.ai の面接を受けられるようにします。

埋め込みウィジェットは、自社の製品ページや求人ページの中で intervyo.ai の面接を実行します。ブランディングもドメインも自社のものです。結果は [Webhook](/jp/concepts/webhooks) 経由でバックエンドに返されます。

このフローは 3 つの部分で構成されます。アカウント用の一度きりの **埋め込みトークン**、ページに配置するスニペット、そして候補者が開始したときに参加者を作成する **register** 呼び出しです。

<Steps>
  <Step title="埋め込みトークンを生成する">
    ダッシュボードで **Developer → Embed** に移動し、埋め込みシークレットとトークンを生成します。このトークンは候補者ごとではなく **アカウント単位** です（アカウントの埋め込みシークレットで署名されます）。そのため、一度発行すれば再利用できます。

    代わりに、サインイン済みのセッションからプログラムで生成するには：

    ```bash theme={null}
    curl -X POST "https://www.intervyo.ai/api/embed-config/token" \
      -H "Content-Type: application/json" \
      -d '{ "accountSlug": "your-team-slug" }'
    # → { "token": "<embed-token>" }
    ```

    <Warning>
      埋め込みトークンは、アカウントに対する参加者登録を承認するものです。埋め込み **シークレット** はサーバー側に保管してください。発行済みのトークンを無効化するには、ダッシュボードからローテーションします。
    </Warning>
  </Step>

  <Step title="候補者を登録する">
    候補者が開始したら、テンプレート（またはプログラム）に対して候補者を登録します。これにより参加者が作成され、読み込むべき面接が返されます：

    ```bash theme={null}
    curl -X POST "https://www.intervyo.ai/api/embed/register" \
      -H "Content-Type: application/json" \
      -d '{
        "accountSlug": "your-team-slug",
        "accountId": "<account-uuid>",
        "templateId": "ce1cd564-...",
        "name": "Ada Lovelace",
        "email": "ada@example.com",
        "token": "<embed-token>"
      }'
    ```

    `templateId` または `programId` のいずれか一方のみを指定してください。
  </Step>

  <Step title="スニペットを配置する">
    候補者が面接を受けるページにウィジェットをマウントします：

    ```html theme={null}
    <div id="intervyo-root"></div>
    <script async src="https://cdn.intervyo.ai/widget.js"
            data-token="EMBED_TOKEN_HERE"
            data-mount="#intervyo-root"></script>
    ```

    ウィジェットは、マイクの権限、音声のセットアップ、通話終了時のクリーンアップを処理します。
  </Step>

  <Step title="結果を受け取る">
    ウィジェットはブラウザにスコアを送信しません。[Webhook](/jp/concepts/webhooks) エンドポイントで `session.completed` / `session.scored` を待ち受け、スコアカードを必要な場所にルーティングしてください。
  </Step>
</Steps>

<Note>
  埋め込みウィジェットは現在展開中です。本番用のスニペット URL や、ご利用のスタックに合わせた完全な連携ガイドについては、[お問い合わせ](https://intervyo.ai/contact)ください。
</Note>