Input Variable — ข้อมูลของลูกค้าที่ Agent ใช้พูด
ตัวแปรคือช่องว่างที่เปลี่ยนค่าตามลูกค้าแต่ละคน ทำให้ Agent พูดได้เสมือนรู้จักลูกค้าคนนั้นจริง
Variable คืออะไร
Variable (ตัวแปร) คือช่องสำหรับเก็บข้อมูลของลูกค้าแต่ละคน ที่ Agent จะนำไปใช้พูดในระหว่างสนทนา
เปรียบเทียบให้เห็นภาพ: เปรียบได้กับ การ์ดเชิญงานแต่งงาน ที่พิมพ์เป็นจำนวนหลายพันใบ โดยเนื้อหาเหมือนกันทุกใบ คือ "เรียน คุณ ______" แต่ ช่องเว้นว่าง จะเปลี่ยนไปตามแขกแต่ละคน Variable ก็คือช่องเว้นว่างดังกล่าว เมื่อ Agent โทรหาคุณสมชาย ช่องว่างจะแสดงเป็น "สมชาย" และเมื่อโทรหาคุณมาลี ก็จะแสดงเป็น "มาลี"
ใน Prompt (บทบาทและคำสั่งสำหรับ Agent) จะเขียน Variable ในรูปแบบ {{ชื่อตัวแปร}} เช่น {{customer_name}}
เมื่อ Agent โทรจริง Gowajee จะ แทนค่า ข้อมูลลงในประโยคให้โดยอัตโนมัติ
ประเภทของ Variable ทั้ง 3 ประเภท
| ประเภท | ใช้กับ | ตัวอย่าง |
|---|---|---|
text (ข้อความ) | ชื่อ, รายละเอียด, ข้อความทั่วไป | customer_name, address, debt_detail |
number (ตัวเลข) | ยอดเงิน, จำนวน, อายุ | debt_amount, quantity, customer_age |
date (วันที่) | วันที่ครบกำหนด, วันนัด | debt_due_date, appointment_date |
Variable ปรากฏที่ใดบ้าง
Variable ตัวเดียวกันจะใช้งานร่วมกันใน 3 จุดที่เชื่อมโยงถึงกัน ดังนี้
ใน Flow Editor (เมนูด้านซ้าย)
ตำแหน่ง: Sidebar (แถบเมนูด้านซ้าย) แท็บ Variables
หน้าที่: ประกาศ Variable ที่จะใช้ โดยระบุชื่อและ Type
ดำเนินการเมื่อ: ออกแบบ Flow ในครั้งแรก
ใน Prompt ของ Node
ตำแหน่ง: ช่อง Prompt ของ Conversation Node หรือ End Node
หน้าที่: เรียกใช้ Variable ในประโยค
ตัวอย่าง: สวัสดีค่ะ คุณ {{customer_name}}
ในไฟล์ CSV ตอนสร้าง Campaign
ตำแหน่ง: ไฟล์ CSV ที่อัปโหลดเข้าสู่ Campaign (แคมเปญโทรออก)
หน้าที่: ใส่ค่าจริง ของลูกค้าแต่ละคนทีละแถว
ตัวอย่าง: คอลัมน์ customer_name มีค่าเป็น "สมชาย ใจดี" หรือ "มาลี สวยงาม"
เมื่อ Campaign โทรออก Gowajee จะอ่านค่าจาก CSV (จุดที่ 3) มาแทนที่ใน Prompt (จุดที่ 2) ตามชื่อ Variable ที่ประกาศไว้ (จุดที่ 1)
วิธีสร้าง Variable ใน Flow Editor
เปิดแท็บ Variables ใน Sidebar ด้านซ้าย
ในหน้า Flow Editor ทางด้านซ้ายจะมีหลายแท็บ ให้คลิกที่แท็บ Variables
กดปุ่ม + Add Variable
ปุ่ม + Add Variable อยู่บนสุดของแท็บ ให้กดเพื่อสร้าง Variable ตัวใหม่
ตั้งชื่อ Variable
กรอกชื่อในช่อง Name โดยมีข้อกำหนด ดังนี้
- ใช้ ภาษาอังกฤษตัวพิมพ์เล็ก เท่านั้น
- ใช้ เครื่องหมาย _ (underscore) คั่นระหว่างคำ เช่น
customer_nameไม่ใช่customer name - ห้ามขึ้นต้นด้วย ตัวเลข หรือ เครื่องหมาย
- ห้ามมี ช่องว่าง หรือ เครื่องหมายพิเศษ (เช่น ! @ #)
ตัวอย่างชื่อที่ถูกต้อง: customer_name, debt_amount, appointment_date, callcenter_contact
ตัวอย่างชื่อที่ไม่ถูกต้อง: ชื่อลูกค้า (เป็นภาษาไทย), Customer Name (มีช่องว่าง), 2nd_name (ขึ้นต้นด้วยตัวเลข)
เลือก Type
เลือกจากรายการ (dropdown) ได้แก่ text / number / date
ให้เลือก Type ให้ตรงกับข้อมูลที่จะกรอก โดยหากเป็นตัวเลขให้เลือก number หากเป็นวันที่ให้เลือก date และข้อมูลอื่น ๆ ให้เลือก text
ใส่คำอธิบาย (Description)
ระบุว่า Variable นี้คือข้อมูลใด เช่น ยอดเงินที่ลูกค้าค้างชำระ หน่วยเป็นบาท
คำอธิบายนี้จะปรากฏใน CSV Template เมื่อสร้าง Campaign เพื่อให้ผู้ใช้คนอื่นทราบว่าต้องกรอกข้อมูลใด
กดปุ่ม Save
Variable ตัวใหม่จะปรากฏในรายการ และพร้อมใช้งานใน Prompt ได้ทันที
วิธีใช้ Variable ใน Prompt
ในช่อง Prompt ของ Conversation Node ให้พิมพ์ เครื่องหมาย {{ (วงเล็บปีกกาเปิดสองตัว) จากนั้นระบบจะแสดงรายการ (dropdown) Variable ทั้งหมดที่คุณประกาศไว้
เลือก Variable ที่ต้องการ จากนั้นระบบจะใส่ {{customer_name}} ลงในประโยคให้โดยอัตโนมัติ
ตัวอย่างประโยคที่มีการใส่ Variable
สวัสดีค่ะ คุณ {{customer_name}}
ทางธนาคารโทรมาเรื่องยอดค้างชำระจำนวน {{debt_amount}} บาท ที่ครบกำหนดวันที่ {{debt_due_date}}
ขอเรียนถามว่าสะดวกคุยตอนนี้ไหมคะ? สวัสดีค่ะ คุณสมชาย ใจดี ทางธนาคารโทรมาเรื่องยอดค้างชำระจำนวน หนึ่งหมื่นสองพันห้าร้อยบาท ที่ครบกำหนดวันที่สิบห้า มิถุนายน ขอเรียนถามว่าสะดวกคุยตอนนี้ไหมคะ?
ตัวอย่างการใช้งานจริง — Variable จาก Flow สู่ CSV สู่ประโยคที่ Agent พูด
สมมติว่าคุณสร้าง Agent สำหรับติดตามหนี้ และประกาศ Variable ไว้ 3 ตัวใน Flow Editor ดังนี้
| ชื่อ Variable | Type | คำอธิบาย |
|---|---|---|
customer_name | text | ชื่อ-นามสกุลของลูกค้า |
debt_amount | number | ยอดหนี้ค้างชำระ หน่วยเป็นบาท |
debt_due_date | date | วันที่ครบกำหนดชำระ (YYYY-MM-DD) |
เมื่อสร้าง Campaign และดาวน์โหลด CSV Template จะได้ไฟล์ที่มีลักษณะดังนี้
| tel | customer_name | debt_amount | debt_due_date |
|---|---|---|---|
| 0812345678 | สมชาย ใจดี | 12500 | 2026-06-15 |
| 0898765432 | มาลี สวยงาม | 5400 | 2026-06-20 |
เมื่อ Campaign โทรออก:
- สายแรก ค่า
customer_nameจะเป็น "สมชาย ใจดี",debt_amountจะเป็น 12500 และdebt_due_dateจะเป็น 2026-06-15 - สายที่สอง ค่าเหล่านี้จะเปลี่ยนเป็น "มาลี สวยงาม", 5400 และ 2026-06-20 ตามลำดับ
แม้จะใช้ Prompt เดียวกัน แต่ลูกค้าแต่ละคนจะได้ฟังประโยคที่ตรงกับข้อมูลของตนเอง
ข้อผิดพลาดที่พบบ่อย
❌ Agent อ่านชื่อตัวแปรเป็นตัวอักษรแทนที่จะเป็นค่า
ตัวอย่าง: Agent พูดว่า "สวัสดีค่ะ คุณ เคอรลี เบรซ คัสโตเมอร์ เนม"
สาเหตุ: ใน Prompt พิมพ์ {{customer_name}} ไว้ แต่ Variable ตัวนี้ ยังไม่ได้ประกาศ ในแท็บ Variables หรือสะกดชื่อไม่ตรงกัน
วิธีแก้: ไปที่แท็บ Variables เพื่อตรวจสอบว่ามีชื่อนี้อยู่จริง และสะกดให้ตรงกัน
❌ อัปโหลด CSV ไม่สำเร็จ (ขึ้นข้อความ Invalid columns)
สาเหตุ: ชื่อคอลัมน์ใน CSV กับชื่อ Variable ใน Flow ไม่ตรงกัน
วิธีแก้:
- ดาวน์โหลด CSV Template ใหม่จากหน้า Campaign เพื่อให้ได้ชื่อคอลัมน์ที่ถูกต้องเสมอ
- ห้ามเปลี่ยนชื่อคอลัมน์ในไฟล์
- ห้ามใช้ตัวพิมพ์ใหญ่ เนื่องจาก
Customer_Nameไม่เท่ากับcustomer_name
❌ Agent อ่านยอดเงินผิด (เช่น อ่าน 12,500 เป็น "หนึ่ง สอง จุด ห้า ศูนย์ ศูนย์")
สาเหตุ: ค่าใน CSV ใส่เครื่องหมายจุลภาค (คอมมา) คั่นหลักพัน ทั้งที่ Type เป็น number
วิธีแก้: ในคอลัมน์ที่เป็น number ให้ใส่เฉพาะตัวเลข เช่น 12500 ไม่ใช่ 12,500
❌ Agent อ่านวันที่ผิดพลาด
สาเหตุ: วันที่ใน CSV ไม่ได้อยู่ในรูปแบบ YYYY-MM-DD
วิธีแก้: ให้ใส่ในรูปแบบ 2026-06-15 เท่านั้น ห้ามใช้รูปแบบอื่น เช่น 15/6/26 หรือ 15 มิ.ย.