Function Node — เรียก API ระหว่างสนทนากับลูกค้า (Advance)

ชื่อนี้ใช้อ้างอิงภายในเท่านั้น จึงควรตั้งให้สื่อว่า Node นี้ทำหน้าที่อะไร

ตัวอย่างที่ดี: ดึงข้อมูลลูกค้าจาก CRM, ตรวจสอบยอดคงเหลือ, บันทึกนัดหมาย

ที่อยู่ URL ของ API ที่จะเรียก โดยขึ้นต้นด้วย https:// เสมอ

ตัวอย่าง: https://api.your-company.com/customers/12345

หากต้องใช้ค่าจาก Variable (ตัวแปร) ในบทสนทนา ให้ใส่ในรูปแบบ {{variable_name}} เช่น

https://api.your-company.com/customers/{{customer_phone}}

เลือกประเภทของคำสั่งที่ส่งไปยัง API โดยทั่วไปใช้เพียง 2 แบบ ได้แก่

• GET ใช้สำหรับ ดึงข้อมูล (เช่น ดูยอดเงิน หรือดูข้อมูลลูกค้า)
• POST ใช้สำหรับ ส่งข้อมูลเข้าไป หรือสร้างข้อมูลใหม่ (เช่น บันทึกนัดหมาย หรือสร้าง Lead)

ตัวเลือกอื่น (PUT, PATCH, DELETE) ใช้ในกรณีเฉพาะ หากไม่แน่ใจ ให้ปรึกษาทีมเทคนิคของคุณ

Headers คือข้อมูลที่ส่งไปเพื่อระบุแก่ API ว่าใครเป็นผู้เรียก และส่งข้อมูลในรูปแบบใด

ตัวอย่าง Headers ที่ใช้บ่อย:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

API Key คือรหัสลับที่ระบบของคุณออกให้แก่ Gowajee เพื่อยืนยันว่าเป็นการเรียกที่ได้รับอนุญาต เปรียบเสมือนกุญแจสำหรับเข้าระบบ

เนื้อหาข้อมูลที่ส่งไปยัง API โดยทั่วไปอยู่ในรูปแบบ JSON (รูปแบบมาตรฐานสำหรับการแลกเปลี่ยนข้อมูล)

ตัวอย่าง:

{
  "customer_name": "{{customer_name}}",
  "phone": "{{customer_phone}}",
  "appointment_date": "{{requested_date}}"
}

ใส่ Variable ในรูปแบบ {{variable_name}} เช่นเดียวกัน

ระบบของคุณจะตอบกลับมาในรูปแบบ JSON ให้ระบุแก่ Gowajee ว่าต้องการเก็บค่าใดไว้เป็น Variable เพื่อนำไปใช้ใน Node ถัดไป

ตัวอย่าง: API ตอบกลับมาดังนี้

{
  "name": "คุณสมชาย",
  "balance": 12500,
  "due_date": "2026-06-15"
}

ตั้งค่า Response Mapping:

• response.name → เก็บไว้ใน Variable customer_name
• response.balance → เก็บไว้ใน Variable debt_amount
• response.due_date → เก็บไว้ใน Variable debt_due_date

จากนั้น Conversation Node ถัดไปจะสามารถนำ Variable เหล่านี้ไปใช้สนทนาต่อได้ทันที

จาก Toolbar ด้านซ้าย ให้คลิกปุ่ม Function (Node สีม่วง) เพื่อเพิ่ม Node ลงบน Canvas โดยวางไว้หลัง Conversation Node ที่สอบถามหมายเลขของลูกค้า

ในช่อง Name ให้พิมพ์ ดึงข้อมูลลูกค้าจาก CRM

• URL: https://api.your-company.com/customers?phone={{customer_phone}}
• Method: GET

Authorization: Bearer sk_live_XXXXXXXXX
Content-Type: application/json

API Key (sk_live_...) ต้องขอจากทีมเทคนิคที่ดูแลระบบของคุณ

หาก API ตอบกลับดังนี้

{
  "name": "คุณสมชาย",
  "outstanding_balance": 12500,
  "promise_date": "2026-06-15"
}

ตั้งค่า Response Mapping:

• response.name → customer_name
• response.outstanding_balance → debt_amount
• response.promise_date → due_date

เมื่อ Function Node ดึงข้อมูลสำเร็จ ให้ส่งต่อไปยัง Conversation Node ที่จะนำ {{customer_name}} และ {{debt_amount}} ไปใช้สนทนาต่อ โดยลากเส้นจากจุด handle รอบ Function Node ไปยัง Conversation Node นั้น

ตัวอย่างเช่น Node "ทักทายลูกค้า" ใช้ Prompt: สวัสดีคุณ {{customer_name}} โทรมาแจ้งยอดค้างชำระ {{debt_amount}} บาท

ก่อน Publish ให้ใช้แท็บ Testing ใน Flow Editor เพื่อทดลองสนทนากับ Agent และตรวจสอบว่า Function Node ดึงข้อมูลได้ถูกต้องหรือไม่

ดูรายละเอียดเพิ่มเติม: Testing

ระบบของคุณอาจล่มชั่วคราว หรือเครือข่ายขัดข้อง โดย Gowajee จะรอผลตอบกลับสูงสุดตามค่า Timeout ที่ตั้งไว้

ค่าเริ่มต้นคือ 10 วินาที หากเกินกว่านี้ จะถือว่าล้มเหลว

ให้เพิ่ม Transition แบบ Error ใน Function Node โดยกำหนดให้ไปยัง Conversation Node สำรอง เช่น Node ที่กล่าวขอโทษลูกค้าและเสนอโอนสายไปยังเจ้าหน้าที่

ตัวอย่าง Transition:

• เมื่อ API สำเร็จ → ไปยัง Node "ทักทายด้วยชื่อจริง"
• เมื่อ API ล้มเหลว → ไปยัง Node "ขอโทษและโอนสาย"

ในกรณีที่ API ตอบกลับมา แต่ไม่มีข้อมูลที่คาดไว้ (เช่น ไม่มี response.name) Variable ที่ Map ไว้จะมีค่าว่าง

วิธีแก้: ใน Conversation Node ที่ใช้ Variable ตัวนี้ ให้เขียน Prompt ที่รองรับกรณีค่าว่าง เช่น

หาก {{customer_name}} ว่าง ให้กล่าวเพียง "สวัสดีค่ะ" แต่หากมีค่า ให้กล่าวว่า "สวัสดีคุณ {{customer_name}} ค่ะ"