> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# JobNimbus

以下の[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)を使うと、受付担当は新しい発信者を電話番号、住所、依頼内容とともにリードワークフローの連絡先としてJobNimbusに追加でき、チームがフォローアップできます。

## 始める前に

1. JobNimbusで右上にあるプロフィールアイコンを選択し、**Settings** → **API** の順に移動して、新しいAPIキーを作成します。
2. 連絡先を作成でき、必要以上の権限を持たない **Access Profile** を選択します。キーには、作成時点でそのプロフィールに付与されていた権限が保持されます。
3. **Key ID** ではなく、完全なAPIキーをコピーします。JobNimbusで表示されるのは一度だけです。

このツールは、`Authorization` リクエストヘッダーでキーを `Bearer YOUR_API_KEY` として送信します。

> **Warning**
>
> APIキーを使うとJobNimbusのデータにアクセスできます。安全に保管し、共有しないでください。新しいキーの
> 有効期限は1年のため、期限が切れる前に代わりのキーを作成してください。

また、新しいリードを登録する連絡先ワークフローとステータスについて、JobNimbusの設定に表示される正確な名前も必要です（例：`Customer` と `Lead`）。

## ツールを作成する

**Integrations** に移動し、**Add integration** を選択して **Webhook Tool** を選び、以下のフィールドに入力します。

| フィールド                | 値                                                                                                                                                                                                                                                                                                                                                                                                          |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `create_jobnimbus_contact`                                                                                                                                                                                                                                                                                                                                                                                 |
| **Description**      | 「作業を必要としており、これまで当社を利用したことがない発信者を、新しいリードとしてCRMに追加する。」                                                                                                                                                                                                                                                                                                                                                       |
| **Method**           | POST                                                                                                                                                                                                                                                                                                                                                                                                       |
| **URL**              | `https://app.jobnimbus.com/api1/contacts`                                                                                                                                                                                                                                                                                                                                                                  |
| **Request Headers**  | `Authorization`: `Bearer YOUR_API_KEY`                                                                                                                                                                                                                                                                                                                                                                     |
| **Body Parameters**  | `first_name`（文字列、必須）：「発信者の名。」  `last_name`（文字列、必須）：「発信者の姓。」  `record_type_name`（文字列、必須）：「常に正確な値 `Customer`。」  `status_name`（文字列、必須）：「常に正確な値 `Lead`。」  `mobile_phone`（文字列、必須）：「発信者の電話番号（数字のみ）。」  `email`（文字列）：「発信者が伝えた場合は、そのメールアドレス。」  `address_line1`（文字列）：「作業が必要な場所の住所。」  `city`（文字列）：「その住所の市区町村。」  `state_text`（文字列）：「2文字の州コード。」  `zip`（文字列）：「郵便番号。」  `description`（文字列、必須）：「発信者の依頼内容、対応可能な日時、その他の伝達事項。」 |
| **Assign to agents** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                           |

`Customer` と `Lead` を、ご自身のワークフロー名とステータス名に置き換えてください。

**Enable** を選択し、屋根の点検を希望する新規発信者として[受付担当をテスト](/docs/ja/reception-ai/receptionist/testing)します。連絡先がJobNimbusのリードステータスに表示されます。

> **Tip**
>
> 発信者を追加する前に完全な住所を確認するよう受付担当に指示する
> [手順](/docs/ja/reception-ai/receptionist/rules-and-procedures)を追加してください。

## 制限事項

* JobNimbusの連絡先を検索するにはJSON検索フィルターが必要なため、このツールでは発信者を検索できません。以前に電話をかけた発信者が重複して追加される可能性があります。
* ジョブ、タスク、メモはネストされたフィールドを介して連絡先にリンクしますが、Webhookツールでは送信できません。代わりに、通話の詳細が連絡先の説明に保存されます。

メールアドレスで発信者を検索し、その連絡先にリンクされたジョブを作成するには、[Zapier](/docs/ja/reception-ai/integrations/zapier)を介してJobNimbusの **Find Contact by Email**、**Create Contact**、**Create Job** アクションを使用してください。

## トラブルシューティング

| 問題                        | 確認事項                                                                             |
| ------------------------- | -------------------------------------------------------------------------------- |
| JobNimbusから401または403が返される | ヘッダー値は `Bearer` の後に **Key ID** ではなく完全なAPIキーを指定する必要があります。キーの有効期限が切れていないか確認してください。 |
| ワークフローまたはステータスに関するエラー     | `record_type_name` と `status_name` は、連絡先ワークフローおよびそのいずれかのステータスと完全に一致する必要があります。    |
| 権限に関するメッセージを伴う403         | キーの **Access Profile** では連絡先を作成できません。作成権限を持つプロフィールで新しいキーを作成してください。               |
| 連絡先に住所がない                 | ツールの説明で、発信者を追加する前に完全な住所を尋ねるよう受付担当に指示してください。                                      |