チャット連携：フィールドとワークフローの引き継ぎ

チャット連携でのフィールド更新とワークフローの引き継ぎには、AI Flowi Workflow の2つのコンポーネントを使います。購読者フィールドを更新し、更新が成功した後にチャットチャネルのサブフローを起動します。Ai Flowi の受信トレイでは、ワークスペースの権限に応じて、連絡先フィールドを編集したり、会話の対応をAIと担当者の間で切り替えたりすることもできます。

公開日 · 更新日

執筆：Ai Flowi · 技術レビュー： Janice Lee（Ai Flowi テクニカルサポート）。

製品： Ai Flowi の AI Flowi Workflow · 目的： 購読者フィールドの更新とサブフローの起動 · コンポーネント： Chat Channel User Fields Setter; Chat Channel Sub-Flow Trigger

このガイドが役立つ場面

チャットチャネルのサブフローを実行する前に購読者フィールドを更新する必要がある場合は、この2つのコンポーネントを組み合わせて使ってください。権限を持つアカウントで連絡先フィールドを確認または変更する場合は、受信トレイの連絡先パネルを使います。

関連情報：UChat連携：AI Flowi Workflow。

始める前に

  • 設定済みのメッセージングアカウントに対応する Chat Channel Token、Chat Channel User ID、Chat Channel Sub-Flow ID を準備します。
  • JSON Data 用に、フィールドオブジェクトを含む空でない最上位の配列を準備します。
  • 受信トレイで編集するには、会話が属するワークスペースと inbox.reply 権限を持つアカウントを使ってください。フィールドの読み取りには inbox.view が必要です。
  • メッセージングプロバイダー側でチャネルを設定してください。ダッシュボードのチャネル接続操作は無効になっています。

手順

1. Chat Channel User Fields Setter

追加： ワークフローに Chat Channel User Fields Setter を追加します。

設定： Chat Channel Token と Chat Channel User ID を入力します。JSON Data は最上位の配列として渡してください。data プロパティで囲まないでください。

例： メッセージングアカウントで認識されるテスト用フィールド名を使ってください。以下の値は説明用の例です。

[{"name": "support_topic", "value": "billing"}]

テスト： テスト用の購読者でフィールド更新コンポーネントを実行し、Field Update Status を確認します。

期待する結果： リクエストが成功すると FIELDS_READY が返されます。認証情報の不足やリクエストの失敗ではエラーメッセージが返されます。JSON Data が無効な場合は、コンポーネントのビルドが失敗します。

2. Chat Channel Sub-Flow Trigger

追加： Chat Channel Sub-Flow Trigger を追加します。

設定： 対象の購読者とサブフローに対応する Chat Channel Token、Chat Channel User ID、Chat Channel Sub-Flow ID を入力します。

接続： フィールド更新コンポーネントの Field Update Status を、起動コンポーネントの Wait Signal に接続します。

テスト： テスト用の購読者で接続したコンポーネントを実行し、Flow Trigger Status を確認します。

期待する結果： Wait Signal は FIELDS_READY と完全に一致する必要があります。リクエストが成功すると、起動コンポーネントは FLOW_SENT を返します。他の信号を受け取った場合は、サブフローの送信前に起動処理を中止します。

3. カスタムフィールド

追加： 会話一覧から会話を開き、連絡先パネルのカスタムフィールドを探します。

設定： 既存の値を編集するか、New field name と New field value を入力します。フィールド保存を選択して変更を送信します。

テスト： フィールド再読み込みを選択し、メッセージングサービスから購読者のフィールドを読み取ります。取得した値が、保存しようとした値と一致するか確認します。

期待する結果： フィールド保存は、指定した名前の購読者フィールドを更新し、その変更を保存済みの連絡先フィールドに統合します。フィールド再読み込みは、返されたフィールドデータで保存済みのフィールドを置き換えます。

4. 担当者への引き継ぎとAIへの復帰

設定： AIが会話に対応しているか、担当者の対応を待っている場合は、引き継ぎを選択します。引き継ぎが成功すると、ボットが一時停止し、対応付けられたメッセージング担当者が割り当てられます。

テスト： 返信を確認してから送信を選択します。ボットが会話に対応している間は、担当者からの返信はブロックされます。

期待する結果： AIに戻す操作を選択し、ボットを再開して担当者の割り当てを解除します。更新された会話の状態を確認してください。

5. ✦ AI支援と返信の挿入

追加： 担当者が対応している会話で、✦ AI支援を開いて返信案をリクエストします。レスポンスで課金が報告された場合、ドロワーには課金されたトークン数が表示されます。

設定： 返信を挿入する操作を選択し、返信欄に提案を入れます。送信を選択する前に、内容を確認して編集してください。提案を挿入しただけでは、顧客には送信されません。

テスト： 返信欄に意図した文章が入っていることを確認します。再生成の操作で、別の提案をリクエストできます。

よくある間違い

  • JSON Data の配列を直接渡さず、data プロパティで囲んでしまうこと。
  • フィールド更新コンポーネントの Field Update Status を接続せず、代わりの Wait Signal を手入力すること。
  • FLOW_SENT を、サブフローへのリクエストが成功したことではなく、顧客の最終的な返信を確認できた証拠として扱うこと。
  • 連絡先パネルからワークフローを開く操作で画面を移動できると思い込むこと。この操作は無効で、パネルには実行中のワークフローや現在のステップは表示されません。
  • 返信案の挿入を、メッセージの送信として扱うこと。

トラブルシューティング

メッセージ／症状次に確認すること
JSON Data must be a top-level array.JSON Data に配列を直接渡してください。
JSON Data array must not be empty.更新したいフィールドのオブジェクトを追加してください。
Trigger Aborted: expected FIELDS_READYField Update Status と Wait Signal への接続を確認してください。完全なメッセージには、受信した信号も含まれています。
Each field needs name and value受信トレイで編集する際は、空でないフィールド名と文字列の値を使ってください。
Chat user_fields response unsupported返されたフィールドデータの形式を確認するよう、メッセージング管理者に依頼してください。
Take over before replyingボットが対応している会話に返信する前に、担当者への引き継ぎを選択してください。
編集操作が表示されないinbox.reply 権限を確認してください。操作が禁止されている場合、その操作は表示されません。
チャットチャネルへのリクエストがタイムアウトする、またはエラーになる再試行する前に、認証情報、購読者とサブフローの識別情報、メッセージングサービスを確認してください。

関連情報

Ai Flowi のドキュメント · AI Flowi Workflow · 言語と表示の設定 · API Hub · ワークフローの公開ガイド · 公開機能 · 料金 · デモを予約。