ご利用ガイド

thumbnail

Yahoo!ショッピング

チャネルトークとYahoo!ショッピングを連携しましょう。ストアや商品に関する問い合わせをチャネルトークで対応できます。

Yahoo!ショッピングの問い合わせをチャネルトークで一元管理できます。

  1. [チャネル設定] - [アプリストア] - [Yahoo!ショッピング] を開き、 [インストール] をクリックします。

  1. 連携に必要な内容の入力とYahoo!アカウントの連携が完了したら [保存] ボタンを押します。

①OAuth認証情報:Yahoo!デベロッパーネットワークで発行が必要です。

②アカウントを認証:Yahoo!アカウントと連携します。

③ストア情報:ストアIDを入力します。

④公開鍵の認証:公開鍵と公開鍵のバージョンを入力します。

⑤問い合わせ取得期間:チャネルトークに取り込む未回答の問い合わせを直近何日分まで取得するかを設定します。1日以上30日以下で設定できます。

公開鍵とバージョンは必ず一緒に管理する必要があり、一方だけを入力すると認証ヘッダーを正常に作成できません。公開鍵の有効期限は発行月から1年のため、期限が満了する前に新しい鍵を発行して再度入力する必要があります。

  1. Yahoo!デベロッパーネットワークにアクセスします。

  2. [アプリケーションの管理] を選択します。

  3. [新しいアプリケーションを開発] をクリックします。

  1. アプリケーションの情報を入力します。

  1. アプリケーションを作成後に [アプリケーション情報の編集] で、コールバックURLを追加します。

    • https://app-store-api.channel.io/public/v1/oauth/callback

      を登録してください。

  1. ショッピングAPIの導入ページを開きます。

  2. ページの記載通りに登録を進めます。

  3. 「3.【任意】注文・問い合わせ管理・定期購入API利用申請を行う。」にあるショッピングAPI利用申請フォームをクリックします。

  4. 先に作成したアプリケーションIDなどを入力して申請します。

    • APIのリクエスト元IPアドレスには 3.38.119.225 を入力してください。

連携に必要な情報をストアクリエイターProでコピーします。

  1. [設定] - [暗号鍵管理] をクリックします。

  1. [公開鍵発行] を押して公開鍵を発行します。

  2. 発行後、左上にある [Web APIを利用する] にチェックを付け、公開鍵の横にある [コピー] を押してPEM形式の公開鍵をコピーしてチャネルトークの連携画面に貼り付けます。

  1. 公開鍵のバージョンを確認し、チャネルトークの連携画面に入力します。

  2. 公開鍵は [有効] に設定してください。

顧客がYahoo!ショッピングの問い合わせフォームから問い合わせをすると、チャネルトークに問い合わせが流入します。

このときYahoo!ショッピングから取得できる顧客情報はマスキングされた顧客識別IDのみです。顧客のYahoo!アカウントの情報は連携されません。

  • メッセージの送受信は5分ごとに実施されます。

  • ストアクリエイターProで返信した内容はチャネルトークに反映されません。

チャネルトークで返信をすると、顧客のYahoo!ショッピングのトーク履歴で確認できます。

チャネルトークで送信したメッセージの上にあるチャネルのロゴにマウスを合わせると、メッセージを送信したオペレーターのアイコンと名前が表示されます。

Yahoo!ショッピングから取り込んだメッセージへの返信は、Yahoo!ショッピング側の最新状態を確認してから送信されます。確認に失敗した場合や新しいメッセージが届いていた場合は、古い内容が誤って送信されないように送信を保留します。

外部メッセンジャーにメッセージを送信するは自動的にチャネル名とロゴが適用されます。この設定は変更できません。

チャネルトークで問い合わせを終了した後に顧客がメッセージを送信すると、問い合わせがすでに終了しているため、新しい問い合わせで連絡する必要があると案内するメッセージが自動で送信されます。

問い合わせ終了後に顧客が送信したメッセージは、チャネルトークに反映されません。

Yahoo!ショッピングの問い合わせの取得が繰り返し失敗した場合、チャネルに通知が届きます。通知が届いた場合は連携設定(ストアアカウントID、公開鍵、バージョン、Yahoo!連携の有効期限)を確認してください。

ALFタスクの「関数」ステップでYahoo! ショッピングアプリを活用し、ALFが顧客の問い合わせに自動で応対することができます。

関数の詳しい内容は、アプリ内の右側にある [開発者ツール] をクリックし、[基本関数] から確認できます。

getOrderInfo

  • 注文IDで単一注文の詳細(注文状態、金額、明細、入金/出荷/決済状態、配送方法など)を取得します。

listOrder

  • 期間や注文IDなどの条件で注文一覧を検索します。

getOderCount

  • 状態別の件数を取得します。(ダッシュボード補助)

getOrderChangeHistory

  • 注文の変更履歴を取得します。

注意事項

  • 書き込み系は実データを即時更新します。実行前に顧客に同意を取るステップを必ず挟んでください。

  • 出荷済、取消済の注文への取消/配送先/変更内容変更は、実行前に自動で拒否されて理由が返却されます。

cancelOrder :取消

returnOrder :返品

changeOrderStatus :状態変更

changeShippingAddress :配送先変更

changeShipStatus :出荷状態

changePayStatus :入金状態

changeOrder :内容変更

公開鍵を連携しなくともAPIを使用することはできますが、問い合わせ一覧・詳細・メッセージ投稿APIのような公開鍵認証が対象となるAPIを呼び出すと、Yahoo! ID連携トークンの有効期限が最大12時間に短くなる可能性があります。公開鍵認証をしておくと、一般的なYahoo! ID連携の有効期限である最大4週間は連携を維持できます。