COLOR MEアプリストアでチャネルトークアプリを検索します。
COLOR MEにログイン後、アプリを追加します。
料金プランの [選択する] にチェックを入れ、利用規約の同意などにもチェックを入れて [アプリを追加する] をクリックします。
アプリ連携に伴う動作などの同意に全てチェックを入れ、[アプリを連携] をクリックします。
[連携する] ボタンをクリックします。
チャネルトークのアカウントにログインし、COLOR MEサイトに表示するチャネルを選択します。
[スクリプトを設置] をクリックします。
設置が完了するとCOLOR MEサイトにチャネルトークが表示されます。
注意事項
顧客情報は「カートページ」に顧客がアクセスした際にのみ連携されます。
データキー | 内容 |
|---|---|
name | 名前 |
mobileNumber | 携帯番号 |
メールアドレス | |
cartPrice | カート内金額 |
cartCount | カート内商品数 |
zipCode | 郵便番号 |
adress | 住所 |
データキー | 表示名 |
|---|---|
ProductView | 商品詳細ページ閲覧 |
CheckoutBegin | 注文開始 |
CheckoutComplete | 注文完了 |
ALFタスクの「関数」ステップでCOLOR MEアプリを活用し、ALFが顧客の問い合わせに自動で応対することができます。
項目 | 内容 |
|---|---|
identifier.type |
|
identifier.value |
|
searchFilter |
|
limit |
|
searchFilterで使用できる値
orderId：注文番号
memberId：会員ID
email：メール
orderedAt：注文日時
searchFilterで使用できる演算子
$eq
$ne
$in
$startWith
$regex
注意事項
identifierとsearchFilterが両方とも空の場合は空のリストを返します。店舗全体の注文は照会できません。
COLOR MEの仕様上、電話番号では検索できません。
認証の期限切れ、権限不足、呼び出し量の超過、条件形式のエラーもすべて空のリストで応答します。結果が空であっても注文がないという意味ではありません。
次のページへのスキップできません。より多くの件数が必要な場合は
limitを上げてください。
orders の各要素
項目 | 内容 | サンプル値 |
|---|---|---|
id | 注文番号 |
|
title | 表示用注文名 |
|
orderedAt | 注文日時（1970年基準でミリ秒） |
|
buyer.name | 注文者の名前 |
|
buyer.email | 注文者のメール |
|
buyer.phone | 注文者の電話番号 |
|
buyer.memberId | 会員ID （非会員の場合は空になる） |
|
payment の各要素
項目 | 内容 | サンプル値 |
|---|---|---|
state | 決済状況 |
|
currency | 通貨（日本円固定） |
|
totalAmount | 決済金額の合計 （COLOR MEが計算した値） |
|
itemsAmount | 商品金額の合計 |
|
shippingAmount | 送料 |
|
discountAmount | ポイント利用と割引の合計 |
|
totalAmountは、手数料や税金が反映されたCOLOR MEでの最終金額のため、商品価格と送料を合計した金額とは異なる場合があります。
items の各要素
項目 | 内容 | サンプル値 |
|---|---|---|
id | 注文商品の行番号 |
|
name | 注文当時の商品名 |
|
option | 選択したオプション |
|
quantity | 数量 |
|
amount | 単価 （税込価格がある場合は税込） |
|
productId | 商品番号 |
|
imageUrl | 商品画像URL |
|
state | 商品の状態 |
|
claimability | キャンセル・配送先変更の可能有無 | {"cancelable": true, "shippingAddressChangeable": true} |
fullfillments の各要素
項目 | 内容 | サンプル値 |
|---|---|---|
id | 配送先単位の発送番号 |
|
state | 発送状況 |
|
itemIds | 商品行番号の一覧 |
|
送り状番号や配送業者の情報は照会できません。
発送状態のみを確認できます。
shippingAddress の各要素
項目 | 内容 | サンプル値 |
|---|---|---|
lastName | 名前 |
|
zipcode | 郵便番号 |
|
address1 | 住所 |
|
address2 | 建物名など |
|
phoneNumber | 電話番号 |
|
country | 国コード（日本固定） |
|
複数の場所に分けて送る注文の場合でも代表の配送先1つだけが表示されます。
その他は
fullfillmentsで区別します。
項目 | 内容 | サンプル値 |
|---|---|---|
orderId |
|
|
cancelItems |
| - |
注意事項
COLOR MEは部分キャンセルをサポートしていません。一部の商品や数量を指定して入力すると実行しません。
すでにキャンセルさsれた注文に再度リクエストすると「成功」を返します。
返金口座の指定、返品、交換はサポートしていません。
成功
注文なし
部分キャンセルリクエスト
項目 | 内容 | サンプル値 |
|---|---|---|
orderId | 注文番号（数字のみ） |
|
newAddress.province | 都道府県 |
|
newAddress.address1 | 市区町村＋以下住所 |
|
newAddress.address2 | 建物名 |
|
newAddress.zipcode | 郵便番号 |
|
newAddress.lastName, firstName | 名前 |
|
newAddress.phoneNumber | 携帯番号 |
|
注意事項
都道府県は「東京」のように省略して書くと受理できません。「東京都」のように正式名称で記載してください。
キャンセルされた注文やすでに発送された注文は変更できません。
複数の場所に分けて発送する注文の場合、代表配送先が1ヶ所のみ変更されます。
成功
注文なし
配送完了注文の配送先変更を試行