ナビゲーションにスキップ
インテグレーションセットアップガイドフィールドサービス

JobNimbus

Webhookツールを使って、新しい発信者をリードとしてJobNimbusに追加します。

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

始める前に

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

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

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

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

ツールを作成する

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

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

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

Enable を選択し、屋根の点検を希望する新規発信者として受付担当をテストします。連絡先がJobNimbusのリードステータスに表示されます。

発信者を追加する前に完全な住所を確認するよう受付担当に指示する 手順を追加してください。

制限事項

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

メールアドレスで発信者を検索し、その連絡先にリンクされたジョブを作成するには、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 では連絡先を作成できません。作成権限を持つプロフィールで新しいキーを作成してください。
連絡先に住所がないツールの説明で、発信者を追加する前に完全な住所を尋ねるよう受付担当に指示してください。