あります。Zendeskの公式サイトに、API経由で登録する方法が掲載されています。
▼参考:Zendesk公式サイト(下記リンクを『Ctrl』+クリック)
Articles | Zendesk Developer Docs
【事前準備】 下記①~⑤の内容は、この後の作業で必要になるため、メモ帳に貼り付けておくことでコピペ利用できる。
①サブドメイン
画面右上メニューより「管理センター」→下図に表示される
②requester_id
画面右上メニューより「管理センター」→画面の左側メニューより「メンバー」→「チームメンバー」→メンバー選択すると、
下図URLのmembers/の後ろに表示される
③APIトークン
画面の左側メニューより「アプリおよびインテグレーション」→「APIトークン」→「APIトークンを追加」
「説明」にはわかりやすい内容を入力し、画面右下の『保存』をクリックすると「トークン」が発行される
④プロキシ
「スタート」→「設定」→「ネットワークとインターネット」→「プロキシ」
⑤メールアドレス
OutlookやTeamsから確認
⑥セクションID
画面の左側メニューより「コンテンツを配置」→「記事を配置」→記事を配置したいセクション選択すると、
下図URLのcategories/の後ろに表示される
⑦permission_group_id
画面右上メニュー「ナレッジベースの管理者」→画面の左側メニューより「ユーザー権限(人のマークに鍵)」→「管理権限」選択
②permission_group_idの確認
管理権限に表示されたパーミッショングループをクリックするとURL(permissions/の後ろ)に表示される
■ナレッジをZendeskに登録する:articles コマンドを利用
①Zendesk Developersページの左側メニューより「Articles」をクリック
②Zendesk Developersページの中央よりcurlのCode Sampleをコピー
③メモ帳などに貼り付け
curl https://{subdomain}.zendesk.com/api/v2/help_center/articles \
-v -u {email_address}/token:{api_token}
④ブランク、改行、\を削除し、以下のように整形(コマンドを1行にする)
curl https://{subdomain}.zendesk.com/api/v2/help_center/articles -v -u {email_address}/token:{api_token}
⑤https://{subdomain}を削除する
curl .zendesk.com/api/v2/help_center/articles -v -u {email_address}/token:{api_token}
⑥curl の後ろに、-x とプロキシとサブドメインの記述を追記する。
(例:-x http://10.254.3.30:8080/ https://medigital-m-xtech)
curl -x http://10.254.3.30:8080/ https://mdstest.zendesk.com/api/v2/help_center/articles -v -u {email_address}/token:{api_token}
⑦ -v -u {email_address}/token:{api_token} を削除する
curl https://{subdomain}.zendesk.com/api/v2/help_center/articles -v -u
⑧-v -u の後ろに、登録者のメールアドレスとAPIトークンを記述する
curl -x http://10.254.3.30:8080/ https://mdstest.zendesk.com/api/v2/help_center/articles -v -u Test.Test@yd.MitsubishiElectric.co.jp/token:testtest-------aaaaabbbb
⑨コマンドをコマンドプロンプトに貼り付けて実行
実行結果が表示されたら、 {"count" 部分から } 部分までをコピーする(下図の赤枠内をコピー)
⑩コピーした内容をJSON形式に変換し、内容を確認する。
JSONの構文を理解するために、変換ツールやサイトを利用して、正しい構文から編集して利用する。
▼参考:JSON形式への変換サイト(下記リンクを『Ctrl』+クリック)
JSONきれい ~JSON整形ツール~ - instant tools
⑪ナレッジは、curlコマンドで複数登録ができないため、手順⑩で整形後は、{ から } で1件となるため
1件単位に区切って、{ の前に、"article": をつけて、保存するようにする。(登録件数分のファイル数になる)
(保存した後に、"article": をつけても構わない。)
⑫以下のサンプルのような形式にすればよいため、 "title":と "body":は必ず入れる。
("title": 件名や質問 "body": 回答 を入力)
"locale"以降は定型文のようなものなので、そのまま他のファイルにも利用できる。
"permission_group_id"と"section_id"は事前に準備したものを入力する。
【参考】サンプルのjsonファイル(拡張子:.json、メモ帳などで開く)
{
"article": {
"title": "■Zendesk APIを使ってナレッジを登録する方法はありますか?",
"body": "あります。Zendeskの公式サイトに、API経由で登録する方法が掲載されています。",
"locale": "ja",
"user_segment_id": null,
"permission_group_id": 1234567890,
"section_id": 1234567890,
"draft": false
},
"notify_subscribers": false
}
【補足】
・移行データが大量にある場合は、セクション単位に登録をしたほうがいい
(セクション単位に実施しないとセクションへの手動の移動に手間、時間がかかる)
・少量の場合は登録後に手動で移動でも時間はかからない
以上
コメント
0件のコメント
サインインしてコメントを残してください。