Dialogflow: พารามิเตอร์

Respond.io ใช้พารามิเตอร์ Dialogflow แบบกำหนดเองเพื่อปรับปรุงฟังก์ชันของแอปพลิเคชัน'เพื่อรองรับกรณีการใช้งานที่หลากหลาย

ใน Dialogflow พารามิเตอร์มักใช้เพื่อเชื่อมโยงคำและวลีในการตอบสนองของผู้ใช้ต่อเอนทิตี ดังนั้นถ้ามีใครพูดว่า "วันเกิดของฉันคือวันที่ 13 มีนาคม" วลี "13 มีนาคม" จะถูกตรวจพบโดยอัตโนมัติและถือเป็นหน่วยวันที่ คุณสามารถอ่านเพิ่มเติมเกี่ยวกับพารามิเตอร์ได้ใน Dialogflow บนหน้าเอกสาร

ด้วยแพลตฟอร์ม respond.io คุณสามารถใช้พารามิเตอร์เพื่อครอบคลุมกรณีการใช้งานได้มากขึ้น คุณสามารถใช้สิ่งเหล่านี้เพื่อบันทึกและรวบรวมข้อมูลที่ผู้ติดต่อของคุณให้มาได้ เช่น กำหนดแท็กแบบไดนามิก, ตั้งค่าฟิลด์ที่กำหนดเอง คุณยังสามารถ แจ้งตัวแทนฝ่ายสนับสนุน ได้เมื่อผู้ติดต่อต้องการความช่วยเหลือ คุณยังสามารถใช้แพลตฟอร์ม respond.io เพื่อ จัดเก็บและจัดการคำตอบเจตนาของคุณได้อย่างง่ายดาย

คุณสามารถบรรลุผลได้มากมายเมื่อคุณใช้แพลตฟอร์ม respond.io ร่วมกับพารามิเตอร์ Intent ของ Dialogflow

การอ้างอิงพารามิเตอร์

รายการพารามิเตอร์ที่คุณสามารถใช้บน Dialogflow เพื่อสื่อสารกับแพลตฟอร์ม respond.io

ชื่อพารามิเตอร์	ค่า	คำอธิบาย
​RB_เพิ่มแท็ก​	แท็ก1, [แท็ก2, ...]	เพิ่มแท็กที่ระบุลงในโปรไฟล์ผู้ติดต่อบนแพลตฟอร์ม respond.io
​RB_ลบแท็ก​	แท็ก1, [แท็ก2, ...]	ลบแท็กที่ระบุออกจากโปรไฟล์การติดต่อบนแพลตฟอร์ม response.io
สถานะ RB_BOT	เท็จ	ปิดบอทสำหรับการติดต่อที่เฉพาะเจาะจง สิ่งนี้มีประโยชน์ในกรณีที่คุณต้องการส่งการสนทนาจากบอทไปยังมนุษย์
​RB_MARKเสร็จสิ้น​	จริง/เท็จ	เปิดหรือปิดการสนทนาสำหรับผู้ติดต่อ สิ่งนี้มีประโยชน์สำหรับการสนับสนุน เปิดการสนทนาสำหรับผู้ติดต่อที่ยังคาดหวังบางอย่าง ในขณะที่การปิดการสนทนาแสดงถึงผู้ติดต่อที่ได้รับการตอบรับแล้ว
​RB_แจ้งเตือน​	ข้อความแจ้งเตือน	ส่งการแจ้งเตือนไปยังมนุษย์บนแพลตฟอร์ม respond.io พร้อมด้วยข้อความแจ้งเตือน
​RB_SUBSCRIBE​	จริง/เท็จ	สมัครหรือยกเลิกการสมัครผู้ติดต่อ ผู้ติดต่อที่ยกเลิกการสมัครจะไม่ได้รับข้อความออกอากาศ
​RB_FIELD_ชื่อแรก​	ค่า	กรอกช่องชื่อจริงของโปรไฟล์ผู้ติดต่อด้วยค่าที่ระบุ
นามสกุล RB_FIELD	ค่า	กรอกช่องนามสกุลของโปรไฟล์ผู้ติดต่อด้วยค่าที่ระบุ
​RB_FIELD_ชื่อเต็ม​	ค่า	กรอกช่องชื่อเต็มของโปรไฟล์ผู้ติดต่อด้วยค่าที่ระบุ
​RB_FIELD_อีเมล​	ค่า	กรอกช่องที่อยู่อีเมลของโปรไฟล์ผู้ติดต่อด้วยค่าที่ระบุ
​RB_FIELD_PHONE​	ค่า	กรอกช่องหมายเลขโทรศัพท์ของโปรไฟล์ผู้ติดต่อด้วยค่าที่ระบุ
ภาษาฟิลด์ RB	ค่า	กรอกข้อมูลในช่องภาษาของโปรไฟล์ผู้ติดต่อด้วยค่าที่ระบุ เช่น en-us
​RB_FIELD_[ชื่อ]​	ค่า	เพิ่มฟิลด์ที่กำหนดเองลงในโปรไฟล์ผู้ติดต่อ'ด้วยค่าที่ระบุ เหมาะที่สุดสำหรับข้อมูลที่ไม่เป็นไดนามิก เช่น อีเมล วันเกิด เป็นต้น
​RB_REMOVEFIELDS​	ฟิลด์1, [ฟิลด์2, ...]	ลบฟิลด์ที่กำหนดเองที่ระบุจากรายชื่อติดต่อบนแพลตฟอร์ม
​RB_USER_กำหนด​	ค่า	กำหนดผู้ติดต่อให้กับผู้ใช้หนึ่งรายในทีมของคุณ
​RB_สนิปเพต​	รหัสสไนปเป็ต	ส่ง Snippet ที่ระบุไปยังผู้ติดต่อ
ไฟล์ RB	รหัสไฟล์	ส่งไฟล์ที่ระบุที่เก็บไว้บนแพลตฟอร์มไปยังผู้ติดต่อ

การแท็ก

ข้อมูลการติดต่อ' สามารถจัดเก็บในรูปแบบแท็กได้ คุณสามารถเพิ่ม/ลบแท็กด้วยตนเองได้ในโมดูลรายชื่อติดต่อ หรือโมดูลกล่องจดหมาย เพิ่ม/ลบด้วยโปรแกรมโดยใช้เวิร์กโฟลว์ และเพิ่ม/ลบโดยใช้พารามิเตอร์ในอินเทนต์ของ Dialogflow

สิ่งสำคัญ: แท็กใช้สำหรับการแบ่งกลุ่มผู้ชมในการออกอากาศ โปรดคำนึงถึงสิ่งนี้เมื่อเพิ่ม/ลบแท็กโดยใช้เจตนาของ Dialogflow

การใช้พารามิเตอร์แท็ก

การเพิ่มแท็ก

เมื่อใช้พารามิเตอร์ RB_ADDTAGS คุณสามารถกำหนดแท็กให้กับผู้ติดต่อได้ แท็กจะถูกเพิ่มให้กับผู้ติดต่อตามค่าของพารามิเตอร์ คุณมีตัวเลือกที่จะเพิ่มแท็กหลายรายการได้โดยคั่นด้วยเครื่องหมายจุลภาค

โปรดทราบว่าชื่อแท็กไม่สามารถมีช่องว่างได้ คุณอาจต้องการใช้เครื่องหมายขีดล่างแทน

การลบแท็ก

เมื่อใช้พารามิเตอร์ RB_REMOVETAGS คุณสามารถลบแท็กออกจากผู้ติดต่อได้ แท็กจะถูกเพิ่มให้กับผู้ติดต่อตามค่าของพารามิเตอร์ คุณมีตัวเลือกในการลบแท็กหลายรายการโดยคั่นด้วยเครื่องหมายจุลภาค

แนวทางปฏิบัติที่ดีที่สุด

เมื่อสร้างแท็กใหม่ ควรกำหนดชื่อสั้นๆ แต่มีความหมายที่สามารถระบุได้ง่าย ในทางอุดมคติ คุณคงต้องการให้คนอื่นสามารถเข้าใจแท็กที่เกี่ยวข้องกับผู้ใช้ได้

ด้วยการเติมช่องโดยใช้เอนทิตี คุณมีตัวเลือกในการสร้างแท็กใหม่แบบไดนามิก อย่างไรก็ตาม ไม่แนะนำให้ทำเช่นนี้ เนื่องจากจะทำให้เกิดมลภาวะทางแท็กได้อย่างรวดเร็ว

เพื่อลดมลภาวะจากแท็ก พยายามอย่าแท็กให้เฉพาะเจาะจงหรือใจกว้างเกินไป เพื่อให้มีแท็กจำนวนน้อยที่สุด

เมื่อใช้แท็กเพื่อติดตามความสนใจหัวข้อของผู้ใช้ คุณสามารถใช้แท็กเดียวกันในหลายเจตนาที่มีหัวข้อเดียวกันได้ สิ่งนี้สามารถระบุได้ว่าผู้ใช้มีความสนใจหรือข้อกังวลเฉพาะเจาะจงในขณะที่ลดมลพิษแท็ก

การปิดบอท

สามารถเปิด/ปิด Dialogflow Bot ได้ด้วยตนเองจาก Inbox Module และใช้ Workflowsโดยอัตโนมัติ นอกจากนั้นยังสามารถปิดบอทได้โดยใช้พารามิเตอร์ในอินเทนต์ของ Dialogflow อีกด้วย

การใช้เจตนาของ Dialogflow เพื่อปิดสถานะบอทของผู้ติดต่อ'สามารถใช้เพื่อสร้างการส่งต่อข้อมูลโดยมนุษย์ในเวิร์กโฟลว์บอทของคุณได้

เมื่อปิดใช้งานบอทสำหรับผู้ติดต่อ จะไม่มีข้อความใดถูกส่งไปยัง Dialogflow ผู้ติดต่อที่ปิดการใช้งาน Bot จะปรากฏบนแพลตฟอร์มภายใต้ส่วนที่ไม่ได้รับมอบหมาย ในแดชบอร์ด

การใช้พารามิเตอร์สถานะบอท

ด้วย RB_BOTSTATUSคุณสามารถปิดบอทสำหรับผู้ใช้ที่ต้องการได้โดยตั้งค่าเป็น false

แนวทางปฏิบัติที่ดีที่สุด

จุดประสงค์ของ Fallback ไม่ได้รวมถึงสถานที่สำหรับเพิ่มพารามิเตอร์ เมื่อปิดการใช้งานบ็อตจาก Dialogflow คุณควรสร้างการตอบกลับอย่างรวดเร็วในเจตนาสำรองโดยถามผู้ติดต่อว่าต้องการคุยกับมนุษย์หรือไม่ หากผู้ติดต่อตอบกลับด้วยคำตอบด่วน ใช่ นั่นควรนำผู้ติดต่อไปสู่จุดมุ่งหมายด้วยพารามิเตอร์ RB_BOTSTATUS

เมื่อใช้พารามิเตอร์นี้เพื่อปิดการใช้งานบอท คุณอาจต้องการอัพเดตสถานะผู้ใช้บนแพลตฟอร์มด้วย RB_MARKDONE และส่งการแจ้งเตือนบนแพลตฟอร์มด้วยพารามิเตอร์ RB_NOTIFY ภายในเจตนาเดียว

การปิดการสนทนา

ระบบการมอบหมายและการปิดการสนทนา จะเปิดการสนทนาใหม่สำหรับผู้ติดต่อใหม่ทั้งหมด และผู้ติดต่อทั้งหมดที่มีข้อความใหม่ วิธีนี้จะทำให้แน่ใจว่าผู้ติดต่อทั้งหมดที่ต้องการความช่วยเหลือจะปรากฏในรายชื่อที่ไม่ได้รับมอบหมาย

โดยค่าเริ่มต้น แพลตฟอร์มจะเปิดการสนทนาใหม่สำหรับผู้ติดต่อใหม่ทั้งหมดและผู้ติดต่อที่ส่งข้อความใหม่

การสนทนาสามารถเปิดหรือปิดสำหรับผู้ติดต่อได้ด้วยตนเองใน โมดูลผู้ติดต่อ หรือ โมดูลกล่องข้อความ เปิดหรือปิดโดยอัตโนมัติด้วย เวิร์กโฟลว์ และปิดด้วยพารามิเตอร์ในเจตนา Dialogflow.

หากต้องการปิดการสนทนาของผู้ติดต่อจาก Dialogflow ให้ใช้พารามิเตอร์ RB_MARKDONE ใน Dialogflow Intent(s) ของคุณ

การใช้พารามิเตอร์ทำเครื่องหมายเสร็จสิ้น

หากต้องการปิดการสนทนาของผู้ติดต่อ ให้ใช้พารามิเตอร์ RB_MARKDONE ในอินเทนต์ Dialogflow ของคุณ และตั้งค่าเป็น true

ผู้ติดต่อใดก็ตามที่กระตุ้นเจตนาโดยใช้พารามิเตอร์ RB_MARKDONE ที่มีค่า true การสนทนาจะถูกปิดบนแพลตฟอร์ม respond.io

แนวทางปฏิบัติที่ดีที่สุด

โดยค่าเริ่มต้น ผู้ติดต่อใหม่ทั้งหมดและผู้ติดต่อที่มีข้อความใหม่จะเปิดการสนทนาใหม่ คุณจะต้องตั้งค่าเพิ่ม RB_MARKDONE เป็น true สำหรับเจตนาที่ไม่ต้องการตัวแทนมนุษย์เมื่อถูกเรียกใช้งาน

คุณอาจต้องการพิจารณาใช้เจตนานี้ควบคู่ไปกับ RB_NOTIFY เพื่อทริกเกอร์การแจ้งเตือนเมื่อมีการเปิดการสนทนาสำหรับผู้ติดต่อ ข้อความแจ้งเตือนสามารถใช้เพื่อส่งต่อข้อมูลเกี่ยวกับสิ่งที่ต้องทำสำหรับผู้ติดต่อรายนั้น ๆ

การมอบหมาย

หากต้องการกำหนดผู้ติดต่อให้กับผู้ใช้จาก Dialogflow ให้ใช้พารามิเตอร์ RB_USER_ASSIGN ใน Dialogflow Intent(s) ของคุณ

การใช้พารามิเตอร์การกำหนดค่า

ในการกำหนดผู้ติดต่อให้กับผู้ใช้ ให้ใช้พารามิเตอร์ RB_USER_ASSIGN ในเจตนารมณ์ของ Dialogflow และตั้งค่าเป็นอีเมลของผู้ใช้แพลตฟอร์มที่คุณต้องการกำหนด

ผู้ติดต่อใดๆ ที่กระตุ้นเจตนาโดยใช้พารามิเตอร์ RB_USER_ASSIGN พร้อมด้วยอีเมลผู้ใช้ที่ถูกต้องในค่า จะได้รับมอบหมายให้กับผู้ใช้นั้นบนแพลตฟอร์ม respond.io

การส่งการแจ้งเตือนที่กำหนดเอง

โดยค่าเริ่มต้น ระบบการแจ้งเตือน จะส่งการแจ้งเตือนไปยังผู้ใช้แพลตฟอร์มเมื่อผู้ติดต่อส่งข้อความใหม่ สามารถสร้างและส่งการแจ้งเตือนเพิ่มเติมให้กับผู้ใช้แพลตฟอร์มได้โดยใช้พารามิเตอร์ใน Dialogflow Intents

หากต้องการส่งการแจ้งเตือนไปยังผู้ใช้แพลตฟอร์ม ให้ใช้พารามิเตอร์ RB_NOTIFY ใน Intent ของ Dialogflow ของคุณ

การใช้พารามิเตอร์การแจ้งเตือน

สามารถส่งการแจ้งเตือนไปยังแพลตฟอร์มได้โดยใช้ RB_NOTIFY เป็นชื่อพารามิเตอร์ ค่าพารามิเตอร์จะถูกส่งเป็นการแจ้งเตือน

เคล็ดลับ: คุณสามารถใช้ ตัวแปรไดนามิก ในค่าของพารามิเตอร์ได้โดยพิมพ์ $dynamic.variable.

แนวทางปฏิบัติที่ดีที่สุด

ใช้ตัวแปรไดนามิก $contact.name เพื่อให้ผู้ใช้แพลตฟอร์มทราบว่าผู้ติดต่อรายใดที่ต้องการความสนใจ

ใช้ RB_NOTIFY ร่วมกับ RB_BOTSTATUS และ RB_MARKDONE เพื่อให้แน่ใจว่าผู้ติดต่อได้รับความสนใจที่พวกเขาต้องการ

เคล็ดลับ: เรียนรู้เพิ่มเติมเกี่ยวกับ วิธีการทำงานของการแจ้งเตือนบนแพลตฟอร์มที่นี่

การยกเลิกการสมัคร

ทุกๆ ครั้ง คุณจะได้รับข้อความติดต่อที่คุณ "หยุด" เป็นไปได้มากว่าพวกเขาไม่ต้องการรับการออกอากาศ อีกต่อไป การตั้งค่า RB_SUBSCRIBE เป็น false ใน Dialogflow จะยกเลิกการสมัครผู้ติดต่อจากการออกอากาศในอนาคตทั้งหมด

การตอบกลับของบอทและข้อความโดยตรงจะไม่ได้รับผลกระทบ

การใช้พารามิเตอร์การสมัครสมาชิก

ด้วย RB_SUBSCRIBEคุณสามารถสมัครหรือยกเลิกการสมัครติดต่อกับบอทโดยตั้งค่าเป็น true หรือ false ตามลำดับ ผู้ติดต่อที่ยกเลิกการสมัครจะไม่ได้รับการยกเว้นจากการออกอากาศบนแพลตฟอร์มในอนาคต

แนวทางปฏิบัติที่ดีที่สุด

หากคุณใช้พารามิเตอร์ RB_SUBSCRIBE เพื่อจัดการสิทธิ์ในการออกอากาศ คุณควรสร้างฟิลด์แบบกำหนดเองใน respond.io เพื่อแสดงสถานะการสมัครรับข้อมูลของผู้ติดต่อ' สามารถทำได้โดยใช้พารามิเตอร์ RB_FIELD_[NAME] ร่วมกับ RB_SUBSCRIBE

ช่องทางการติดต่อและค่านิยม

ข้อมูลผู้ติดต่อ' สามารถจัดเก็บในรูปแบบค่าในช่องผู้ติดต่อได้

นอกจากฟิลด์เริ่มต้นแล้ว ฟิลด์ที่กำหนดเอง สามารถเพิ่ม & ลบได้ในโมดูลการตั้งค่า. สามารถสร้างฟิลด์ที่กำหนดเองใหม่จาก Dialogflow ได้

หากคุณใช้พารามิเตอร์ฟิลด์ใน Dialogflow และไม่มีฟิลด์ที่กำหนดเองที่สอดคล้องกันในแพลตฟอร์ม ระบบจะสร้างฟิลด์ที่กำหนดเองใหม่

ค่าฟิลด์ข้อมูลติดต่อสามารถเปลี่ยนแปลงได้ด้วยตนเองใน Contacts Module หรือ Inbox Moduleเปลี่ยนแปลงโดยการเขียนโปรแกรมโดยใช้ Workflowsหรือเปลี่ยนแปลงโดยใช้พารามิเตอร์ใน Intents ของ Dialogflow

การใช้พารามิเตอร์ฟิลด์

การตั้งค่าค่าฟิลด์

คุณสามารถแก้ไขค่าฟิลด์แบบกำหนดเองของผู้ติดต่อ'ด้วย RB_FIELD_[FIELD_ID] โดยที่ “[FIELD_ID]” จะถูกแทนที่ด้วย ID ของฟิลด์แบบกำหนดเอง ID ฟิลด์ที่กำหนดเองจะสร้างขึ้นเป็นชื่อของฟิลด์ที่กำหนดเองใน SNAKE_CASING ค่าของฟิลด์ที่กำหนดเองจะถูกตั้งค่าเป็นค่าในพารามิเตอร์ ตัวอย่างเช่น หากคุณกำลังรวบรวมหมู่เลือดของ Contacts และ Contact คนหนึ่งมีหมู่เลือด AB บวก คุณจะส่งพารามิเตอร์ RB_FIELD_BLOODTYPE พร้อมค่า AB+

เคล็ดลับ: คุณสามารถใช้ค่าฟิลด์ที่กำหนดเองเป็นตัวแปรไดนามิก ได้

ฟิลด์ค่าเริ่มต้น

สามารถดำเนินการแบบเดียวกันได้กับฟิลด์ติดต่อเริ่มต้นใดๆ ตัวอย่างเช่น พารามิเตอร์ RB_FIELD_PHONE สามารถใช้เพื่ออัปเดตค่าหมายเลขโทรศัพท์ของผู้ติดต่อ'ได้

โดยค่าเริ่มต้น ผู้ติดต่อใน respond.io จะมีช่องผู้ติดต่อดังต่อไปนี้:

ชื่อฟิลด์	บัตรประจำตัว	คำอธิบาย
ชื่อจริง	ชื่อจริง	ชื่อผู้ติดต่อ
นามสกุล	นามสกุล	นามสกุลของผู้ติดต่อ
ชื่อ-นามสกุล	ชื่อ-นามสกุล	ชื่อเต็มของผู้ติดต่อ คือ ชื่อจริง + นามสกุล
ที่อยู่อีเมล	อีเมล	ที่อยู่อีเมลของผู้ติดต่อ
หมายเลขโทรศัพท์	โทรศัพท์	เบอร์โทรศัพท์ของผู้ติดต่อ
ภาษา	ภาษา	ภาษาของการติดต่อ

ฟิลด์เริ่มต้นเหล่านี้จะถูกกรอกโดยอัตโนมัติโดยใช้ข้อมูลที่มีอยู่ที่ให้ไว้โดยช่องทางเมื่อสร้างผู้ติดต่อเป็นครั้งแรก

การเคลียร์ฟิลด์

หากต้องการล้างค่าฟิลด์สำหรับผู้ติดต่อ คุณสามารถใช้พารามิเตอร์ RB_REMOVEFIELDS ค่าจะเป็นชื่อของฟิลด์ที่คุณต้องการลบ คุณมีทางเลือกในการล้างช่องข้อมูลหลายช่องพร้อมกันได้ด้วยการคั่นด้วยเครื่องหมายจุลภาค

เกร็ดเล็กเกร็ดน้อย

ระบบ Snippets ใช้เพื่อจัดเก็บเนื้อหาของการตอบกลับที่ใช้ทั่วไปบนแพลตฟอร์ม respond.io

สามารถส่งออกส่วนสั้นๆ ได้ด้วยตนเองในโมดูลกล่องจดหมาย เพื่อลดการพิมพ์หรือการส่งโดยใช้พารามิเตอร์ใน Dialogflow Intents

ด้วยการส่ง Snippets ใน Dialogflow Agent คุณจะสามารถจัดเก็บเนื้อหาการตอบกลับ Intent บนแพลตฟอร์ม respond.io ซึ่งสามารถจัดการและแก้ไขได้อย่างง่ายดาย

เจตนาหลายอย่างสามารถใช้ Snippet เดียวกันได้ ในกรณีนี้ การแก้ไข Snippet จะอัปเดตเนื้อหาของการตอบสนองในทุก Intent

หากต้องการส่ง Snippet โดยใช้ Dialogflow Intents ให้ใช้พารามิเตอร์ RB_SNIPPET เจตนาการกระตุ้นจะตอบสนองด้วยเนื้อหาของ Snippet

การใช้พารามิเตอร์ Snippet

ด้วย RB_SNIPPETคุณสามารถส่ง Snippet เป็นการตอบกลับได้ ตั้งค่าของพารามิเตอร์เป็น Snippet ID ที่คุณต้องการส่ง

การอัปเดตหรือเปลี่ยนชื่อหรือเนื้อหาของ Snippet จะรักษา ID Snippet ที่มีอยู่ไว้

การส่งไฟล์

สามารถส่งไฟล์ด้วยตนเองได้ใน Inbox Module หรือส่งโดยใช้พารามิเตอร์ใน Dialogflow Intents

เมื่อใช้พารามิเตอร์ RB_FILE คุณสามารถส่งไฟล์ที่จัดเก็บไว้ใน File Manager ไปยังผู้ติดต่อที่ทริกเกอร์ Dialogflow Intent ได้

การใช้พารามิเตอร์ไฟล์

ก่อนที่คุณจะส่งไฟล์ คุณต้องอัปโหลดไฟล์ไปยังตัวจัดการไฟล์ respond.io จากนั้นใช้พารามิเตอร์ RB_FILE พร้อมด้วย ID ไฟล์ เป็นค่าเพื่อส่งไฟล์ไปยังผู้ติดต่อ

จะส่งเฉพาะไฟล์ที่อัพโหลดไปยังพื้นที่ที่เชื่อมต่อกับ Dialogflow เท่านั้น ไฟล์ที่อัพโหลดไปยังพื้นที่อื่นจะไม่ถูกส่งไปยังผู้ติดต่อ

​