Trimoji API Soft Skills
このAPIを使用すると、Trimojiの性格評価機能を、採用プラットフォームやワークフローに直接統合できます。
Trimojiは、採用担当者向けの性格分析ソリューションです。候補者にアンケートを送信でき、その結果（PDFおよびWeb）が生成されます。主な機能は「Personi」で、これはポジションに最適なプロフィールを表します。候補者のプロフィールをPersoniと比較して、0から100の適合スコアを取得できます。
アクセストークン
すべてのAPIリクエストは、Authorizationヘッダーのpartner_tokenを介して認証される必要があります。
ほとんどのリクエストでは、Trimojiの顧客アカウントを特定するcustomer_tokenもリクエストボディに含める必要があります。
| 変数 | タイプ | 説明 |
|---|---|---|
base_url | 文字列 | https://integration.trimoji.fr/api/v1/softskills |
partner_token | 文字列 | あなたのユニークなパートナーキー。 |
customer_token | 文字列 | あなたの顧客のTrimoji APIキー。 |
エンドポイント
1. キャンペーンの取得
顧客が作成したキャンペーン（求人）のリストを取得します。
メソッド： POST /campaigns
リクエストボディ（JSON）：
{
"customer_token": "{{customer_token}}",
"query": "test" (オプション)
}2. Personiキャンペーンの作成
新しいキャンペーンに関連付けられた新しいPersoni（理想的なプロフィール）を作成します。
メソッド： POST /create/campaign
主要パラメータ：
campaign_infos: テスト設定（短、長、結果表示）。job_offer: ポジションの詳細（タイトル、セクター、説明、ミッション）。custom_id: この求人に対するお客様の内部ID。
3. Personi（スタンドアロン）の作成
すぐにキャンペーンに関連付けずに、理想的なプロフィールを作成します。
メソッド： POST /create/personi
4. 候補者への評価の送信
評価プロセスを開始します。候補者用のユニークなリンクを生成します。
メソッド： POST /init
| パラメータ | 説明 |
|---|---|
candidate_email | 必須。候補者のメールアドレス。 |
callback_url | 結果を自動的に受け取るためのWebhook URL。 |
is_trimoji_sending | trueの場合、Trimojiがメールを送信します。それ以外の場合は、リンクの送信をお客様が管理します。 |
Webhook & 結果
テスト完了後、Trimojiはcallback_urlにPOSTリクエストを送信します。内容は以下の通りです。
- score: マッチングスコア（0〜100）。
- grade:
failed、passed、またはexcelled。 - web_report: 完全なWeb分析へのリンク。
- file_urls: PDFへのリンク（概要、面接、オンボーディングなど）。
5. プロセス結果の取得
プロセスIDを使用して、完了した評価の詳細を取得します。
メソッド： GET /profile/:process_id
6. Personiの取得
顧客が作成したすべての理想的なプロフィール（Personi）をリストします。
メソッド： POST /personis
7. プロセスとPersoniのマッチング
すでにテストを完了した候補者を特定のポジションプロフィールと比較し、新しいスコアを取得します。
メソッド： POST /matching
{
"process_id": "ID_CANDIDATE_TEST",
"personi_id": "ID_IDEAL_PROFILE"
}