| 発表日 | ロールアウト開始日 | ロールアウト終了日 |
| 2025年4月3日 | 2025年4月3日 | 2025年4月11日 |
本日、User Identities APIに2つの新しいプロパティが追加されました。これにより、ユーザーが自分のメールアドレスを検証したかどうか（検証方法や検証日時など）を確認できるようになります。このアップデートにより、メールアドレスの検証方法を追跡し、そのメールアドレスが信頼できる連絡先かどうか、ユーザーがアクセス可能な連絡先であるかどうかを把握できるようになります。
このお知らせの内容は以下のとおりです。
機能の変更点
User Identities APIにverification_methodとverified_atという2つの新しいプロパティが追加されました。verified_atプロパティは、verification_methodが「full」に更新された日時を返します。その他の値については更新されず、verification_methodが「full」から別の値に変更された場合はクリアされます。どちらのプロパティも読み取り専用で、設定できるのはZendeskだけです。
以下に、verification_methodプロパティの有効な値と、検証後のプロパティ値を示します。
|
verification_methodプロパティ |
説明 |
検証後のプロパティ値 |
|
なし |
メールアドレスがユーザーのプロフィールに追加されているが、所有権が証明されていない |
verified=false |
|
低 |
エージェントまたはAPIリクエストにより、メールアドレスが検証済みに設定された |
verified=true |
|
SSO |
IDプロバイダー（IdP）が、シングルサインオン（SSO）ログインフローの一部としてメールアドレスを含めている |
verified=true SSOがOpenID Connectを使用して設定されている場合は、email_verifiedクレームで渡された値が優先されます。 |
|
埋め込み |
メールアドレスが、埋め込みWeb WidgetまたはSDKのログインフローの一部としてJWTで渡された（「メッセージングのユーザー認証の設定」を参照） |
verified=true |
|
full |
Zendeskがメール確認フローを直接実行した |
verified=true |
Zendeskがこれらの変更を行う理由
現在、「verified=true」とマークされたUser Identities APIのメールアドレスIDでは、検証用の方法が指定されていないため、検証済みのメールアドレスが信頼できるかアドレスかどうかがわかりません。新しいプロパティを追加したことにより、この問題が解決します。これらのプロパティのメリットは次のとおりです。
- 各メールがどのように検証されたかについて、チームメンバーに確認することも、外部システムで確認することも、Zendeskで直接確認することもできます。これにより、信頼できるメールアドレスかどうかを判断することができます。
- メールアドレスが「full」という検証方法で検証されている場合、ユーザーが実際にそのメールアドレスの受信トレイにアクセスできることを示しています。これにより、安心して相手とやり取りすることができます。
必要な作業
何もする必要はありません。必要に応じて、新しいプロパティを使用することができます。
この発表に関連するフィードバックや質問がある場合は、コミュニティフォーラムにアクセスしてください。このフォーラムでは、カスタマーから寄せられた製品フィードバックを収集し管理しています。Zendesk製品に関する一般的なサポートについては、Zendeskカスタマーサポートにお問い合わせください。