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

BigCommerce

Webhookツールを使って、BigCommerceストアの注文状況に関する質問に回答します。

受付は、発信者の注文をBigCommerceストアで検索し、その状況を案内できます。Webhookツールは、BigCommerce Orders APIを通じて顧客のメールアドレスから注文を検索します。

注文には、顧客の氏名、住所、電話番号、購入内容が含まれます。情報を共有する前に、 発信者がその顧客本人であることを受付が確認する必要があります。以下のツール説明では、 注文番号と注文時のメールアドレスの両方を尋ね、両方が一致した場合にのみ 注文について案内するよう設定します。

はじめる前に

1

読み取り専用APIアカウントを作成する

BigCommerceのコントロールパネルで、Settings → Store-level API accounts を開き、APIアカウントを作成します。「Reception」などの名前を付け、Orders スコープを read-only に設定し、それ以外のすべてのスコープを None に設定します。スコープは後から変更できません。

2

認証情報をコピーする

アカウントを保存し、Access token と API path をコピーします。APIパスは https://api.bigcommerce.com/stores/STORE_HASH/v3/ のような形式で、/stores/ の後の部分がストアハッシュです。アクセストークンは秘密情報として管理してください。

Webhookツールを作成する

Integrations に移動して Add integration を選択し、Webhook Tool を選びます。

フィールド値
Namefind_bigcommerce_order
Description「発信者が注文について尋ねたときに、その注文を検索する。まず注文番号と注文時のメールアドレスを尋ね、メールアドレスは一文字ずつ言ってもらう。注文のidと請求先メールアドレスの両方が発信者の回答と一致する場合にのみ、注文の詳細を共有する。一致しない場合は、注文が見つからないことを伝え、折り返し連絡を提案する。」
MethodGET
URLhttps://api.bigcommerce.com/stores/STORE_HASH/v2/orders
Request HeadersX-Auth-Token:アクセストークン
Accept:application/json
Query Parametersemail(文字列、必須):「発信者が伝えたメールアドレス。」
sort(文字列、必須):「常に正確な値 date_created:desc。」
limit(数値、必須):「常に正確な値 5。」
Assign to agentsReceptionist

sort と limit の値により、古い注文ではなく、顧客の最新の注文から順に返されます。

Enable を選択し、テスト注文を使って受付をテストします。正しい注文番号とメールアドレスで注文について尋ねた後、間違ったメールアドレスでも尋ね、2回目の通話では詳細が案内されないことを確認してください。

レスポンスには、各注文の請求先住所と支払い情報が含まれます。受付が電話で共有してよい情報について、 ルールまたは手順を追加してください。 たとえば、注文状況と注文日のみを共有するよう設定できます。

トラブルシューティング

問題確認事項
BigCommerceが401を返すヘッダー名は X-Auth-Token とし、クライアントIDやクライアントシークレットではなくアクセストークンを指定する必要があります。
BigCommerceが403を返すAPIアカウントに Orders の読み取り専用スコープがありません。このスコープを設定した新しいアカウントを作成してください。
BigCommerceが404を返すURL内のストアハッシュと、URLに /v2/orders が使用されていることを確認してください。
レスポンスが空になるそのメールアドレスに該当する注文がありません。発信者が購入時に使用したメールアドレスを伝えたか確認してください。