โหมด Callback ของ WeCom — แอปที่กำหนดเอง

ลองนึกภาพว่ากำลังจัดตู้จดหมายเฉพาะไว้ให้ผู้ช่วย AI ของคุณ—แทนที่จะให้มันซ่อนตัวอยู่ในแชทกลุ่ม คุณให้โต๊ะทำงานของมันเองที่ใครๆ ก็เดินมาฝากข้อความได้โดยตรง

ความแตกต่างหลักคืออะไร?

Hermes Agent ให้คุณสองวิธีในการเชื่อมต่อ WeCom (Enterprise WeChat) โหมด Bot ก็เหมือนผู้ช่วยที่เป็นมิตรที่เข้าร่วมแชทกลุ่ม—ตั้งค่าไว แต่จำกัด โหมด Callback ต่างออกไป: คุณสร้าง แอปแบบกำหนดเอง ที่จะปรากฏในแถบข้าง WeCom ของพนักงาน เหมือนกับแอปทางการอื่นๆ มันให้ความรู้สึกเป็นธรรมชาติ รองรับหลายบริษัท และจัดการข้อความที่เข้ารหัสได้อย่างปลอดภัย

ข้อแลกเปลี่ยน? คุณต้องมีเซิร์ฟเวอร์สาธารณะเพื่อรับข้อความ แต่ไม่ต้องกังวล—ทันเนลง่ายๆ อย่าง ngrok ก็ใช้ทดสอบได้ดี

กลไกการทำงานจริง

นี่คือขั้นตอนแบบภาษาคน:

มีคนส่งข้อความถึงแอปแบบกำหนดเองของคุณใน WeCom
WeCom เข้ารหัสข้อความนั้นและส่งไปยัง HTTP endpoint ของเซิร์ฟเวอร์คุณ
Hermes ถอดรหัส ใส่คิวให้ AI agent และตอบกลับ WeCom ทันทีว่า “รับทราบ” (แบบเงียบๆ—ผู้ใช้ยังไม่เห็นอะไร)
Agent ใช้เวลาคิด 3–30 นาที (ขึ้นอยู่กับงานของคุณ)
Hermes ส่งคำตอบกลับไปโดยอัตโนมัติโดยใช้ Message API ของ WeCom

ไม่มีการโพลล์ ไม่มีความล่าช้า แค่การสนทนาแบบอะซิงโครนัสที่สะอาดตา

ขั้นตอนการติดตั้งทีละขั้น

1. สร้างแอปใน WeCom Admin

เข้าสู่ระบบ WeCom Admin Console ไปที่ Applications → Create App
จด Corp ID ของคุณ (ด้านบนของคอนโซล) และสร้าง Corp Secret
ในหน้าภาพรวมของแอป เก็บ Agent ID

ภายใต้ Receive Messages กำหนดค่า:

URL: http://YOUR_PUBLIC_IP:8645/wecom/callback
Token: สร้างแบบสุ่ม
EncodingAESKey: สร้างคีย์ 43 ตัวอักษร

2. ตั้งค่าตัวแปรสภาพแวดล้อม

เพิ่มสิ่งเหล่านี้ลงในไฟล์ .env ของคุณ:

WECOM_CALLBACK_CORP_ID = your-corp-id
WECOM_CALLBACK_CORP_SECRET = your-corp-secret
WECOM_CALLBACK_AGENT_ID = 1000002
WECOM_CALLBACK_TOKEN = your-callback-token
WECOM_CALLBACK_ENCODING_AES_KEY = your-43-char-aes-key

# ไม่บังคับ
WECOM_CALLBACK_PORT = 8645
WECOM_CALLBACK_ALLOWED_USERS = user1,user2

3. เริ่มเกตเวย์

hermes gateway

หมายเหตุ: ใช้ hermes gateway start หลังจากที่คุณรัน hermes gateway install เพื่อลงทะเบียนบริการแล้วเท่านั้น

Callback adapter จะเริ่ม HTTP server บนพอร์ต 8645 WeCom จะตรวจสอบ URL ผ่านคำขอ GET จากนั้นเริ่มส่งข้อความผ่าน POST

ข้อมูลอ้างอิงการกำหนดค่า

คุณยังสามารถตั้งค่าเหล่านี้ใน config.yaml ภายใต้ platforms.wecom_callback.extra:

การตั้งค่า	ค่าเริ่มต้น	คำอธิบาย
`corp_id`	—	จำเป็น. Corp ID ของ WeCom คุณ
`corp_secret`	—	จำเป็น. App secret
`agent_id`	—	จำเป็น. Agent ID ของแอปคุณ
`token`	—	จำเป็น. โทเคนสำหรับตรวจสอบ callback
`encoding_aes_key`	—	จำเป็น. คีย์ AES 43 ตัวอักษร
`host`	ไม่ตั้งค่า (dual-stack)	ที่อยู่สำหรับผูก HTTP server
`port`	8645	พอร์ตสำหรับ callback server

สรุป

โหมด WeCom Callback คือวิธี “ทางการ” ในการผสาน Hermes เข้ากับขั้นตอนการทำงานขององค์กรคุณ มันต้องติดตั้งมากกว่าโหมดบอท แต่ผลตอบแทนคือประสบการณ์แอประดับเฟิร์สคลาสที่สวยงามสำหรับผู้ใช้ของคุณ

เคล็ดลับปฏิบัติ: เริ่มด้วย ngrok ก่อนที่จะเปิดเผยเซิร์ฟเวอร์จริง รัน ngrok http 8645 ใช้ URL นั้นในคอนโซล WeCom และทดสอบกับผู้ใช้คนเดียว เมื่อใช้งานได้แล้ว ค่อยเปลี่ยนไปใช้เซิร์ฟเวอร์โปรดักชันและจำกัด WECOM_CALLBACK_ALLOWED_USERS ให้เฉพาะทีมของคุณ ขอให้สนุกกับการสร้าง!