SocialHub.AI
แหล่งข้อมูล · ศูนย์นักพัฒนา

การแจ้งเตือนแอป

เปลี่ยนแอปเนทีฟของคุณให้เป็นช่องทางการส่ง SocialHub สมาชิกลงทะเบียนโทเค็นอุปกรณ์จากภายในศูนย์สมาชิกในแอป push จากนั้นเข้าร่วมระบบอัตโนมัติและกลไกแคมเปญเดียวกันกับที่ส่งอีเมลของคุณ - พร้อมด้วยน้ำตกแบบเปิดที่ล้มเหลวและความถี่สูงสุดที่ใช้ร่วมกันหนึ่งรายการ

การลงทะเบียนโทเค็นและตะเข็บ send-stack ใช้งานได้จริงในโค้ดวันนี้ การส่งจริงจะเกิดขึ้นหลังธงการเปิดใช้งานที่มีการควบคุม ต่อทีม — ขอให้ทีม SocialHub ของคุณเปิดใช้งานเมื่อกำหนดค่าข้อมูลประจำตัว FCM/APN ของคุณแล้ว

วิธีการทำงาน

ลงทะเบียนโทเค็นอุปกรณ์สด

แอปของสมาชิกที่ลงชื่อเข้าใช้จะโพสต์โทเค็น FCM/APN Idempotent UPSERT — ปลอดภัยในการเรียกใช้ทุกการเปิดตัวและการหมุนเวียนโทเค็น OS

Push รวมกองส่งสด

พุชเป็นช่องทางในกลไกอัตโนมัติ/แคมเปญเดียวกันกับอีเมล ไม่ใช่ API แยกกัน การเดินทางหนึ่งครั้ง ช่องทางที่เลือกต่อสมาชิก

น้ำตกช่อง+หนึ่งฝาสด

Waterfall ที่เปิดไม่สำเร็จ (พุช → อีเมล → …) ด้วยความถี่สูงสุดที่ใช้ร่วมกันเพียงความถี่เดียว ดังนั้นสมาชิกจะไม่ได้รับข้อความซ้ำซ้อนข้ามช่องทาง

การเปิดใช้งานการจัดส่งกำลังทยอยออก

การลงทะเบียนและตะเข็บส่งอยู่ในรหัสวันนี้ การส่งแบบพุชจริงจะเกิดขึ้นหลังธงควบคุมต่อทีม ขอให้ทีม SocialHub ของคุณเปิดใช้งาน

ลงทะเบียนโทเค็นอุปกรณ์ สด

เรียกสิ่งนี้จากภายใน WebView สมาชิกที่ลงชื่อเข้าใช้ (คุกกี้เซสชันผู้บริโภคมีข้อมูลระบุตัวตน) ดูคำแนะนำ การฝังพอร์ทัลสมาชิก สำหรับโฟลว์ WebView SSO ที่สร้างเซสชันนั้น

// The member must be signed in (consumer session cookie, set by the WebView SSO
// flow). teamId + memberId are taken from the SESSION — never the request body —
// so there is no member-enumeration surface here.
POST https://flash.socialhub.ai/api/consumer/push/register
Content-Type: application/json

{
  "platform": "ios",             // "ios" | "android"
  "provider": "fcm",             // "fcm" (default) | "apns"  — optional
  "token": "<device push token>",
  "appBundleId": "com.yourbrand.app"   // optional
}
// → 200  { "ok": true }
//   Idempotent UPSERT keyed on (team, token): re-registering the same device
//   simply re-points it at the current member. Call it on every app launch and
//   whenever the OS rotates the token.

การส่ง: การพุชเป็นช่องทาง ไม่ใช่การโทร API

// You do NOT call a "send push" endpoint. Push is a CHANNEL inside the existing
// automation + campaign send stack — the same engine that sends email. When a
// journey or campaign targets a member:
//
//   1. SocialHub resolves the member's channels in a waterfall (fail-open):
//        push (if a token + consent exist)  →  email  →  …
//   2. One SHARED frequency cap applies across channels, so a member is never
//      double-messaged on push AND email for the same step.
//   3. No token / no consent / push disabled  →  silently falls back to email.
//
// Net: you author one journey; SocialHub picks the best channel per member.

นักการตลาดสร้างการพุชโดยไม่ต้องใช้โค้ด: ขั้นตอนการพุชในพื้นที่แคมเปญภาพ (ข้างอีเมล) พร้อมด้วยสำเนาที่สร้างโดย AI แท็กผสานแบบเดียวกับอีเมล และเทมเพลตพุชที่นำมาใช้ซ้ำได้ ไม่ว่าพวกเขาจะเขียนอะไรก็ตามจะกลายเป็นเนื้อหาพุชของแคมเปญและเส้นทางการส่งด้านบนจะส่งสิ่งนั้นไป แอปของคุณจะลงทะเบียนโทเค็นอุปกรณ์เท่านั้น

ก่อนที่คุณจะเปิดใช้งานจริง

FCM (Android + iOS ผ่าน Firebase)

ให้ข้อมูลประจำตัวบัญชีบริการ Firebase ของคุณแก่ทีม SocialHub ของคุณ ส่งผ่าน FCM HTTP v1 (OAuth ผ่านบัญชีบริการ) — ผู้ให้บริการเริ่มต้น

APN (ไม่บังคับ, โดยตรง)

หากคุณส่งไปยัง iOS โดยตรงผ่าน APN ให้ระบุคีย์การตรวจสอบสิทธิ์ APN (.p8), รหัสคีย์ และรหัสทีม ลงทะเบียนอุปกรณ์เหล่านั้นกับผู้ให้บริการ: "apns"

ความยินยอม

การแจ้งเตือนแบบ Push จะถูกจำกัดด้วยความยินยอมของสมาชิกอย่างชัดเจน รวมถึงสัญญาณการควบคุมความเป็นส่วนตัวทั่วโลก (ล้มเหลว-ปิด) สมาชิกที่ไม่มีความยินยอมในการแจ้งเตือนแบบ Push ที่ใช้งานอยู่จะถูกข้ามไป — ลำดับการทำงานจะเปลี่ยนไปใช้อีเมลแทน

รายการตรวจสอบการยอมรับ

การลงทะเบียนอุปกรณ์เดียวกันสองครั้งจะไม่สร้างข้อมูลซ้ำ — UPSERT จะชี้อุปกรณ์ไปที่สมาชิกปัจจุบันอีกครั้ง

สมาชิกที่เลือกเข้าร่วมและมีโทเค็นที่ถูกต้องจะได้รับการแจ้งเตือนแบบพุช สมาชิกที่ไม่มีโทเค็น/ความยินยอมจะได้รับการแจ้งเตือนทางอีเมลแทน — ไม่มีอะไรเลย ไม่มีทั้งสองอย่าง

การเพิกถอนความยินยอม (หรือสัญญาณการควบคุมความเป็นส่วนตัวทั่วโลก) จะทำให้สมาชิกไปที่ช่องทางอีเมลทันที

ดันสายไฟเหรอ?

พูดคุยกับวิศวกรเกี่ยวกับข้อมูลรับรอง FCM/APN, send-channel Waterfall หรือการเปิดใช้งานการจัดส่งสำหรับทีมของคุณ

คุยกับวิศวะ