ナビゲーションにスキップ

ServiceM8

Webhookツールを使って、通話からServiceM8の見積もりやジョブを作成します。

以下のWebhookツールを使うと、発信者が作業を依頼した際に、受付担当者がServiceM8で見積もりやジョブを作成し、新しい発信者を顧客として追加できます。

始める前に

ServiceM8で Settings → API Keys を開き、キーを作成します。以下のすべてのツールは、X-Api-Key リクエストヘッダーでこのキーを送信します。キーを持つ人は誰でもServiceM8のデータを読み取り、変更できるため、共有ドキュメントには記載しないでください。

ツールを作成する

各ツールについて、Integrations に移動し、Add integration、Webhook Tool の順に選択して、Assign to agents を Receptionist に設定します。

ジョブを作成する

フィールド値
名前create_servicem8_job
説明「発信者が作業を依頼した場合や見積もりを希望した場合に、ジョブを作成する。」
メソッドPOST
URLhttps://api.servicem8.com/api_1.0/job.json
リクエストヘッダーX-Api-Key:APIキー
本文パラメーターstatus(文字列、必須):「常に正確な値 Quote を使用する。」
job_address(文字列、必須):「郵便番号を含む、作業が必要な場所の完全な住所。」
job_description(文字列、必須):「発信者の名前と電話番号に続けて、必要な作業と伝えられた詳細を記載する。」

通話から直接作業を予定に入れる場合は、Quote の代わりに Work Order を使用します。

新しい顧客を追加する

フィールド値
名前create_servicem8_client
説明「これまで利用したことがないと発信者が伝えた場合、新しい顧客として追加する。」
メソッドPOST
URLhttps://api.servicem8.com/api_1.0/company.json
リクエストヘッダーX-Api-Key:APIキー
本文パラメーターname(文字列、必須):「発信者の氏名または会社名。」
address(文字列):「郵便番号を含む顧客の住所。」

各ツールで Enable を選択し、見積もりを依頼して受付担当者をテストします。新しい見積もりがServiceM8に表示されます。

制限事項

  • ServiceM8が両方のツールに返すのは OK のみです。新しいレコードのIDは、受付担当者が読み取れないレスポンスヘッダーに含まれるため、ジョブを顧客にリンクできません。チームがServiceM8でリンクする必要があります。
  • ServiceM8では、電話番号とメールアドレスは顧客の連絡先という別レコードに保存されますが、顧客ツールでは作成できません。代わりに、発信者の電話番号はジョブの説明に保存されます。
  • 既存の顧客を検索するには $filter パラメーターが必要ですが、Webhookツールのパラメーター名には $ を使用できないため、受付担当者は発信者を検索できません。

顧客とジョブをリンクして作成するには、Zapier経由でServiceM8の Create Client アクションと Create Job アクションを使用します。

トラブルシューティング

問題確認事項
ServiceM8から401が返されるヘッダー名が X-Api-Key で、有効なキーが設定されている必要があります。
statusに関する400エラーstatus は Quote、Work Order、Unsuccessful、Completed のいずれかと完全に一致する必要があります。
ジョブに住所がないジョブを作成する前に完全な住所を尋ねるよう、受付担当者への説明に記載してください。
ServiceM8から429が返されるServiceM8のリクエスト上限に達しています。1分待ってからもう一度お試しください。