respond-io
New
🚀 TikTok 商業訊息傳遞現已上線! 無縫地將對話轉化為商業轉換。 瞭解更多。arrow-icon

首頁 >

集成 >
對話流 >
Dialogflow:參數

Dialogflow:參數

Avatar
Susan Swier
· 29 Aug 2024
10 分鐘

Respond.io 使用自訂 Dialogflow 參數來增強應用程式'的功能,以滿足多種用例。

在 Dialogflow 中,參數通常用於將使用者回應中的單字和短語連接到實體。 因此,如果有人說 "我的生日是 3 月 13 日," ,那麼短語 "3 月 13 日" 將被自動檢測並視為日期實體。 您可以在 Dialogflow 的文件頁面上閱讀有關其中參數的更多資訊。

透過 respond.io 平台,您可以使用參數來覆蓋更多用例。 您可以使用它們來保存和收集您的聯絡人提供的信息,例如透過 分配動態標籤設定自訂欄位。 當聯絡人需要協助時,您甚至可以 通知支援代表 。 您也可以使用 respond.io 平台 儲存並輕鬆管理您的意圖回應

當您將 respond.io 平台與 Dialogflow Intent 參數結合使用時,可以實現許多功能。

參數參考

您可以在 Dialogflow 上使用的與 respond.io 平台進行通訊的參數清單。

參數名稱

價值

描述

RB_ADDTAGS

標籤1, [標籤2, ...]

將指定標籤新增至 respond.io 平台上的聯絡人資料中

RB_REMOVETAGS

標籤1, [標籤2, ...]

從 respond.io 平台上的聯絡人資料中刪除指定標籤

RB_BOTSTATUS

錯誤的

關閉特定聯絡人的機器人。 當您想將對話從機器人傳遞給人類時,這很有用。

RB_MARKDONE

真/假

開啟或關閉聯絡人的對話。 這對於支援很有用。 對於仍在等待某事的聯絡人,開啟對話;對於已經處理過的聯絡人,請關閉對話。

RB_通知

通知訊息

向 respond.io 平台上的人員發送通知,並附帶通知訊息

RB_訂閱

真/假

訂閱或取消訂閱聯絡人。 未訂閱的聯絡人將不會收到廣播訊息。

RB_FIELD_FIRSTNAME

價值

使用指定值填入聯絡人資料中的名字字段

RB_FIELD_LASTNAME

價值

使用指定值填入聯絡人個人資料的姓氏字段

RB_FIELD_FULLNAME

價值

使用指定值填入聯絡人資料的「全名」字段

RB_FIELD_EMAIL

價值

使用指定值填入聯絡人資料的電子郵件地址字段

RB_FIELD_PHONE

價值

使用指定值填入聯絡人資料的電話號碼字段

RB_FIELD_LANGUAGE

價值

使用指定值填入聯絡人資料的語言字段,例如 en-us

RB_FIELD_[名稱]

價值

將一個具有指定值的自訂欄位新增至聯絡人'的個人資料。 這最適合用於非動態訊息,例如電子郵件、生日等。

RB_REMOVEFIELDS

字段1, [字段2, ...]

從平台上的聯絡人中刪除指定的自訂字段

RB_USER_ASSIGN

價值

將聯絡人分配給團隊中的一名用戶

RB_SNIPPET

片段 ID

將指定的程式碼片段傳送給聯絡人

RB_文件

文件 ID

將平台上儲存的指定檔案傳送給聯絡人

標記

聯絡人' 資訊可以以標籤的形式儲存。 可在 聯絡人模組收件匣模組中手動新增/刪除標籤,使用 工作流程以程式設計方式新增/意圖將標籤

重要: 標籤用於廣播中的受眾細分。 使用 Dialogflow 意圖新增/刪除標籤時請記住這一點。

使用標籤參數

添加標籤

使用 RB_ADDTAGS 參數,您可以為聯絡人指派標籤。 將根據參數的值向聯絡人新增標籤。 您可以選擇新增多個標籤,並以逗號分隔。

請注意,標籤名稱不能包含空格。 您可能想改用下劃線。

刪除標籤

使用 RB_REMOVETAGS 參數,您可以從聯絡人中刪除標籤。 將根據參數的值向聯絡人新增標籤。 您可以選擇刪除多個標籤,並用逗號分隔它們。

最佳實踐

建立新標籤時,最好定義簡短但有意義且易於識別的名稱。 理想情況下,您希望其他人能夠理解與使用者相關的標籤。

透過使用實體填滿槽,您可以選擇動態建立新的標籤。 但是,不建議這樣做,因為這會很快導致標籤污染。

為了減少標籤污染,請盡量不要標記得太具體或太多,以將標籤數量保持在最低限度。

當使用標籤追蹤使用者的主題興趣時,您可以在具有相同主題的多個意圖中使用相同的標籤。 這可以識別用戶具有特定的興趣或關注,同時減少標籤污染。

關閉機器人

Dialogflow Bot 可從 收件匣模組 手動開啟/關閉,並自動使用 工作流程。 除此之外,還可以使用 Dialogflow 意圖中的參數關閉機器人。

使用 Dialogflow 意圖關閉聯絡人'的機器人狀態,以便在機器人工作流程中建立人工交接。

當為聯絡人停用 Bot 時,不會向 Dialogflow 傳遞任何訊息。 停用 Bot 的聯絡人將出現在平台上儀表板中的 未分配部分下。

使用機器人狀態參數

使用 RB_BOTSTATUS,您可以透過將值設為 false來關閉特定使用者的機器人。

最佳實踐

Fallback 意圖不包含新增參數的地方。 從 Dialogflow 關閉機器人時,您應該在 Fallback 意圖中創建一個快速回复,詢問聯絡人是否想與人交談。 如果聯絡人以 快速回復做出回應,則應將他們帶到帶有 RB_BOTSTATUS 參數的意圖。

當使用此參數停用機器人時,您可能還想使用 RB_MARKDONE 更新平台上的使用者狀態,並使用 RB_NOTIFY 參數在單一意圖內向平台上發送通知。

結束對話

分配和關閉對話系統 為所有新聯絡人和所有有新訊息的聯絡人開啟新對話。 這可確保所有需要協助的聯絡人都會出現在 未分配清單中。

預設情況下,平台將為所有新聯絡人和發送新訊息的聯絡人開啟新的對話。

可在 聯絡人模組收件匣模組中手動為聯絡人開啟或關閉對話,使用 工作流程以程式設計方式開啟或關閉對話,以及意圖使用 Dialog 程式中使用的參數。

若要關閉 Dialogflow 中聯絡人的對話,請使用 Dialogflow Intent 中的 RB_MARKDONE 參數。

使用標記完成參數

若要關閉聯絡人的對話,請使用 Dialogflow 意圖中的 RB_MARKDONE 參數,並將數值設為 true

任何使用 RB_MARKDONE 參數且值為 true 觸發意圖的聯絡人將在 respond.io 平台上關閉對話。

最佳實踐

預設情況下,所有新聯絡人和有新訊息的聯絡人都會開啟新對話。 對於觸發時不需要人工代理的意圖,您'會想要將新增 RB_MARKDONE 設定為 true

您可能需要考慮將此意圖與 RB_NOTIFY 結合使用,以在為聯絡人開啟對話時觸發通知。 通知訊息可用於傳遞有關特定聯絡人需要做什麼的資訊。

分配

若要從 Dialogflow 將聯絡人指派給用戶,請使用 Dialogflow Intent 中的 RB_USER_ASSIGN 參數。

使用賦值參數

若要將聯絡人指派給用戶,請使用 Dialogflow 意圖中的 RB_USER_ASSIGN 參數,並將該值設定為您希望指派的平台使用者的電子郵件。

任何使用 RB_USER_ASSIGN 參數並在值中包含有效使用者電子郵件的聯絡人都會在 respond.io 平台上指派給該使用者。

發送自訂通知

預設情況下,當聯絡人發送新訊息時, 通知系統 會向平台用戶發送通知。 可以使用 Dialogflow Intents 中的參數建立其他通知並將其傳送給平台使用者。

若要向平台使用者發送通知,請使用 Dialogflow Intent 中的 RB_NOTIFY 參數。

使用通知參數

可以使用 RB_NOTIFY 作為參數名稱向平台發送通知。 此參數的值將作為通知發送。

提示: 您可以輸入 $dynamic.variable 在參數值中使用 動態變數

最佳實踐

使用 $contact.name 動態變數以便讓平台使用者知道哪個聯絡人需要關注。

使用 RB_NOTIFY 連同 RB_BOTSTATUSRB_MARKDONE 確保聯絡人獲得所需的關注。

提示: 在此了解更多關於 平台上通知工作原理的更多資訊。

取消訂閱

時不時地,你會收到一封聯絡簡訊 "STOP"。 這可能是因為他們不再想接收 廣播。 在 Dialogflow 中將 RB_SUBSCRIBE 設定為 false 將取消訂閱聯絡人的所有未來廣播。

機器人回應和直接訊息不會受到影響。

使用訂閱參數

使用 RB_SUBSCRIBE,您可以透過將數值分別設為 truefalse 來訂閱或取消訂閱機器人的聯絡人。 已取消訂閱的聯絡人將被排除在未來的平台廣播之外。

最佳實踐

如果您使用 RB_SUBSCRIBE 參數來管理廣播權限,則應在 respond.io 中建立一個自訂欄位來顯示聯絡人'的訂閱狀態。 這可以透過將 RB_FIELD_[NAME] 參數與 RB_SUBSCRIBE結合使用來實現。

聯絡人欄位和值

聯絡人' 資訊可以以聯絡人欄位值的形式儲存在其中。

除了預設欄位之外,還可以在設定模組中加入 自訂欄位 ,刪除 & 。 也可以從 Dialogflow 建立新的自訂欄位。

如果您在 Dialogflow 中使用字段參數,而平台中不存在對應的自訂字段,則會建立新的自訂字段。

可以在 聯絡人模組收件匣模組中手動更改聯絡人欄位值,使用 工作流程以程式設計方式更改,或使用 Dialogflow 意圖中的參數。

使用字段參數

設定字段值

您可以使用 RB_FIELD_[FIELD_ID] 編輯聯絡人'的自訂欄位值,其中「[FIELD_ID]」取代為自訂欄位的 ID。 自訂欄位 ID 作為 SNAKE_CASING 中的自訂欄位的名稱產生。 自訂欄位的值將被設定為參數中的值。 例如,如果您正在收集聯絡人的血型,並且聯絡人的血型為 AB 陽性,則您可以發送參數 RB_FIELD_BLOODTYPE 及其值 AB+。

提示: 您可以將自訂欄位值用作 動態變數

預設字段

對任何預設聯絡人欄位都可以執行相同的操作。 例如,參數 RB_FIELD_PHONE 可用於更新聯絡人'的電話號碼的值。

預設情況下,respond.io 上的聯絡人具有以下聯絡人欄位:

欄位名稱

ID

描述

聯絡人的名字

聯絡人的姓氏

姓名

全名

聯絡人的全名,即名字 + 姓氏

電子郵箱

電子郵件

聯絡人的電子郵件地址

電話號碼

電話

聯絡人的電話號碼

語言

語言

聯絡方式

這些預設欄位會在首次建立聯絡人時使用頻道提供的可用資訊自動填入。

清除字段

若要清除聯絡人的欄位值,您可以使用參數 RB_REMOVEFIELDS。 該值將是您想要刪除的欄位的名稱。 您可以選擇一次清除多個字段,用逗號分隔它們。

快速回復

Snippets 系統用於儲存 respond.io 平台上常用的回應內容。

可以在 收件匣模組 中手動傳送片段以減少輸入,或使用 Dialogflow Intents 中的參數傳送。

透過在 Dialogflow Agent 中傳送程式碼片段,您可以將意圖回應的內容儲存在 respond.io 平台上,以便在該平台上輕鬆管理和編輯它們。

多個意圖也可以使用相同的 Snippet。 在這種情況下,編輯 Snippet 將更新所有 Intent 的回應內容。

若要使用 Dialogflow Intents 傳送 Snippet,請使用 RB_SNIPPET 參數。 觸發的 Intent 將使用 Snippet 內容進行回應。

使用 Snippet 參數

使用 RB_SNIPPET,您可以傳送一個 Snippet 作為回應。 將參數的值設定為您想要傳送的 Snippet ID

更新或更改 Snippet 的名稱或內容將保留現有的 Snippet ID。

傳送文件

可以在 收件匣模組 中手動傳送文件,也可以使用 Dialogflow Intents 中的參數傳送。

使用 RB_FILE 參數,您可以將儲存在 檔案管理員 中的檔案傳送給觸發 Dialogflow Intent 的聯絡人。

使用文件參數

在傳送檔案之前,您必須將檔案上傳到 respond.io 檔案管理器。 然後使用 RB_FILE 參數和 檔案 ID 作為值將檔案傳送給聯絡人。

只會傳送上傳到與 Dialogflow 連線的空間的檔案。 上傳到其他空間的文件將不會發送給聯絡人。

分享這篇文章
Telegram
Facebook
Linkedin
Twitter

相關文章

Dialogflow:自訂負載
了解 respond.io 上支援的自訂有效負載。
Dialogflow 概述
了解如何將 Dialogflow 與 respond.io 結合使用。
Dialogflow:履行 Webhook 請求
了解如何使用 finishment webhook 請求將資料從 respond.io 傳遞到 Dialogflow。
Dialogflow:回應模板
了解如何使用回覆範本向聯絡人發送回覆。
Dialogflow:管理意圖
透過配置意圖來個性化聊天機器人的回應。

找不到您想要的東西? 🔎