เชื่อมต่อ GitHub - แจ้งเตือนอีเวนต์ Repo และ CI/CD

GitHub เป็นแพลตฟอร์มควบคุมเวอร์ชันและทำงานร่วมกันชั้นนำของโลก มีนักพัฒนาหลายล้านคนใช้งาน คู่มือนี้จะแสดงวิธีเชื่อม webhook ของ GitHub เข้ากับ Echobell เพื่อรับการแจ้งเตือนทันทีสำหรับอีเวนต์ต่าง ๆ ใน repository ตั้งแต่ pull request และ commit ไปจนถึง release และ workflow run

สิ่งที่ต้องเตรียม

1. บัญชี Echobell ที่มีช่องพร้อมใช้งาน
2. สิทธิ์ระดับ Admin ของ GitHub repository ที่คุณต้องการเฝ้าดู
3. Webhook URL ของ Echobell (ดูได้ในหน้ารายละเอียดของช่อง)

การตั้งค่า Webhook ของ GitHub

1. สร้างช่องใน Echobell

1. เปิดแอป Echobell
2. สร้างช่องใหม่ (เช่น "GitHub Notifications")
3. ตั้งค่าเทมเพลตการแจ้งเตือน:

เทมเพลตหัวข้อ:

[{{repository.name}}] {{action}} โดย {{sender.login}}

เทมเพลตเนื้อหา:

🔔 อีเวนต์: {{action}}
👤 ผู้ดำเนินการ: {{sender.login}}
📦 Repository: {{repository.full_name}}

2. รับ Webhook URL ของคุณ

1. ในหน้าตั้งค่าช่อง ให้หาส่วน Triggers
2. คัดลอก webhook URL ที่ระบบให้มา
3. เก็บ URL นี้ไว้อย่างปลอดภัย เพราะจะต้องนำไปใช้ในการตั้งค่าฝั่ง GitHub

3. ตั้งค่า Webhook ใน GitHub

1. ไปที่ GitHub repository ของคุณ
2. ไปที่ Settings → Webhooks
3. คลิก Add webhook
4. ตั้งค่า webhook:
   • Payload URL: webhook URL ของ Echobell ของคุณ
   • Content type: application/json
   • Secret: (ไม่บังคับ) ใส่โทเคนลับเพื่อเพิ่มความปลอดภัย
   • เปิดใช้การตรวจสอบ SSL
5. เลือกอีเวนต์ที่จะทริกเกอร์ webhook:
   • เลือก "Let me select individual events"
   • ตัวเลือกที่นิยมได้แก่:
     • Pull requests
     • Push events
     • Issues
     • Discussions
     • Releases
6. คลิก Add webhook เพื่อบันทึก

การทดสอบการเชื่อมต่อ

1. หลังตั้งค่า webhook เสร็จ GitHub จะส่งอีเวนต์ ping มาให้
2. ตรวจดูการแจ้งเตือนใน Echobell เพื่อยืนยันว่าได้รับแล้ว
3. ลองสร้าง issue หรือ pull request ทดสอบเพื่อยืนยันว่าการเชื่อมต่อทำงาน

แนวปฏิบัติที่ดี

1. ความปลอดภัย:
   • เก็บ webhook URL ของคุณเป็นความลับ
   • ใช้ webhook secret เพื่อยืนยันความถูกต้องของคำขอ
   • เปิดใช้การตรวจสอบ SSL
2. การเลือกอีเวนต์:
   • ติดตามเฉพาะอีเวนต์ที่คุณต้องการจริง ๆ
   • คำนึงถึงขนาดและความเคลื่อนไหวของ repository เมื่อเลือกอีเวนต์
3. การจัดการข้อผิดพลาด:
   • ตรวจสอบสถานะการส่ง webhook ใน GitHub
   • ตรวจดูประวัติการแจ้งเตือนของ Echobell ว่าส่งสำเร็จหรือไม่

การแก้ปัญหา

หากคุณไม่ได้รับการแจ้งเตือน:

1. ตรวจสอบว่า webhook URL ถูกต้อง
2. ดูประวัติการส่ง webhook ของ GitHub ว่ามีข้อผิดพลาดหรือไม่
3. ตรวจสอบว่าช่อง Echobell ของคุณยังใช้งานอยู่
4. ตรวจสอบว่าช่องของคุณมีผู้ติดตามที่ใช้งานอยู่
5. ตรวจสอบว่าอีเวนต์ที่เลือกไว้ถูกทริกเกอร์จริงหรือไม่

ความเป็นส่วนตัวและความปลอดภัย

• ควรถือว่า webhook URL เป็นข้อมูลลับ
• ส่งเฉพาะข้อมูลอีเวนต์เท่าที่จำเป็น
• เนื้อหาการแจ้งเตือนทั้งหมดถูกเก็บไว้บนเครื่องของผู้ติดตามเท่านั้น
• เซิร์ฟเวอร์ของเราเพียงประมวลผลคำขอ webhook และส่งต่อการแจ้งเตือนเท่านั้น

ต้องการความช่วยเหลือใช่ไหม เยี่ยมชม ศูนย์ช่วยเหลือ ของเรา หรือติดต่อเราที่ echobell@weelone.com