ตั้งค่า Phone AI สำหรับสายเรียกเข้า

ตั้งค่าอย่างรวดเร็ว

เชื่อมต่อหมายเลข Twilio หนึ่งหมายเลข ทดสอบ Webhook แล้วเปิดใช้งาน Phone AI โดยทั่วไปใช้เวลาประมาณ 10 นาที

คู่มือนี้ช่วยให้คุณรับสายเรียกเข้าของโรงแรมด้วย AVA และตรวจสอบบันทึกการสนทนาของแต่ละสาย

ไปที่: Settings → Communications → Phone AI

การเปิดใช้งานเฉพาะโรงแรม

การตั้งค่า Phone AI เป็นของโรงแรมที่เลือก โรงแรมแต่ละแห่งต้องมีหมายเลข Twilio ข้อมูลรับรองที่บันทึกไว้ และการเปิดใช้งานของตนเอง

ข้อมูลอ้างอิงด่วน

การตั้งค่า	ควบคุมสิ่งใด	สิ่งที่คุณเห็น
Twilio Account SID	เลือกบัญชี Twilio	ตัวระบุที่ขึ้นต้นด้วย AC
Twilio phone number	รับสายจากผู้เข้าพัก	หมายเลขที่มี + และรหัสประเทศ
Twilio Auth Token	อนุญาตให้ AVA ตรวจสอบและจัดการสาย	ข้อมูลลับที่ได้รับการปกป้องและจะไม่แสดงอีก
Purpose	บันทึกหมายเหตุเพิ่มเติมสำหรับหมายเลขนี้	คำอธิบายของคุณบนหน้าตั้งค่า
Incoming-call webhook	ส่งสายจาก Twilio ไปยัง AVA	URL ที่คัดลอกได้และการดำเนินการ Test webhook
สวิตช์ Phone AI	เปิดใช้งานหรือหยุดการจัดการสายด้วย AI	Active หรือ Not active
Call Activity	แสดงรายการสายและสถานะของสาย	หมายเลขผู้โทร เวลาเริ่มต้น สถานะ และบันทึกการสนทนา

ก่อนเริ่ม

ยืนยันข้อกำหนดต่อไปนี้:

• คุณมีสิทธิ์ Settings read เพื่อดูแลกิจกรรม Phone AI
• คุณมีสิทธิ์ Settings write เพื่อกำหนดค่า Phone AI
• คุณมีหมายเลขโทรศัพท์ Twilio เฉพาะสำหรับงานนี้
• คุณมี Account SID และ Auth Token ของ Twilio
• หมายเลขโทรศัพท์เขียนอยู่ในรูปแบบ E.164

ตรวจสอบสิทธิ์ Settings ของคุณ

สิทธิ์ของคุณจะกำหนดว่าคุณใช้การดำเนินการใดของ Phone AI ได้บ้าง:

สิทธิ์	การดำเนินการที่ใช้ได้
Settings read	เปิด Phone AI และตรวจสอบ Call Activity กับบันทึกการสนทนา
Settings write	บันทึกการตั้งค่า ทดสอบ Webhook และเปิดใช้งาน Phone AI

ขอให้ผู้ดูแลระบบอัปเดตบทบาทของคุณหากไม่พบการดำเนินการบางอย่าง

ข้อกำหนดการติดตั้งใช้งาน

Twilio ต้องเข้าถึง AVA ผ่านที่อยู่ HTTPS สาธารณะที่รองรับการเชื่อมต่อ WebSocket ขอให้ผู้ดูแล AVA ยืนยันข้อกำหนดนี้สำหรับการติดตั้งใช้งานแบบส่วนตัวหรือแบบจำกัดการเข้าถึง

ตรวจสอบ URL สาธารณะของ Phone AI

AVA สร้าง URL ของ Twilio webhook และ media stream จากที่อยู่ Core สาธารณะ

สภาพแวดล้อม	ลักษณะของ URL	สิ่งที่ควรตรวจสอบ
Production	ใช้ VOUCH_CORE_URL แบบ HTTPS สาธารณะ	URL มี /core เมื่อการติดตั้งใช้งานของคุณใช้คำนำหน้านี้
Local Docker	ใช้ที่อยู่ SERVICE_HOME สาธารณะและ PUBLIC_PATH	ที่อยู่ชี้ไปยัง ngrok tunnel สาธารณะของคุณ

Media stream URL

AVA สร้าง URL media stream แบบปลอดภัย wss:// ให้อัตโนมัติ คุณกำหนดค่าเฉพาะ incoming-call webhook ที่คัดลอกไปไว้ใน Twilio อย่าเพิ่มพารามิเตอร์ query ให้กับ media stream URL ที่สร้างขึ้น

ขอให้ผู้ดูแลการติดตั้งใช้งานแก้ไขค่าเหล่านี้ หาก webhook ที่คัดลอกมี hostname ภายใน

เชื่อมต่อบริการ Phone AI

ขอให้ทีมติดตั้งใช้งานทำการตรวจสอบต่อไปนี้ให้เสร็จก่อนเปิดใช้ Phone AI:

• เก็บเส้นทาง realtime จาก Core ไปยัง Chat ไว้เป็นส่วนตัว เส้นทางนี้มีไว้สำหรับการรับส่งข้อมูลระหว่างบริการภายในเท่านั้น
• ตั้งค่า INTER_SERVICE_SECRET ใน Chat Microservice ให้ตรงกับ CHAT_MICROSERVICE_SECRET ของ Core
• ติดตั้งใช้งาน Chat Microservice ก่อน Core และให้ Streamliner ทำงานต่อได้หลังจาก Core พร้อมใช้งาน
• หากจำเป็น ให้ย้อนกลับตามลำดับ: Streamliner, Core แล้วจึง Chat Microservice

เก็บเส้นทาง realtime ไว้เป็นส่วนตัว

อย่าเปิดเผยเส้นทาง realtime ภายในต่ออินเทอร์เน็ตสาธารณะ Twilio ควรเชื่อมต่อผ่าน AVA webhook สาธารณะ ไม่ใช่เชื่อมต่อกับ Chat Microservice โดยตรง

ปกป้อง Auth Token

ดูแล Twilio Auth Token เหมือนรหัสผ่าน AVA จะปกป้อง Token หลังบันทึกและไม่แสดงอีก

บันทึกการเชื่อมต่อ Twilio

1. ไปที่ Settings → Communications → Phone AI

2. อยู่ที่ Setup

3. กรอก Twilio Account SID

4. กรอก Twilio phone number พร้อม + และรหัสประเทศ

5. กรอก Twilio Auth Token

6. เพิ่ม Purpose หากต้องการ

7. คลิก Save settings

   ✓ คุณจะเห็นข้อความ "Phone AI settings saved." ✓ ช่อง Auth Token เปลี่ยนเป็นตัวยึดตำแหน่งที่ได้รับการปกป้อง

การแทนที่ Token

เว้นช่อง Auth Token ว่างไว้เพื่อเก็บ Token ที่บันทึกไว้ กรอก Token ใหม่เฉพาะเมื่อต้องการแทนที่ Token เดิม

ส่งสายเรียกเข้าจาก Twilio

1. ใน Setup ให้ค้นหา Incoming-call webhook

2. คลิก Copy

3. เปิด Twilio Console

4. เปิด Phone Numbers แล้วเลือกหมายเลขของโรงแรม

5. ใต้ Voice configuration ตั้งค่า A call comes in เป็น Webhook

6. วาง URL ที่คัดลอกไว้

7. เลือก POST แล้วบันทึกการกำหนดค่า Twilio

   ✓ ตอนนี้ Twilio จะส่งสายเรียกเข้าไปยัง AVA webhook

การตรวจสอบ Webhook

AVA จะตรวจสอบคำขอจาก Twilio และหมายเลขโทรศัพท์ที่กำหนดค่าไว้ก่อนรับสาย ใช้หมายเลขเดียวกับที่บันทึกไว้ใน AVA เมื่อตั้งค่า Twilio

ทดสอบและเปิดใช้งาน Phone AI

1. กลับไปที่ Settings → Communications → Phone AI

2. บันทึกการเปลี่ยนแปลงที่ยังไม่ได้บันทึก

3. คลิก Test webhook

4. ยืนยันข้อความแจ้งว่าสำเร็จ

5. เปิด Enable Phone AI

6. คลิก Save settings

7. โทรไปยังหมายเลข Twilio จากโทรศัพท์อีกเครื่อง

   ✓ Phone AI รับสายเรียกเข้า ✓ หลังวางสาย สายดังกล่าวจะปรากฏใน Call Activity พร้อมสถานะที่บันทึกไว้ ✓ เลือก View transcript เพื่อตรวจสอบข้อความของผู้โทรและ AI ที่บันทึกไว้

ข้อกำหนดในการเปิดใช้งาน

คุณต้องบันทึก Account SID หมายเลขโทรศัพท์ และ Auth Token ก่อนเปิดใช้งาน การทดสอบ webhook จะยังปิดใช้งานอยู่ขณะที่มีการเปลี่ยนแปลงที่ยังไม่ได้บันทึก

ตรวจสอบ Call Activity

1. เปิด Call Activity

2. ค้นหาสายด้วยหมายเลขผู้โทรและเวลาเริ่มต้น

3. ตรวจสอบสถานะของสาย

4. คลิก View transcript

5. ปิดบันทึกการสนทนาเมื่อเสร็จแล้ว

   ✓ คุณสามารถตรวจสอบข้อความของผู้โทรและผู้ช่วยสำหรับสายนั้นได้

การรีเฟรชกิจกรรม

Call Activity จะโหลดเมื่อเปิดหน้าอีกครั้ง ให้เปิดหรือรีเฟรชหน้าใหม่หลังจากสายใหม่สิ้นสุดลง

จัดการคำขอบริการของผู้เข้าพัก

Phone AI สามารถตอบคำถามทั่วไปเกี่ยวกับโรงแรมระหว่างการโทรได้ การดำเนินการบริการผู้เข้าพักที่รองรับต้องมีบันทึกการสนทนาที่เชื่อถือได้และการยืนยันจากผู้เข้าพักอย่างชัดเจน

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

จะไม่ส่งคำขอใดโดยไม่มีการยืนยัน

หากไม่มีการถอดเสียง Phone AI จะไม่ส่ง ยกเลิก หรือเปลี่ยนแปลงคำขอบริการของผู้เข้าพัก ผู้เข้าพักจะได้รับการโอนต่อไปยังแผนกต้อนรับแทน

แนะนำให้ผู้เข้าพักติดต่อแผนกต้อนรับเมื่อต้องการให้ดำเนินการบางอย่างระหว่างการโทรที่ไม่มีการถอดเสียง

การแก้ไขปัญหา

หมายเลขโทรศัพท์ถูกปฏิเสธ

สิ่งที่เห็น: "Enter the Twilio phone number in E.164 format, including + and country code."

วิธีแก้:

1. เริ่มหมายเลขด้วย +
2. เพิ่มรหัสประเทศ
3. ลบช่องว่าง วงเล็บ และขีดกลาง
4. คลิก Save settings อีกครั้ง

การทดสอบ webhook ถูกปิดใช้งาน

สิ่งที่เห็น: คุณไม่สามารถเลือก Test webhook ได้

วิธีแก้:

1. กรอก Account SID หมายเลขโทรศัพท์ และ Auth Token ให้ครบ
2. คลิก Save settings
3. รอข้อความยืนยันการบันทึก
4. คลิก Test webhook อีกครั้ง

การทดสอบ webhook ล้มเหลว

สิ่งที่เห็น: "Unable to verify the Twilio webhook configuration."

วิธีแก้:

1. คัดลอก Incoming-call webhook ปัจจุบันอีกครั้ง
2. ยืนยันว่า Twilio ใช้ URL นี้สำหรับ A call comes in
3. ยืนยันว่าเมธอดคือ POST
4. บันทึกใน Twilio แล้วทดสอบใน AVA อีกครั้ง

Webhook ที่คัดลอกใช้ URL ภายใน

สิ่งที่เห็น: URL ที่คัดลอกมี hostname ภายในหรือขึ้นต้นด้วย http://

วิธีแก้:

1. ขอให้ผู้ดูแลการติดตั้งใช้งานตั้งค่า VOUCH_CORE_URL ของ Production เป็นที่อยู่ Core HTTPS สาธารณะ

2. ยืนยันว่าค่าดังกล่าวมี /core เมื่อการติดตั้งใช้งานสาธารณะของคุณใช้คำนำหน้านี้

3. สำหรับ Local Docker ให้ยืนยันว่าที่อยู่ ngrok สาธารณะได้รับการกำหนดค่าผ่าน SERVICE_HOME และ PUBLIC_PATH

4. เปิด Settings → Communications → Phone AI อีกครั้ง

5. คัดลอก Incoming-call webhook อีกครั้ง แล้วอัปเดต Twilio

   ✓ Webhook ที่คัดลอกขึ้นต้นด้วย https:// และใช้ที่อยู่สาธารณะ

สายไม่ปรากฏใน Call Activity

สิ่งที่เห็น: สายทดสอบสิ้นสุดลง แต่ไม่มีสายปรากฏสำหรับโรงแรมที่เลือก

วิธีแก้:

1. ยืนยันว่าคุณเลือกโรงแรมที่เปิดใช้งาน Phone AI
2. ยืนยันว่าหมายเลข Twilio ตรงกับ Twilio phone number ทุกประการ
3. เปิดหรือรีเฟรชหน้า Phone AI อีกครั้งหลังสายสิ้นสุดลง
4. เรียกใช้ Test webhook อีกครั้งหลังบันทึกการตั้งค่า
5. ขอให้ผู้ดูแล AVA ยืนยันว่าที่อยู่ HTTPS สาธารณะรองรับการเชื่อมต่อ WebSocket

ไม่สามารถเปิดใช้งาน Phone AI ได้

สิ่งที่เห็น: สวิตช์ Enable Phone AI ยังคงปิดใช้งานอยู่

วิธีแก้:

1. ยืนยันว่าคุณมีสิทธิ์ Settings write
2. บันทึกการตั้งค่า Twilio ที่จำเป็นทั้งหมด
3. ตรวจสอบว่าหมายเลขมี + และรหัสประเทศ
4. รีเฟรชหน้าแล้วลองอีกครั้ง

เปิดบันทึกการสนทนาไม่ได้

สิ่งที่เห็น: "Unable to load this transcript."

วิธีแก้:

1. ปิดแผงบันทึกการสนทนา
2. รีเฟรช Call Activity
3. เปิดสายอีกครั้ง
4. ติดต่อฝ่ายสนับสนุนหากบันทึกการสนทนาอื่นก็เปิดไม่ได้

สายไม่มีบันทึกการสนทนา

สิ่งที่เห็น: "No transcript was saved for this call."

วิธีแก้:

1. ตรวจสอบสายที่เสร็จสมบูรณ์สายอื่นใน Call Activity

2. ใช้ Phone AI ต่อไปสำหรับคำถามทั่วไปเกี่ยวกับโรงแรม

3. แจ้งให้ผู้เข้าพักติดต่อแผนกต้อนรับสำหรับคำขอ การยกเลิก หรือการเปลี่ยนแปลง

4. ติดต่อผู้ดูแล AVA หากการติดตั้งใช้งานของคุณควรบันทึกบันทึกการสนทนา

   ✓ Phone AI ยังคงตอบคำถามต่อได้แม้ไม่มีบันทึกการสนทนาที่บันทึกไว้ ✓ การดำเนินการสำหรับผู้เข้าพักที่ต้องมีการยืนยันจะถูกส่งต่อไปยังแผนกต้อนรับแทน

ยังต้องการความช่วยเหลือ?

ติดต่อ success@vouch-technologies.com หาก:

• ❌ Webhook ที่บันทึกไว้ยังทดสอบไม่ผ่าน
• ❌ สายไม่ปรากฏใน Call Activity
• ❌ Phone AI ไม่รับสายหลังเปิดใช้งาน

ข้อมูลที่ควรแนบ:

• ภาพหน้าจอสถานะการตั้งค่าที่ไม่มีค่าลับ
• หมายเลขโทรศัพท์ Twilio
• เวลาของสายทดสอบหนึ่งสาย
• ข้อความแสดงข้อผิดพลาดที่ตรงตามจริง

คู่มือที่เกี่ยวข้อง

• ตั้งค่าพรอมต์ผู้ช่วยเสียง
• ตั้งค่าวิดีโอคอล
• ตั้งค่าแชทบอทของคุณ