Ｕdeskフィードバックタブ

Udeskフィードバックタブは、サードパーティシステムに埋め込むためのものです。サードパーティシステムは、フィードバックタブ送信インターフェースにパラメータを追加することで、顧客情報の変更/追加やチケット情報の生成を行うことができます。

基本的な使い方

埋め込みコード例

<body>
    <!-- ウェブページの内容 具体的なコードは管理センターのチャネル管理フィードバックタブからコピーしてください -->

    <script src="xxxx://xxxx.xxx.cn/im_client/js/udesk_feedback.js"></script>
    <style type="text/css" media="screen, projection">
        @import url(xxxx://xxxx.xxx.cn/im_client/css/udesk_feedback.css);
    </style>

    <script type="text/javascript">
        if ("undefined" !== typeof(UdeskFeedback)) {
            UdeskFeedback.init({
                url: "xxxx://xxxx.xxxx.cn",
                mode: "knowledge_search",
                color: "rgb(175, 56, 56)",
                title: "フィードバックタブ",
                position: "right",
                "u_customer_token": "abcdefghijklmn",
                "u_nick_name": "顧客名tom",
                "u_email": "test@udesk.cn",
                "u_cellphone": "187xxxxxxxx",
                "u_organization": "Udesk",
                "u_description": "簡単な説明",
                "u_customer_tags": "vip",
                "u_owner_id": "3",
                "u_owner_group_id": "62",
                "u_TextField_xxx": "",
                "u_SelectField_xx": "",
                "u_subject": "フィードバック件名",
                "u_content": "フィードバック内容",
                "u_status_id": "3",
                "u_priority_id": "2",
                "u_company_tags": "",
                "u_nonce":"694db2645b3f69a8",
                "u_signature":"315345C77C73A128CF9850EAD777F7A71D423A36",
                "u_timestamp":"1465878579000",
                "u_email":"feedback@udesk.cn"
            });
        }
    </script>
</body>

リンク例

http://rd-dota.udesk.cn/im_client/feedback_tab/new.html?u_nick_name=顧客名tom&u_cellphone=187xxxxxxxx&u_organization=Udesk&u_customer_tags=vip&u_owner_id=3&u_owner_group_id=62&u_TextField_xxx=&u_SelectField_xx=&u_subject=フィードバック件名&u_content=フィードバック内容&u_status_id=3&u_priority_id=2&u_company_tags=&u_nonce=694db2645b3f69a8&u_signature=315345C77C73A128CF9850EAD777F7A71D423A36&u_timestamp=1465878579000&u_customer_token=abcdefghijklmn&u_email=feedback@udesk.cn&u_description=簡単な説明&

顧客認証 - リクエストパラメータ

customer_token、顧客メールアドレス、または電話番号を渡すと、既存の顧客としてログインしているとみなされ、顧客認証が行われます。訪問者の場合は顧客認証は不要です。顧客の場合は、以下の暗号化アルゴリズムを参照してください。顧客識別の優先順位は次のとおりです：u_customer_token -> u_email -> u_cellphone。顧客識別の有効時間：1時間。

認証パラメータ

パラメータ名 タイプ 値 必須 説明
u_nonce String ランダム値 はい ランダム値、動的なランダム値はセキュリティ係数が高い
u_timestamp String タイムスタンプ はい 現在のタイムスタンプ(13桁ミリ秒)
u_customer_token/u_email/u_cellphone String 顧客ID はい 顧客の一意識別子、customer_token、メールアドレス、または電話番号を使用
u_signature String 暗号化アルゴリズム はい signature暗号化アルゴリズム

signature暗号化アルゴリズム

  1. 以下のパラメータと順序で文字列を連結し、key=value&の形式にします：u_nonce, u_timestamp, u_customer_token(u_email(u_cellphone)), im_user_key.

im_user_keyの取得場所【管理センター-インスタントメッセージング-ウェブプラグイン-管理/顧客情報追加のKEY】

sign_str = u_nonce=value&u_timestamp=valuie&u_customer_token/u_email/u_cellphone=value&im_user_key

  1. sha1を使用して署名文字列を計算します

sign_str = sha1(sign_str)

  1. 文字列を大文字に変換します

sign_str = sign_str.toUpperCase()

例
    sign_str = "u_nonce=9ca6fff5a509fb887ac72cf5c92010e7&u_timestamp=1455675719000&u_email=feedback@udesk.cn&b476f9f8-5309-4d0a-a2d4-af08c4507a15";
    sign_str = sha1(sign_str);
    sign_str = sign_str.toUpperCase();

パラメータ渡しの例

{
  "u_nonce":"694db2645b3f69a8",
  "u_signature":"315345C77C73A128CF9850EAD777F7A71D423A36",
  "u_timestamp":"1465878579000",
  "u_email":"feedback@udesk.cn"
}

顧客パラメータ

パラメータ名 タイプ 値 必須 説明
u_customer_token String 認証token いいえ
u_email String 顧客メールアドレス いいえ
u_cellphone String 顧客電話番号 いいえ
u_description String 顧客説明 いいえ
u_organization String 顧客会社 いいえ
u_owner_id String 顧客担当者ID いいえ
u_owner_group_id String 顧客担当グループID いいえ
u_customer_tags String 顧客タグ いいえ チケットタグを渡す、カンマ区切り 例："xx,xx"
u_SelectField_xxx String 顧客カスタムフィールド いいえ 顧客カスタムフィールドの一意識別子、カスタムフィールドで確認可能
### チケットパラメータ
パラメータ名 タイプ 値 必須 説明
u_subject String チケット件名 いいえ
u_content String チケット内容 いいえ
u_status_id String チケットステータスID いいえ
u_priority_id String チケット優先度ID いいえ
u_company_tags String チケットタグ いいえ チケットタグを入力し、カンマで区切ります。例："xx,xx"
u_TextField_xxx String カスタムフィールド いいえ カスタムフィールドの一意識別子。カスタムフィールド設定で確認できます。

ご利用上の注意

  1. ユーザーがカスタマイズするリクエストパラメータは、予約済みパラメータとの重複を避けるため、u_ で始めないでください。

  2. URLパラメータとフォームパラメータ（カスタムパラメータ）が競合する場合、システムはURLに事前設定されたパラメータを優先します。

  3. フィードバックタグフォーム設定において、「チケットテンプレート」オプションは、チケット生成後にデフォルトで表示されるテンプレートを決定します。実際のパラメータ入力時には、他のテンプレートのカスタムフィールドを入力することができます。