เชื่อมต่อ App Store Connect - แจ้งเตือนการรีวิว iOS

Webhook ของ App Store Connect จะกระจายทุกความเปลี่ยนแปลงที่สำคัญในไปป์ไลน์การปล่อยแอป iOS ของคุณ เมื่อสัญญาณเหล่านั้นไหลเข้าสู่ Echobell ทีมของคุณจะเห็นผลการรีวิว การปล่อยเวอร์ชัน และฟีดแบ็กจาก TestFlight ทันทีที่เกิดขึ้น โดยไม่ต้องคอยรีเฟรชหน้าหรือรื้อค้นในกล่องอีเมล

ทำไมหลายทีมจึงเชื่อมต่อนี้:

• ตอบสนองได้เร็วขึ้นเมื่อผลการรีวิวเปลี่ยนเป็น "Rejected" หรือ "Ready for Sale"
• มีสายการแจ้งเตือนเดียวสำหรับทั้งฟีดแบ็ก TestFlight และการประมวลผลบิลด์
• การแจ้งเตือนที่ชัดเจนและอ่านง่ายบนมือถือ ช่วยให้ PM, QA และฝ่ายการตลาดเห็นตรงกัน

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

• ช่อง Echobell ที่เปิดใช้ทริกเกอร์แบบ webhook แล้ว
• สิทธิ์เข้าถึง App Store Connect (Account Holder, Admin หรือ App Manager)
• แอป iOS ที่ใช้งานอยู่อย่างน้อยหนึ่งแอปเพื่อเฝ้าดู
• Webhook URL ของ Echobell (ช่อง → Triggers)

สิ่งที่คุณเฝ้าดูได้

App Store Connect ส่งสัญญาณมายัง Echobell ได้ในกรณีต่อไปนี้:

1. วงจรชีวิตของเวอร์ชันบน App Store — ความคืบหน้าการส่งตรวจ การอนุมัติ การถูกปฏิเสธ และการปล่อยเวอร์ชัน
2. หมุดหมายของ TestFlight — ผลการประมวลผลบิลด์ ฟีดแบ็กจากผู้ทดสอบ และการเปลี่ยนสถานะคำเชิญ

ภาพรวมการตั้งค่า

1. เตรียมช่อง Echobell พร้อมเทมเพลตการแจ้งเตือน
2. คัดลอก webhook URL ของช่อง
3. ตั้งค่า webhook ใน App Store Connect
4. ส่งข้อมูลทดสอบเพื่อตรวจสอบรูปแบบข้อความ

คู่มือทีละขั้นตอน

[{{app.name}}] {{eventType}} - {{status}}

📱 แอป: {{app.name}}
🔄 อีเวนต์: {{eventType}}
📊 สถานะ: {{status}}
⏰ เวลา: {{eventDate}}
💬 ข้อความ: {{message}}
🔗 ดูใน App Store Connect

การตั้งค่าขั้นสูง

ความปลอดภัยของ Webhook

1. HTTPS: URL ของ Echobell มาพร้อม TLS อยู่แล้ว ไม่ต้องตั้งค่าเพิ่ม
2. การจัดการ secret: App Store Connect บังคับให้ใส่ secret แต่ Echobell ถือว่าเป็นข้อมูลเมตา เก็บไว้เผื่อคุณต้องการนำไปตรวจสอบลายเซ็นในภายหลัง
3. การอนุญาต IP: รัดกุมยิ่งขึ้นด้วยการอนุญาตเฉพาะช่วง IP ขาออกของ Apple

เทมเพลตการแจ้งเตือนแบบกำหนดเอง

ใช้รูปแบบที่ต่างกันระหว่างการเปลี่ยนสถานะการรีวิวกับฟีดแบ็ก เพื่อให้สัญญาณชัดเจนขึ้น

สำหรับการเปลี่ยนสถานะแอป

• หัวข้อ:

[{{app.name}}] App {{eventType}}

• เนื้อหา:

🍎 สถานะแอป "{{app.name}}" ของคุณเปลี่ยนแล้ว!

📊 สถานะ: {{status}}
📅 วันที่: {{eventDate}}

• ลิงก์:

{{app.url}}

สำหรับฟีดแบ็กของ TestFlight

• หัวข้อ:

[{{app.name}}] มีฟีดแบ็ก TestFlight ใหม่

• เนื้อหา:

📱 แอป: {{app.name}}
👤 ผู้ทดสอบ: {{tester.name}}
⭐ คะแนน: {{rating}}/5
💬 ฟีดแบ็ก: {{feedback}}
📱 อุปกรณ์: {{device}}

• ลิงก์:

{{feedbackUrl}}

การจัดการหลายแอป

• สร้างช่องแยกกันตามแอปหรือตามสภาพแวดล้อม ("MyApp - Beta", "MyApp - Prod")
• ตั้งชื่อให้เป็นมาตรฐานเดียวกัน เพื่อให้เพื่อนร่วมทีมรู้ทันทีว่าต้องดูที่ไหน
• เพิ่มกฎอัตโนมัติหรือช่วงเวลาเงียบให้แต่ละช่องเมื่อมีการแจ้งเตือนถี่ขึ้น
• เพิ่มคนเข้าเฉพาะช่องที่ตรงกับบทบาทของเขาเท่านั้น

โครงสร้าง Payload ของ Webhook

App Store Connect ส่ง payload ของ webhook มาในรูปแบบ JSON โครงสร้างทั่วไปเป็นดังนี้:

{
  "eventType": "APP_STORE_VERSION_STATE_CHANGED",
  "apiVersion": "v1",
  "eventId": "12345678-1234-1234-1234-123456789012",
  "eventDate": "2025-01-15T10:30:00Z",
  "data": {
    "app": {
      "id": "1234567890",
      "name": "My App"
    },
    "appStoreVersion": {
      "id": "12345678",
      "versionString": "1.2.3",
      "state": "READY_FOR_SALE"
    }
  }
}

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

1. การจัดระเบียบช่อง: สร้างช่องแยกกันสำหรับแต่ละแอปหรือแต่ละสภาพแวดล้อม
2. การจัดการทีม: เพิ่มเฉพาะสมาชิกทีมที่เกี่ยวข้องเข้าแต่ละช่อง
3. การปรับแต่งเทมเพลต: ปรับเทมเพลตให้แสดงข้อมูลที่เกี่ยวข้องกับเวิร์กโฟลว์ของคุณมากที่สุด
4. ประเภทการแจ้งเตือน: ใช้แบบสำคัญตามเวลาสำหรับกรณีแอปถูกปฏิเสธซึ่งเป็นเรื่องวิกฤต และใช้แบบปกติสำหรับอัปเดตทั่วไป

การแก้ปัญหา

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

1. ตรวจสอบว่าคัดลอก webhook URL มาถูกต้อง
2. ตรวจสอบว่าช่องยังใช้งานอยู่และมีผู้ติดตาม
3. ตรวจสอบการตั้งค่า webhook ใน App Store Connect
4. ใช้ปุ่ม Test ใน App Store Connect เพื่อตรวจสอบการเชื่อมต่อ
5. ดูประวัติการส่ง webhook ใน App Store Connect

ความเป็นส่วนตัวและการจัดการข้อมูล

แนวทางที่ให้ความเป็นส่วนตัวมาก่อนของ Echobell:

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

แหล่งข้อมูลเพิ่มเติม

• เอกสาร Webhook ของ Apple
• การเชื่อมต่อ Webhook ของ Echobell
• คู่มือเทมเพลตการแจ้งเตือน
• ศูนย์ช่วยเหลือ