チケットを作成

このピースでできること

• Zendeskで新しいチケットを作成します。

• 件名や本文、依頼者、担当者、優先度、タグ、カスタムフィールドなどをまとめて登録できます。

Zendeskの接続方法

1. ZendeskのAPIトークンの取得

• Zendeskの管理センターのサイドバーからから「アプリおよびインテグレーション」>「APIトークン」を選択します。APIトークンアクセスがオフになっています」と表示が出た場合は「トークンアクセス設定を表示」をクリックします。

• 「APIトークンアクセスを許可」にチェックを入れて右下の「保存」ボタンを押します。

• 「APIトークンを追加」を押します。

• APIトークンの名前などを入力して右下の「保存」を押すとAPIトークンが表示されます。二度と表示されないものなのでどこかにメモをしておいてください。

2. 接続を作成

• 接続から「接続を作成」をクリックします。

3. 接続設定

• 接続名を設定して、以下の3項目を入力し、「保存」をクリックします。

 

エージェントのメールアドレス	Zendeskにログインするために使用するメールアドレス
トークン	1で取得したAPIトークン。
組織	Zendeskインスタンスのサブドメイン。インスタンスのURLが以下のような場合は青字の部分がサブドメイン。 ex) https://workrun-1111.zendesk.com

 

4. 接続名が設定されていることを確認する

• 接続名が設定されていることを確認します。

ピースの設定項目

1. 件名 subject（任意）

• 作成するチケットの件名をご指定ください。

2. コメント本文 comment_body（任意）

• プレーンテキストの本文です。HTMLを使う場合はcomment_html_bodyを優先します。

3. コメントHTML comment_html_body（任意）

• HTML形式の本文。指定した場合はこちらが優先されます。

4. 依頼者メール requester_email（任意）

• チケット依頼者のメールです。未指定なら認証ユーザーが依頼者になります。

5. 依頼者名 requester_name（任意）

• 新しいユーザーを同時作成する場合などに使用します。

6. 担当者メール assignee_email（任意）

• 担当させたいエージェントのメールアドレスです。

7. 優先度 priority（任意）

• Low または Normal もしくは High または Urgent を選択します。

8. 種別 type（任意）

• Problem または Incident または Question または Task を選択します。

9. ステータス status（任意）

• New または Open または Pending または Hold または Solved または Closed を選択します。

10. タグ tags（任意）

• 付与するタグの配列を指定します。

11. 組織ID organization_id（任意）

• プルダウンから選択します。

12. グループID group_id（任意）

13. 外部ID external_id（任意）

14. 共同作業者メール collaborator_emails（任意）

15. フォロワーメール follower_emails（任意）

16. 期限 due_at（任意）

• ISO 8601 日時で指定します。

17. カスタムフィールド custom_fields（任意）

• インスタンスのカスタム項目に合わせてJSONで指定します。

18. 公開コメント comment_public（任意）

• 依頼者に公開するかどうかです。既定はtrueです。

19. ブランドID brand_id（任意）

20. フォーラムトピックID forum_topic_id（任意）

21. 問題チケットID problem_id（任意）