クイックスタート

Role をセットアップし、候補者を面接へと進め、候補者が面接を終えてからおよそ 2 分以内に採点済みのトランスクリプトを確認します。自分に合った方法を選んでください。

UI で（コード不要）
API で

最速の方法です。API には一切触れたくない採用マネージャー、リクルーター、L&D チーム向けです。

ワークスペースを作成する

intervyo.ai/auth/sign-up でサインアップし、チームを作成します。トライアルは無料で、カードの登録は不要です。

Role を選ぶ

Roles を開き、キャリブレーション済みのスターター（ソフトウェアエンジニア、営業担当者、カスタマーサポートなど）を選ぶか、独自に作成します。 Rolesを参照してください。初めての方は、既成のクックブックのレシピをお試しください。

候補者を参加させる

Participants の下の Add をクリックして直接誰かを招待するか、 Role の公開応募リンクを共有して、応募者自身に応募してもらいます。いずれの場合もメールで本人確認が行われ、AI が面接を実施します。

スコアカードを確認する

セッションが完了すると、評価軸ごとのスコア、推奨判定、トランスクリプト、録画を含む完全なスコアカードが、参加者のプロフィールに表示されます。ログイン不要のリンクを使って、審査メンバーと共有できます。

intervyo.ai を自社製品や ATS に統合する開発者向けです。詳細なウォークスルー：採用のステップバイステップ。

API キーを取得する

ダッシュボードで Developer → API Keys に移動し、participants:write と sessions:write のスコープを持つキーを作成します。認証を参照してください。

環境をセットアップする

export INTERVYO_API_KEY="iv_live_…"
export ROLE_ID="ce1cd564-..."   # from your Roles page
export TEAM_SLUG="your-team-slug"

参加者を作成する

セッションは参加者に属するため、まず参加者を作成します。

curl -X POST "https://www.intervyo.ai/api/v1/participants?accountSlug=$TEAM_SLUG" \
  -H "x-api-key: $INTERVYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ada Lovelace",
    "email": "[email protected]",
    "role_id": "'"$ROLE_ID"'"
  }'

const res = await fetch(
  `https://www.intervyo.ai/api/v1/participants?accountSlug=${process.env.TEAM_SLUG}`,
  {
    method: "POST",
    headers: {
      "x-api-key": process.env.INTERVYO_API_KEY!,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      name: "Ada Lovelace",
      email: "[email protected]",
      role_id: process.env.ROLE_ID,
    }),
  },
);
const { data } = await res.json();
const candidateId = data.id;

import os, requests

res = requests.post(
    "https://www.intervyo.ai/api/v1/participants",
    params={"accountSlug": os.environ["TEAM_SLUG"]},
    headers={"x-api-key": os.environ["INTERVYO_API_KEY"]},
    json={
        "name": "Ada Lovelace",
        "email": "[email protected]",
        "role_id": os.environ["ROLE_ID"],
    },
)
candidate_id = res.json()["data"]["id"]

返された id を candidate_id として保存します。

セッションをスケジュールする

招待メールは自動的に送信されます。

curl -X POST "https://www.intervyo.ai/api/v1/sessions?accountSlug=$TEAM_SLUG" \
  -H "x-api-key: $INTERVYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "candidate_id": "<candidate_id-from-previous-step>",
    "role_id": "'"$ROLE_ID"'",
    "stage": "screen",
    "idempotency_key": "quickstart-ada-screen"
  }'

レスポンスには join_url が含まれます（招待がメール送信されたことも確認できます）。

スコアカードを受け取る

Webhook を設定して、面接終了の瞬間に session.completed を受け取るか、status が completed になるまで GET /api/v1/sessions/{id} をポーリングします。Webhook を強く推奨します。そうしないと、待機時間に上限がなくなります。

いま何が起きたのか

AI があなたのルーブリックを実行した

Interviewer のすべての評価軸が、評価軸ごとの根拠と引用とともに、トランスクリプトに照らしてスコアリングされました。

真正性シグナルを記録した

タブの切り替え、ペースト、音声なりすましのシグナルが、あなたの判断のためにダッシュボードに表示されます。これらが不採用を自動で決めることは決してありません。

録画をアーカイブした

音声とトランスクリプトは、署名付きアクセスを備えた暗号化済み・リージョン対応のバケットに保存されます。保持期間はワークスペースのポリシーに従います。

Webhook を配信した

設定されている場合、あなたのエンドポイントは HMAC 署名付きの完全なスコアカードを含むイベントを受信します。失敗時にはリトライが行われます。

次のステップ： Interviewer で AI が評価する内容を調整するか、2 つ目の Round を追加して、合格時に候補者が自動的に次へ進むようにしましょう。

​いま何が起きたのか

AI があなたのルーブリックを実行した

真正性シグナルを記録した

録画をアーカイブした

Webhook を配信した

いま何が起きたのか