Fin MessengerをZendeskと統合し、workflowをカスタマイズし、会話の引き継ぎ方法をチームメイトに制御する方法を学びましょう。
Fin MessengerをZendeskと統合する
FinがZendeskに引き継ぐ方法を選択する
Deploy > Fin Messengerに移動し、Finが顧客に答えられない場合に何が起こるかを選択してください:
Zendeskエージェントへの引き継ぎ:Zendeskでライブメッセージング会話を作成します。
Zendesk ticketを作成:Finのセッションを終了し、トランスクリプト付きのZendesk ticketを作成します。
状況に応じて決定:例)営業時間中はライブチャット、営業時間外はticket。
選択した引き継ぎ方法により、接続が必要なZendesk APIが決まります。
機能 | Zendesk API(OAuth)が必要 | Zendesk Conversations APIが必要 |
Zendesk ticketを作成 | はい ✅ | いいえ ❌ |
Zendeskエージェントへの引き継ぎ | はい ✅ | はい ✅ |
状況に応じて決定 | はい ✅ | はい ✅ |
OAuthを使ってZendeskに接続する
OAuthはFinとZendeskを接続する主要な方法です。OAuthによりAPIトークンの手動管理が不要になり、Zendeskの変更にも継続的に対応できます。
Deploy > Fin Messengerに移動してください。
Zendesk APIの下で、接続を選択します。
OAuthを使ってZendeskにサインインし、アクセスを承認します。
Finに戻り、接続が接続済みと表示されていることを確認します。
注意:ZendeskはAPIトークン認証を廃止しています。新規顧客はすべてOAuthを使ってFinをZendeskに接続する必要があります。
新規非契約顧客:OAuthが必須です。
新規契約顧客:ワークスペースで有効化されるとOAuthが必須です。
既存顧客:APIトークン接続は継続して機能しますが、切断された場合は再接続にOAuthが必要です。OAuthが有効になるまで永続的なバナーが表示されます。
Zendesk Conversations APIに接続する
workflowにZendeskエージェントへの引き継ぎが含まれる場合、Zendesk Conversations APIにも接続する必要があります。Zendesk Conversations APIの認証情報はキー方式のままで、OAuthは置き換えません。
Zendesk管理センター > Apps & Integrations > Conversations APIから以下の詳細を提供してください:
アプリID
キーID
シークレットキー
上記すべてをコピーしたら、接続を選択します。
注意:Zendesk Chat APIはConversations APIに置き換えられました。Conversations APIを接続するにはSunshine Conversationsライセンスが必要です。
Zendesk管理設定のApps and integrations > APIs > Conversations APIに「Conversations API」のオプションが表示されない場合、Sunshine Conversationsライセンスを持っていない可能性が高く、Zendeskサポートに連絡して取得する必要があります。
Zendesk Conversations APIの仕組み
Conversations APIはFinとZendeskの会話をリアルタイムで同期します。FinはAPIコールを送受信します:
顧客からの受信メッセージごとに
Finの応答ごとに
会話が割り当てられた時、エスカレーションされた時、または終了した時
顧客がFin Messengerで開始した場合、Finは対応するSunshineユーザーを作成または検索します。
Zendesk Messengerで会話が開始された場合、FinはメッセージをFinのworkspaceにマッピングします。
Zendeskで複数会話を有効にする
Zendeskエージェントへの引き継ぎまたは状況に応じて決定を使用する場合、Zendeskで複数会話を有効にする必要があります。
Finでプロンプトが表示されたら、Manage in Zendeskをクリックします。
Zendesk Messagingの設定でMultiple Conversationsを有効にします。
Finに戻り、Refreshをクリックします。
ワークフローを構築する
挨拶とハンドオフのワークフローを設定する
統合画面からManage workflowをクリックします。テンプレートが提供されていますが、完全にカスタマイズ可能です。
Finが応答すべきタイミング
Finがお客様に挨拶する方法
エスカレーション時の対応内容
ハンドオフ前に収集するデータ
未解決の経路の最後に、Finは自身の割り当てを解除し、routed-to-the-teamタグを適用します。
ワークフローのLet Fin handle ステップをクリックして、以下をカスタマイズします。
人間のサポートへの期待を設定 - メッセンジャーの会話でチームメンバーの在席を表示します。チーム全員が別のツールで作業しているか、誰もinboxを監視していない場合は無効にしてください。
非アクティブな顧客へのフォローアップ - Finが応答した後、顧客が反応しなかった場合の対応を決定します。
ハンドオフ前に追加情報を求める - 顧客がチームと話したいと要求したときに追加情報を収集します。追加情報を収集する際、Finは追加の回答を提供し、解決の可能性を高めることがあります。
Finが応答したときにZendesk ticketを作成 - この機能は廃止され、利用できません。Zendeskは現在、すべての顧客向けに「AI Agent Tickets」を提供しており、AIのみの会話の可視性を自動的に作成します。2026年2月18日にこの機能はZendeskでデフォルトで有効になりますが、オフにすることも可能です。2026年5月4日にはデフォルトで有効になり、オフにできなくなります。Zendesk AI Agent Ticketsについて詳しくはこちら。
会話評価を求める (CSAT) - 顧客がFinとやり取りした後にCSAT調査を送信するか選択します。
非アクティブな会話の処理 - Finが顧客を非アクティブとみなすまでの待機時間、非アクティブな会話を閉じるタイミング、会話を閉じる際のFinの発言をカスタマイズします。
自動クローズ設定の構成
Finはワークフロー内の特定のアクションを通じて自動クローズの動作をカスタマイズできます。関連設定はLet Fin handleステップにあります。自動クローズ設定を管理・カスタマイズするには、以下の手順に従ってください。
Let Fin handleステップ内で、Handle inactive conversationsセクションを見つけます。
このセクションを使って、会話が放棄されたとみなされる具体的な条件を定義します。会話が自動的に閉じられるまでの遅延時間を指定してください。
非アクティブによるクローズのタイミングを設定するには、同じLet Fin handleセクションのClose-on-inactivity timing設定を調整します。これにより、顧客の活動が検出されない場合にFinが会話を閉じるまでの待機時間を管理できます。
自動クローズの時間枠を延長すると、解決済みと誤認される数を減らせます。例えば、デフォルトの8時間から24時間や48時間に遅延時間を延ばすことで、顧客が応答する機会を増やせます。
ヒント:
現実的な遅延時間を設定してください。短すぎたり長すぎたりすると顧客体験が悪化する可能性があります。応答性と顧客が返信する十分な時間を与えるバランスを目指しましょう。
条件を明確に定義してください。放棄や非アクティブの基準がサポートのユースケースに適していることを確認しましょう。
設定をテストしてください。選択した設定がワークフローの要件と顧客のニーズに合っているか確認しましょう。
ワークフロービルダーでさらに体験をカスタマイズできます:
条件に基づいて異なる分岐を作成する。
Finが応答するタイミングを選択する。
Finにメッセージを送信させる。
返信ボタンを提供する。
データを収集する。
顧客の返信を収集する。
内部メモを追加する。
会話のAI生成サマリーを追加する。
顧客の発言に基づいてticket属性を自動分類する。
注意:ワークフローを変更するには編集モードである必要があります。ワークフローエディター画面の右上にある編集を選択してください。
ワークフローの最終ハンドオフ経路で、Finが会話をどのように引き継ぐか選択できます。
ハンドオプションがすでに選択されている場合は、そのオプションにカーソルを合わせ、表示される3点をクリックして削除を選択することで削除できます。 |
|
属性を使ってZendesk ticketの件名をカスタマイズする
ハンドオフでZendesk ticketが作成される場合、Create Zendesk ticket アクションをクリックして、Finワークスペースの属性を使ってticket件名をカスタマイズできます。
挨拶とチームへのハンドオフのカスタマイズが完了したら、保存または公開をクリックしてメッセンジャーで有効にします(後で公開設定に戻ることも可能です)。
特定のZendesk組織にticketsを割り当てる
Zendeskのワークスペースでorganizationsを使用し、ユーザーが複数のorganizationsに所属している場合、JWT tokenを介してticketが割り当てられるorganizationを制御できます。
これを行うには:
Zendeskでexternal idを持つ既存のorganizationを作成または使用します。これはZendesk API こちらから作成可能です。
JWTに
companyフィールドを2つの属性付きで含めます:{
"id": "457", // This should match the external ID of the Zendesk organization.
"name": "Examply Org"
}Create Zendesk ticketのハンドオフを使ってFin Messengerのworkflowを設定します。
Fin Messengerから作成されたticketは、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のインストール手順は、選択するたびに更新されます。ログインユーザーと訪問者の両方にインストール可能な方法では、使用したい各インストール方法のコードスニペットをコピーする必要があります。
Users with loginsの場合は、インストールコードに進むために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の選択肢 |
|
|
|
指示に従ってください
次に、プラットフォーム固有の指示に従ってFin Messengerをモバイルアプリに統合してください。
iOS用にFin Messengerを設定する際に
Zendeskで、Admin Center > Apps and Integrations > Conversations APIに移動します。
Create API Keyをクリックし、キーに名前を付けて、Saveをクリックします。
生成されたキーをコピーします — これはConversations API listに表示されます。
Fin workspaceで、Deploy > Fin Messenger > Install > iOSに移動し、初期化コードにキーを貼り付けます。
重要:
App ID、Key ID、およびSecret Keyを安全に保管してください — 再表示されません。
合計で10個のキーまで保存できます。
Zendesk Suite Professionalプラン以上が必要です。
インストールを確認する
セットアップの最後にインストールを確認するをクリックして成功を確認してください。
Fin Messengerが検出されると確認メッセージが表示され、問題があればエラーメッセージが表示されます。
JWTでFin Messengerを保護する
ログインしたusers向けにFin Messengerをサイトに設置している場合、不正なusersのなりすましや不正データ送信を防ぐために保護することが不可欠です。
JSON web tokens (JWTs)は第三者がログインしたusersになりすましたり会話を見たりするのを防ぎます。すべてのFin顧客にJWT認証の強制を強く推奨します。
JWT認証が有効になると、FinはFin Messengerが起動するたび、またはZendesk Messenger経由で新しいメッセージを受信するたびに、Zendeskからusersと組織のフィールドを自動的に同期します。このシームレスなデータ転送により、workflows内でより動的でパーソナライズされた顧客対応が可能になります。
オプション:プッシュ通知の設定
このステップでは再度インストールプラットフォーム(iOSまたはAndroid)を選択できます。このセクションからプッシュ通知を設定できますが、設定手順の案内はありません。代わりに開発者向けドキュメントを参照してください。
React nativeはモバイルプッシュ通知のオプションとして提供されていません。
このオプションのステップは、iOSまたはAndroidアプリのいずれかでプッシュ通知が設定されていると検出された時点で完了とマークされます。
重要: Fin iOS SDK v13.0.0+のビルドにはXcode 14が必要です。
Xcode 14ではSDKをインストールするとコンソールにいくつかの警告が記録されます。これらの警告はFinのWKWebViewの使用に起因します。Xcode 14のバグによるもので、Fin側で修正できる問題ではありません。
これらは単なる警告であり、警告があってもFinは通常通り動作します。
警告メッセージは以下の通りです:
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}>このメソッドはUIの応答停止を招く可能性があるため、メインスレッドで呼び出すべきではありません。[Sandbox] Mach bootstrapを有効にできませんでした、errno = 22。
Fin MessengerでFinをテストする
Finが準備できていることを確認する
まず、Finに十分なトレーニングを行ったことを確認するよう求められます。これはライブテストを開始する前に重要です。
Finのトレーニング方法の完全ガイドを読むことをお勧めします。これにより、Finが顧客の質問にできるだけ正確に答えられるようになります。
ライブテスト
Finが十分にトレーニングされ、messengerを会社のブランドに合わせてカスタマイズしたことを確認したら、ライブテストを実行できます。
これは、顧客に見られることなく、インストールしたウェブサイトやアプリ内でFin Messengerの見た目や動作を正確に確認する最良の方法です。
ライブテストを有効にすると、Finが起動し、テスト用URLの背後でmessengerがオンになります。
ライブテストモードが有効になりました
ライブテストを開始しています
モバイルのテスト
モバイルでテストするには、まずステージングアプリにインストールし、ライブ設定前にテストを実行する必要があります。
Zendeskでセットアップを検証する
正しいusersがZendeskでticketの依頼者として割り当てられているかテストすることをお勧めします。
これを確認するには:
Fin Messengerで会話を開始し、正しいuser_idまたはメールアドレスが渡されていることを確認します。
Finが会話を引き継ぐと、Zendeskで新しいticketまたはライブチャットが作成されます。
依頼者が期待されるusersと一致しているか確認します。
依頼者が一致しない場合は、Fin Messengerのuser_idがZendeskのexternal_idと一致しているか確認してください。
Fin MessengerのFinを本番稼働させる
これで顧客向けにFinを本番稼働させる準備が整いました。Deploy > Fin Messenger > Go Liveに移動し、Go Liveを選択してください。
顧客体験
顧客がMessengerを開くと、Finからの挨拶が表示されます(カスタマイズ可能)。
顧客がメッセージを送信すると、Zendeskにticketが作成され、Fin-messengerタグが適用されます。Zendesk Triggersを使ってticketを自動的にFinに割り当てるタイミングを決められます。
Finに割り当てられた会話にはfin-involvedタグが適用されます。
Finが回答に必要な知識を持っている場合、Finは応答し、使用した情報源を引用し、ticketをsolvedとしてマークし、以下のタグを適用します:
fin-resolved: Finがticketを解決しました(ソフトまたはハード解決)。
fin-soft-resolution: Finが会話を解決しましたが、顧客は確認していません。
質問があいまいな場合、Finは明確化の質問をし、ticketをpendingとしてマークし、顧客が3分以内に応答しなければチームに引き継ぎます。
もし答えがなければ、Finは自分の割り当てを解除し、ticketをオープンとしてマークしてチームに引き継ぎます。
お客様は追加の質問をすることができ、Finは同じプロセスを繰り返します。
お客様が役立ったと言った場合、「fin-soft-resolution」タグは削除され、「fin-hard-resolution」が適用されます。
お客様がチームと話したい場合、Finはticketから自分の割り当てを解除し、「fin-resolved」および「fin-soft/hard-resolution」タグを削除し、「fin-routed-to-team」タグを適用します。このタグを使って、さらにticketをルーティングするZendeskトリガーを作成できます。この動作により、会話のステータスがお客様のニーズを適切に反映し、チームへのスムーズな移行を可能にし、未解決のticketsの可能性を減らします。
エージェントが返信すると、それはFin Messengerに表示されます。お客様がオフラインでメールアドレスがわかっている場合、メール通知が送信され、メールで会話を続けることができます。
注意:Fin Messengerは、FinとProactive Supportのメッセージ(アウトバウンドチャット、投稿、製品ツアー、メールなど)両方で使用できません。
Zendesk tickets用のFinの設定方法を学びましょう。

















