メインコンテンツにスキップ

Fin Messenger:Zendesk設定

Fin MessengerでFinを設定・カスタマイズし、会話をZendeskに引き継ぐ方法。

Fin MessengerをZendeskと連携し、ワークフローをカスタマイズし、会話の引き継ぎ方法を管理する方法を学びましょう。


Fin MessengerをZendeskと連携する

OAuthを使ってZendeskに接続する

OAuthはFinとZendeskを接続する主要な方法です。OAuthによりAPIトークンの手動管理が不要になり、Zendeskの変更にも継続的に対応できます。

  1. Connectにアクセスしてください。

  2. Connect to Zendeskの下で、Connect to Zendeskを選択します。

  3. OAuthを使ってZendeskにサインインし、アクセスを承認します。

  4. Finに戻り、接続がConnectedと表示されていることを確認します。

注意:ZendeskはAPIトークン認証を廃止しています。新規のお客様はすべてOAuthを使ってFinをZendeskに接続する必要があります。

  • 新規非契約顧客:OAuthが必須です。

  • 新規契約顧客:ワークスペースで有効化されるとOAuthが必須です。

  • 既存顧客:APIトークン接続は引き続き動作しますが、切断された場合はOAuthで再接続する必要があります。OAuthが有効になるまで永続的なバナーが表示されます。

Zendesk Sunshineに接続する

ワークフローにHand-off to Zendesk agentが含まれる場合、Zendesk Sunshineにも接続する必要があります。Zendesk Sunshineの認証情報はキー方式のままで、OAuthは置き換えません。

Zendesk管理センター > Apps & Integrations > Zendesk Sunshineから以下の情報を提供してください:

  • App ID

  • Key ID

  • Secret Key

上記すべてをコピーしたら、Connect.を選択します。

注意:Zendesk Chat APIはZendesk Sunshineに置き換えられました。Zendesk Sunshineに接続するにはSunshine Conversationsのライセンスが必要です。

Zendesk管理設定のApps and integrations > APIs > Zendesk Sunshineに「Zendesk Sunshine」のオプションが表示されない場合、Sunshine Conversationsのライセンスを持っていない可能性が高く、Zendeskサポートに連絡して取得する必要があります。

Zendesk Sunshineの仕組み

Zendesk SunshineはFinとZendeskの会話をリアルタイムで同期します。FinはAPIコールを送受信します:

  • 顧客からのすべての受信メッセージ時

  • Finのすべての応答時

  • 会話が割り当てられた、エスカレーションされた、または終了した時

顧客がFin Messengerで開始した場合、Finは対応するSunshineユーザーを作成または検索します。


Zendesk Messengerで会話が開始された場合、FinはメッセージをFinワークスペースにマッピングします。

Zendeskで複数会話を有効にする

Hand-off to Zendesk agentまたはDetermined by situationを使用する場合、ZendeskでMultiple conversationsを有効にする必要があります。

Fin MessengerのZendesk設定ページで、管理センターのメッセージ設定にあるマルチ会話有効化のパスを表示。
  1. FinでSettings > Fin Messenger > Configure in Zendeskに移動します。

  2. ZendeskでAdmin Center > Channels > Messaging > Manage settings > Multi-conversationsに進み、Multiple Conversationsを有効にします。FinのManage in ZendeskをクリックするとZendeskが開きます。

  3. Finに戻り、Refreshをクリックします。


ワークフローを構築する

挨拶と引き継ぎのワークフローを設定する

統合画面からManage workflowをクリックします。テンプレートが提供されていますが、完全にカスタマイズ可能です:

Fin Messengerのワークフロー概要。新しい会話、ウェルカムメッセージ、Finが対応するステップと引き継ぎパスを表示。
  • Finが応答すべきタイミング

  • Finがお客様に挨拶する方法

  • エスカレーション時の対応内容

  • 引き継ぎ前に収集するデータ

未解決のパスの最後で、Finは自分の割り当てを解除し、routed-to-the-teamタグを適用します。

ワークフローのLet Fin handle ステップをクリックして以下をカスタマイズします:

Let Fin answerパネル。トレーニング、人間サポートの期待、引き継ぎ質問、非アクティブ顧客のフォローアップ、CSAT、自動クローズのオプションを一覧表示。
  • 人間サポートの期待を設定 - メッセンジャー会話でチームメンバーの在席を表示します。チーム全員が別ツールで作業しているか、誰もinboxを監視していない場合は無効にしてください。

  • 非アクティブ顧客へのフォローアップ - Finが応答した後に顧客が反応しない場合の対応を決定します。

  • 引き継ぎ前に追加情報を求める - 顧客がチームとの会話を希望する際に追加情報を収集します。追加情報収集中にFinがさらに回答を提供し、解決の可能性を高めます。

  • Finが回答したときにZendesk ticketを作成 - この機能は廃止され、現在利用できません。Zendeskはすべての顧客向けに「AI Agent Tickets」を提供しており、AIのみの会話の可視化を自動的に行います。Zendesk AI Agent ticketsはデフォルトで有効です。Zendesk AI Agent Ticketsについて詳しくはこちら。

  • 会話評価の依頼 (CSAT) - 顧客がFinとやり取りした後にCSAT調査を送信するか選択します。

  • 放置されたFinの会話を自動でクローズ - 顧客が非アクティブと見なされるまでの待機時間、非アクティブな会話を閉じるタイミング、会話を閉じる際にFinが発言する内容をカスタマイズできます。

自動クローズ設定の構成

Finはワークフロー内の特定のアクションを通じて自動クローズの動作をカスタマイズできます。関連設定はLet Fin handleステップにあります。自動クローズ設定を管理・カスタマイズするには以下の手順に従ってください。

  • Let Fin handleステップ内で、Auto-close abandoned Fin conversationsとラベル付けされたセクションを見つけてください。

  • このセクションを使って、会話が放置されたと見なされる具体的な条件を定義し、自動的に会話が閉じられるまでの遅延時間を指定します。

  • 非アクティビティに基づくクローズのタイミングを設定するには、同じLet Fin handleセクションのClose-on-inactivity timing設定を調整してください。これにより、顧客の活動が検出されない場合にFinが会話を閉じるまでの待機時間を管理できます。

  • 自動クローズの時間枠を延長すると、解決済みと誤認される数を減らせます。例えば、デフォルトの8時間から24時間や48時間に遅延時間を延ばすことで、会話が閉じられる前に顧客が応答する機会を増やせます。

ヒント:

  • 現実的な遅延時間を設定してください:遅延が短すぎたり長すぎたりすると、顧客体験が悪化する可能性があります。応答性と顧客が返信する十分な時間のバランスを目指しましょう。

  • 条件を明確に定義してください:放置および非アクティブの基準がサポートのユースケースに適していることを確認してください。

  • 設定をテストしてください:選択した設定がワークフローの要件や顧客のニーズに合っているか確認するためにテストを実施しましょう。

ワークフロービルダーでさらに体験をカスタマイズできます:

  • 条件に基づいて異なる分岐を作成する。

  • Finが回答するタイミングを選択する。

  • Finにメッセージを送信させる。

  • 返信ボタンを提供する。

  • データを収集する。

  • 顧客の返信を収集する。

  • 内部メモを追加する。

  • 会話のAI生成サマリーを追加する。

  • 顧客の発言に基づいてticket属性を自動分類する。

注意:ワークフローを変更するには編集モードである必要があります。ワークフローエディター画面右上の編集を選択してください。

FinワークフローのパスがZendesk ticket作成アクションで終了し、会話のサマリーで別のticketが作成されることを説明するツールチップ付き。
FinワークフローのパスがZendeskエージェントへの引き継ぎアクションで終了し、チームメンバーのためのライブチャットが作成されることを説明するツールチップ付き。

ワークフローの最終引き継ぎパスでは、Finが会話を引き継ぐ方法を選択できます。

選択した引き継ぎ方法により、接続すべきZendesk APIが決まります。

機能

Zendesk API (OAuth)が必要

Zendesk Sunshineが必要

Zendesk ticketを作成

はい ✅

いいえ ❌

Zendeskエージェントに引き継ぎ

はい ✅

はい ✅

状況により決定

はい ✅

はい ✅

  • Zendesk Ticketを作成:Finでのユーザーセッションを終了し、会話のサマリーと収集データを含むticketを作成します。

  • URLに引き継ぎ:同じタブでユーザーを新しいURLにリダイレクトします。

  • JavaScriptで引き継ぎ:handoff_with_javascriptを使用してFin Messenger内のアクションを定義します。

  • Zendesk Agentに引き継ぎ:Zendeskでライブチャットを開始し、チームメンバーが会話を続けられるようにします。

引き継ぎオプションが既に選択されている場合は、そのオプションにカーソルを合わせ、表示される3点リーダーをクリックして削除を選択することでオプションを削除できます。

属性を使ってZendesk ticketの件名をカスタマイズ

引き継ぎでZendesk ticketが作成される場合、Create Zendesk ticket アクションをクリックして、Finワークスペース内の属性を使ってticket件名をカスタマイズできます。

AI Title属性がticketタイトルフィールドにあるCreate Zendesk ticketパネル、フォームセレクター、メール検証トグル。

挨拶とチームへの引き継ぎのカスタマイズが完了したら、保存または公開をクリックしてメッセンジャーで有効にします(後で公開設定に戻ることも可能です)。

特定のZendesk組織にticketsを割り当てる

Zendeskワークスペースでorganizationsを使用していて、ユーザーが複数のorganizationsに所属している場合、JWT tokenを介してticketが割り当てられるorganizationを制御できます。

これを行うには:

  1. Zendeskでexternal idを持つorganizationを作成するか既存のものを使用します。これはZendesk APIを通じてこちらで作成できます。

    External ID 457が強調表示されたZendesk organizationの詳細。
  2. JWTにcompanyフィールドを2つの属性で含めます:

    {
    "id": "457", // This should match the external ID of the Zendesk organization.
    "name": "Examply Org"
    }

  3. Create Zendesk ticketハンドオフを使ってFin Messenger workflowを設定します。

  4. Fin Messengerから作成されたticketsは、JWTのexternal_idで定義されたorganizationに自動的に割り当てられます(そのユーザーがorganization内にいる限り)。注意:これはJWTをサポートするチャネルのFin Messengerでのみ利用可能です(メールはサポートされていません)。

ヒント:Finワークスペース内で複数のFin workflowsを直接作成および管理できます。これにより、異なるメッセージングシナリオに合わせた顧客体験のカスタマイズや、チーム専用の「テスト」workflowの設定が可能になります。


Fin Messengerをインストールする

Fin Messengerをインストールするには、Deploy > Fin Messenger > Installに移動します。ウェブサイトまたはウェブアプリ、またはモバイルアプリのいずれかにメッセンジャーをインストールする必要があります。

ウェブ用にインストールする

メッセンジャーのインストール方法を選択してください

まず、メッセンジャーのインストール方法を選択する必要があります。Code snippet, React, Angular, Vue, EmberまたはShopifyをインストール方法として選択すると、ログインなしのウェブサイト訪問者向けにFinをインストールする選択肢があります。

Code snippet, React, Angular, Vue, EmberまたはShopifyのインストール手順は、選択に応じて更新されます。ログインユーザーと訪問者の両方にインストール可能な方法では、使用したい各インストール方法のコードスニペットをコピーする必要があります。

ログインユーザーの場合は、インストールコードに進むためにEnable connection to messengerのトグルをオンにしてください。

指示に従ってください

選択した方法の指示に従ってください。例えば、Shopifyを選択した場合、そのインストール手順が表示されます。

Code snippet, React, Angular, Vue, またはEmberの方法を選択した場合、独自のワークスペースIDが事前に設定されたコードスニペットを含むNPMパッケージが提供されます。これを自分のアプリのコードベースにコピー&ペーストしてください。

パッケージはNPMサイトでも直接見つけられます。

Basic JavaScriptやSingle-page appにコードスニペットを含めるテンプレートや、Rails gemを使ってスニペットをインストールする方法もあります。

Copy codeをクリックし、メッセンジャーを表示したいすべてのページの</body>タグの前に貼り付けてください。

コードを追加した後、メッセンジャーをインストールしたページのいずれかを訪問すると、右下隅に表示されるはずです。またはインストールプロセスのCheck installationオプションを使用できます。

JWTでFin Messengerを保護する

ログインユーザー向けにサイトにFin Messengerをインストールしている場合、不正なユーザーによるなりすましや不正データ送信を防ぐために保護することが不可欠です。​

JSON web tokens(JWT)は、第三者がログインユーザーになりすましたり会話を見たりするのを防ぎます。すべてのFin顧客にJWT認証の強制を強く推奨します。

JWT認証が有効になると、FinはFin Messengerが起動するたび、またはZendesk Messenger経由で新しいメッセージを受信するたびに、Zendeskからユーザーおよびorganizationフィールドを自動的に同期します。このシームレスなデータ転送により、workflow内でより動的でパーソナライズされた顧客対応が可能になります。

URLベースのセグメンテーションに過度に依存しないでください:ログイン状態の判別にURLだけを使わないでください。URLはブックマークされたり不正アクセスされたりする可能性があり、安全ではありません。URLベースのセグメンテーションはJWTと組み合わせて強固な認証を行ってください。

モバイル用にインストールする

インストールプラットフォームを選択してください

まず、iOS、Android、またはReact Nativeのいずれかのインストールプラットフォームを選択します。各プラットフォームには特有の手順があり、Finをモバイルアプリにインストールする方法やコードスニペットが提供されます。

コードベース内でFinを初期化する

次のステップは、モバイルアプリのコードベース内でFinを初期化することです。このステップでAPIキーの管理も行えます。

iOS向けコードスニペットの選択肢

Android向けコードスニペットの選択肢

React Nativeの選択肢

  1. Swift

  2. Swift UI

  3. ObjectiveC

  1. Kotlin

  2. Java

  1. iOS

  2. Android

指示に従う

次に、プラットフォーム固有の指示に従ってFin Messengerをモバイルアプリに統合してください。

iOS向けにFin Messengerを設定する際に

  1. Zendeskで、Admin Center > Apps and Integrations > Zendesk Sunshineに移動します。

  2. Create API Keyをクリックし、キーに名前を付けてSaveをクリックします。

  3. 生成されたキーをコピーします — これはZendesk Sunshineリストに表示されます。

  4. Fin workspaceで、Deploy > Fin Messenger > Install > iOSに移動し、初期化コードにキーを貼り付けます。

重要:

  • App ID、Key ID、Secret Keyは安全に保管してください。再表示されません。

  • 合計で10個のキーまで保存できます。

  • Zendesk Suite Professionalプラン以上が必要です。

インストールを確認する

セットアップの最後にインストールを確認するをクリックして成功を確認してください。
Fin Messengerが検出されると確認メッセージが表示され、問題があればエラーメッセージが表示されます。

JWTでFin Messengerを保護する

ログインユーザー向けにサイトにFin Messengerを設置している場合、不正なユーザーのなりすましや不正データ送信を防ぐためにセキュリティを強化することが不可欠です。​

JSON web tokens(JWT)は第三者がログインユーザーになりすましたり会話を閲覧したりするのを防ぎます。すべてのFinのお客様にJWT認証の強制を強く推奨します。

JWT認証を有効にすると、FinはFin Messenger起動時やZendesk Messenger経由で新しいメッセージを受信するたびに、Zendeskからユーザーおよび組織フィールドを自動的に同期します。このシームレスなデータ転送により、workflows内でより動的かつパーソナライズされた顧客対応が可能になります。

オプション:プッシュ通知の設定

このステップでは、インストールプラットフォーム(iOSまたはAndroid)を再度選択できます。このセクションからプッシュ通知を設定できますが、設定手順の案内はありません。プッシュ通知の設定には開発者向けドキュメントを参照してください。

React nativeはモバイルプッシュ通知のオプションとして提供されていません。

このオプションのステップは、iOSまたはAndroidアプリでプッシュ通知が設定されていると検出された時点で完了とマークされます。

重要: Fin iOS SDK v13.0.0+のビルドにはXcode 14が必要です。

Xcode 14ではSDKをインストールするとコンソールにいくつかの警告が表示されます。これらの警告はFinのWKWebView使用に起因します。Xcode 14のバグによるもので、Fin側で修正できる問題ではありません。

これらは単なる警告であり、警告があってもFinは通常通り動作します。

警告メッセージは以下の通りです:

  1. WKWebView Error - 記事を表示し、コンソールに以下が表示されます:Error acquiring assertion: <Error Domain=RBSServiceErrorDomain Code=1 "target is not running or doesn't have entitlement com.apple.runningboard.assertions.webkit" UserInfo={NSLocalizedFailureReason=target is not running or doesn't have entitlement com.apple.runningboard.assertions.webkit}>

  2. このメソッドはUIの応答停止を招く可能性があるため、メインスレッドで呼び出すべきではありません。

  3. [Sandbox] Mach bootstrapを有効にできませんでした、errno = 22。


Fin MessengerでFinをテストする

Finの準備を確認する

まず、Finに十分なトレーニングを行ったことを確認してください。これはライブテストを始める前に重要です。

Finが顧客の質問にできるだけ正確に答えられるようにするためのトレーニング方法については、完全ガイドをお読みになることをお勧めします。

ライブ前にテストする

Finが十分にトレーニングされ、messengerを会社のブランドに合わせてカスタマイズしたことを確認したら、ライブ前にFinをテストできます。

これは、Fin Messenger内のFinがインストールしたウェブサイトやアプリ内でどのように見え、動作するかを顧客に見せずに正確に確認する最良の方法です。

ライブ前にFin MessengerでFinをテストするには:

  1. Deploy > Fin Messengerに移動します。

  2. ページ右上のTest before going liveをクリックします。

    Fin MessengerのDeployページにライブステータスと右上のTest before going liveボタンが表示されています。
  3. Enable test modeトグルをオンにします。

    Fin MessengerのテストモードセクションにEnable test modeトグルとLaunch test URLフィールドがあります。
  4. Launch testフィールドにFin MessengerがインストールされているページのURLを入力し、テストを開始します。そのページのURLの末尾に?intercomTest=trueを追加しても構いません。

重要: Fin Messengerがライブ中はテストモードは利用できません。ライブ中の場合、Finは「Fin Messengerはすでにライブです。テストモードを使用するには一時停止してください。」と表示します。一時停止するとFinは顧客のチャットから外れるため、準備ができている時のみ一時停止してください。

テストの開始

ブラウザに?intercomTest=trueが追加されたページURLが表示され、Fin Messengerランチャーが開き、テストパラメータとmessengerを指し示す注釈があります。

モバイルでのテスト

モバイルでテストするには、まずステージングアプリにインストールし、ライブ前にテストを実行する必要があります。

Zendeskでセットアップを検証する

Zendeskで正しいusersがticket requesterとして割り当てられているかテストすることをお勧めします。

これを確認するには:

  1. 正しいuser_idまたはメールアドレスが渡されていることを確認しながらFin Messengerで会話を開始します。

  2. Finが会話を引き継いだら、Zendeskで新しいticketまたはライブチャットが作成されているか確認します。

  3. リクエスターが期待されるユーザーと一致しているか確認します。

  4. リクエスターが一致しない場合は、Fin Messengerのuser_idがZendeskのexternal_idと一致しているか確認してください。


Fin Messenger用のFinをライブにする

お客様向けにFinをライブ設定する準備ができました。Deploy > Fin Messenger > Go Live に移動し、Go Live. を選択してください。


カスタマーエクスペリエンス

お客様がMessengerを開くと、Finからの挨拶が表示されます(カスタマイズ可能です)。

Fin Messengerランチャーが「こんにちは」の挨拶と最初のメッセージ「こんにちは!今日はどのようなご用件ですか?」を表示しています。

お客様がメッセージを送信すると、Zendeskにticketが作成され、Fin-messengerタグが適用されます。Zendesk Triggersを使って、ticketを自動的にFinに割り当てるタイミングを決めることができます。

Finに割り当てられた会話にはfin-involvedタグが適用されます。

Finが回答に必要な関連知識を持っている場合、Finは応答し、使用した情報源を引用し、ticketをsolvedとしてマークし、以下のタグを適用します。

  • fin-resolved: Finがticketを解決しました(ソフトまたはハード解決のいずれか)。

  • fin-soft-resolution: Finが会話を解決しましたが、お客様はまだ確認していません。

Fin Messengerの会話で、Finが情報源をリストアップし、回答が役立ったか尋ね、「役立った」と「担当者と話す」ボタンを提供しています。

Finが質問に回答した後のZendesk ticketは、Solvedステータスとfin-involved、fin-resolved、fin-soft-resolutionタグが付いています。

質問があいまいな場合、Finは明確化の質問をし、ticketをpendingとしてマークし、お客様が3分以内に応答しなければチームに引き継ぎます。

回答がない場合、Finは自身の割り当てを解除し、ticketをopenとしてマークしてチームに引き継ぎます。

お客様はフォローアップの質問ができ、Finは同じプロセスを繰り返します。

お客様が役立ったと言った場合、「fin-soft-resolution」タグは削除され、「fin-hard-resolution」が適用されます。

お客様がチームと話したい場合、Finはticketの割り当てを解除し、「fin-resolved」および「fin-soft/hard-resolution」タグを削除し、「fin-routed-to-team」タグを適用します。このタグを使って追加のZendesk Triggersを作成し、ticketをさらにルーティングできます。この動作により、会話のステータスが適切にお客様のニーズを反映し、チームへのスムーズな移行と未解決ticketの可能性を減らします。

お客様が担当者と話したいとリクエストした後のZendesk ticketは、Openステータスとfin-routed-to-teamタグが付いています。

エージェントが返信すると、それがFin Messengerに表示されます。お客様がオフラインでメールアドレスがわかっている場合は、メール通知が送信され、メールで会話を続けることができます。

注意:Fin MessengerはFinとProactive Supportメッセージ(アウトバウンドチャット、投稿、製品ツアー、メールなど)両方で使用できません。

Zendesk tickets用Finの設定方法を学びましょう。

こちらの回答で解決しましたか?