エンドユーザー
このガイドでは、GitLab における Zendesk のエンドユーザーの作成、編集、管理方法について説明します。また、Zendesk のエンドユーザー設定についても扱います。管理者は管理者タスクセクションを確認してください。
技術的な詳細
- デプロイタイプ:
Ad-hoc
エンドユーザーを理解する
エンドユーザーとは
エンドユーザーは、エージェントよりも下位の Zendesk ユーザー区分です。一般公開されているサポートポータルへのアクセスやチケットの提出などができます。エージェント側または Zendesk のバックエンドにはアクセスできません。
エンドユーザーの管理方法
- Zendesk Global: エンドユーザーは Zendesk 内で手動管理されます
- Zendesk US Government: エンドユーザーは Zendesk-Salesforce 同期経由で自動的に同期されます
ユーザーノート
ユーザーノートと詳細は、ユーザープロファイル上にあるカスタム情報を保存する 2 つの個別のテキストフィールドです。
- Notes: エージェントのみが閲覧できる内部情報
- Details: ユーザーに関する追加コンテキスト
両方のフィールドは Zendesk のトリガーを介して、新規チケットに内部ノートとして自動的に投稿されます。
管理者ではない者がユーザーノートの更新を依頼する
ユーザーノートの追加、変更、または削除が必要な場合は、Feature Request の Issue を作成してください(カスタマーサポートオペレーションチームによる手動対応が必要となるため)。
管理者ではない者がエンドユーザーの BAN を依頼する
エンドユーザーを BAN する必要がある場合は、#support_operations Slack チャンネルにユーザーを BAN する必要がある旨を投稿してください。カスタマーサポートオペレーションチームのメンバーから(ダイレクトメッセージで)連絡が入り、対応について協力します。
現在のシステムエンドユーザー設定
以下の設定は、エンドユーザーがどのように登録、認証、サポートポータルとやり取りできるかを制御します。これらの設定はリファレンスとしてここに記載されており、変更されることはまれです。
Zendesk Global の場合
- 誰でもチケットを提出可能
- 有効
- リクエストおよびアップロード API への認証を必須にする
- ユーザーに登録を求める
- ユーザー登録メッセージ
Please fill out this form, and we’ll send you a welcome email to verify your email address and log you in.
- 許可リスト
[email protected] google.com
- ブロックリスト: Zendesk 管理パネルで直接確認 - 機密データを含む
- 有効
- アカウントメール
- アカウントメールに有効な Help Center のリストを含める
- ユーザーウェルカムメール本文:
Welcome to GitLab Support. Please click the link below to create a password and login.
- エージェントまたは管理者によって新規ユーザーが作成された場合にもウェルカムメールを送信する
- メール検証メール本文
We need to verify that you are the owner of this email address. Please follow the link below to verify.
- ユーザーが自分のプロファイルデータを閲覧および編集できるようにする
- 有効
- ユーザーがパスワードを変更できるようにする
- 有効
- ユーザーの電話番号を検証する
- 有効
- ユーザーおよび組織のタグ
- 有効
- ユーザーが複数の組織に所属できるようにする
- 有効
Zendesk US Government の場合
- 誰でもチケットを提出可能
- 有効
- リクエストおよびアップロード API への認証を必須にする
- ユーザーに登録を求める
- ユーザー登録メッセージ
Please fill out this form, and we’ll send you a welcome email so you can verify your email address and sign in.
- 許可リスト
[email protected] google.com
- ブロックリスト: Zendesk 管理パネルで直接確認 - 機密データを含む
- 有効
- アカウントメール
- アカウントメールに有効な Help Center のリストを含める
- ユーザーウェルカムメール本文:
Welcome to GitLab Federal Support. Please click the link below to create a password and sign-in.
- エージェントまたは管理者によって新規ユーザーが作成された場合にもウェルカムメールを送信する
- メール検証メール本文
We need to verify that you are the owner of this email address. Please follow the link below to verify.
- ユーザーが自分のプロファイルデータを閲覧および編集できるようにする
- 有効
- ユーザーがパスワードを変更できるようにする
- 有効
- ユーザーの電話番号を検証する
- 有効
- ユーザーおよび組織のタグ
- 有効
- ユーザーが複数の組織に所属できるようにする
- 有効
管理者タスク
注意
- このセクションのすべての項目は、Zendesk への
Administratorレベルのアクセスが必要です。
エンドユーザーを作成する
警告
- これを手動で行う必要があるケースは極めてまれです。実施する理由を慎重に検討し、すべてのドキュメントを確認した上で代替プロセスを使用すべきかどうかを判断してください。
- エンドユーザーの
Access設定(自分のチケット以外を閲覧する権限)は変更しません。エンドユーザーが組織のチケットを閲覧したい場合は、Shared Organization セットアップを使用する必要があります。
Zendesk でエンドユーザーを作成するには:
- ページの左上にある
+ Addにカーソルを合わせる(管理パネル上にいないとき) UserをクリックNameを入力Emailを入力User typeがEnd userになっていることを確認Addをクリック
エンドユーザーを編集する
警告
- 組織との関連付けについては、組織関連付けドキュメントを参照してください。
デフォルトでは、エンドユーザーの編集は行いません。代わりに、サポートポータル自体を使って自身で行うよう推奨します。
ただし、エンドユーザーを編集する非常に特殊な状況もあります。
確認メールの再送信
警告
- これは未確認のメールアドレスに対してのみ実行できます。一度確認されると、そのアドレスに確認メールを再送信することはできません。
ユーザーが未確認のエンドユーザーアカウントで確認メールの再送信を必要としている場合(つまりアカウント上のメールアドレスをまだ確認していない場合)、以下の手順で再送できます。
- Zendesk でエンドユーザーのページに移動
- 確認メールを再送信したいメールアドレスの横にあるドロップダウンキャレットをクリック
Resend verification emailをクリック
パスワードリセットメールを送信する
エンドユーザーにパスワードリセットメールを送信するには:
- Zendesk でエンドユーザーのページに移動
Security settingsタブをクリックResetリンクをクリック- 使用するブランドを選択
- Zendesk Global の場合:
GitLab Support - Zendesk US Government の場合:
GitLab
- Zendesk Global の場合:
Reset passwordをクリック
セカンダリメールの追加または削除
警告
- 別のアカウントで使用中のメールアドレスの場合は実行できません
エンドユーザーにセカンダリメールを追加するには:
- Zendesk でエンドユーザーのページに移動
- ページ左側(
Primary email属性の下)の+ add contactをクリック Emailをクリック- セカンダリメールアドレスを入力(Enter/Return キーを押す)
セカンダリメールをプライマリに設定する
Zendesk でセカンダリメールアドレスをプライマリメールに設定するには:
- Zendesk でエンドユーザーのページに移動
- プライマリにしたいメールアドレスの横にあるドロップダウンキャレットをクリック
Make primary contactをクリック
ユーザーノートを管理する
エンドユーザーのユーザーノート(または詳細)を変更するには:
- Zendesk でエンドユーザーのページに移動
- 変更したいテキストエリア(
NotesまたはDetails)をクリック - 必要に応じてテキストを変更
- テキストエリア外の任意の場所をクリック
エンドユーザーをサスペンドする
ユーザーをサスペンドするには:
- Zendesk でエンドユーザーのページに移動
- ユーザーページの
+ New ticketの右にあるドロップダウンキャレットをクリック Suspendをクリック- 理由が
Other reasonであることを確認 Additional commentが空欄であることを確認Suspend userをクリック
エンドユーザーを削除する
エンドユーザーの削除は、主に 3 つの異なるソースから発生します。
エンドユーザーからの依頼による
これは、エンドユーザーがサポートポータルアカウントの削除を求めるチケットを提出した場合に発生します。プロセスは次のとおりです。
- チケット内でマクロ
Support::Support-Ops::Confirm Deletionをエンドユーザーに送信 - エンドユーザーが削除を確認する返信をした場合、チケット内でマクロ
Support::Support-Ops::Deletion Forthcomingをエンドユーザーに送信 - Zendesk でエンドユーザーのページに移動
- ユーザーページの
+ New ticketの右にあるドロップダウンキャレットをクリック Deleteをクリック- ポップアップ表示された
Confirmをクリック
データプライバシー要求による
これは、ユーザーがデータプライバシー削除を要求したときに(Transcend を経由して)発生します。システムからその旨の通知が届くはずです。まずユーザーが Zendesk に存在するかを確認します。存在する場合は、以下の手順でエンドユーザーを削除します。
- Zendesk でエンドユーザーのページに移動
- ユーザーページの
+ New ticketの右にあるドロップダウンキャレットをクリック Deleteをクリック- ポップアップ表示された
Confirmをクリック
スケジュールされた削除による
ユーザー削除の詳細については、自動ユーザー削除に関するドキュメントを参照してください。
コンプライアンスレベルの削除
コンプライアンスレベルの削除の詳細については、自動ユーザー削除に関するドキュメントを参照してください。
エンドユーザーを BAN する
危険
- これは複数のチームの関与を必要とする深刻な問題であることが多いです。サポートポータル以上の範囲でユーザーを BAN する必要があるかを確認し、必要に応じて関連チーム(セキュリティ、法務、フルフィルメント、課金など)と協力してください。
エンドユーザーを BAN する必要がある場合(さまざまな理由がありますが、特に不正行為によるもの)、誰かが #support_operations チャンネルにその件について投稿します。
その投稿に対して反応し、詳細を確認するためにダイレクトメッセージを送ります。
すべての詳細を確認したら、以下を行います。
クローズされていないチケットをすべてクローズ(必要な場合)
- Zendesk Global の場合(
TICKET_IDをチケットの ID に、API_TOKENを自身の API トークンに置き換える):
curl -ss -X PUT https://gitlab.zendesk.com/api/v2/tickets/TICKET_ID \ -H "Content-Type: application/json" \ -d '{"ticket": {"status": "closed"}}' \ -u [email protected]/token:API_TOKEN- Zendesk US Government の場合(
TICKET_IDをチケットの ID に、API_TOKENを自身の API トークンに置き換える):
curl -ss -X PUT https://gitlab-federal-support.zendesk.com/api/v2/tickets/TICKET_ID \ -H "Content-Type: application/json" \ -d '{"ticket": {"status": "closed"}}' \ -u [email protected]/token:API_TOKEN- Zendesk Global の場合(
エンドユーザーのノートを変更し、BAN に関する情報(BAN されたという表明、理由、詳細を確認したい場合の連絡先)を追加します。次のような内容が適しています。
This user has been banned from the support portal as of YYYY-MM-DD by request of TEAM_NAME team.
This was due to REASON.
If more details are needed, please reach out to the Customer Support Operations team via the #support_operations Slack channel.
- 置き換え:
YYYY-MM-DDを現在の日付(ISO フォーマット)にTEAM_NAMEを BAN を要求しているチームの名前(例: Support、Security、Legal など)にREASONを理由に(関連チケットが理由の一部である場合は、メッセージに必ず含めてください)
- 置き換え:
システムエンドユーザー設定を変更する。具体的には
Blocklist設定にreject:EMAIL_ADDRESSを追加します(EMAIL_ADDRESSをエンドユーザーのメールアドレスに置き換える)。
すべて完了したら、元の依頼投稿でエンドユーザーが BAN されたことを確認します。
エンドユーザーの BAN を解除する
これは発生することが非常にまれで、おそらく非常にカスタマイズされたプロセスを要します。フルスタックエンジニアに状況を引き継いで対応してもらってください。
システムエンドユーザー設定を変更する
危険
- サポートポータルの使い勝手に大きな影響を与える可能性があるため、極めて慎重に実行してください。
- これは以下の 2 つのシナリオでのみ実行する必要があります:
- エンドユーザーを BAN する
- 対応する依頼 Issue(Feature Request、Administrative、Bug など)が存在する
- システムエンドユーザー設定を変更した場合は、必ずこのページの現在のシステムエンドユーザー設定を更新してください
システムエンドユーザー設定を変更するには:
- Zendesk インスタンスの管理ダッシュボードに移動
People > Configuration > End usersに移動- 変更したい設定を修正
- ページの右下にある
Save tabをクリック
よくある問題とトラブルシューティング
これは必要に応じて項目が追加されていく、生きたセクションです。
bfd74782)