การบูรณาการของนักพัฒนา

7stamp Webhooks

พร้อมใช้งาน

พุชทุกกิจกรรมความภักดีจาก 7stamp ไปยังระบบของคุณเองแบบเรียลไทม์ ไม่มีการโพลและไม่มีการเรียก API ตามกำหนดเวลา เหตุการณ์มาถึงตามคำร้องขอ HTTPS POST ภายในไม่กี่วินาทีที่เกิดขึ้น

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

อะไร คุณสามารถทำอะไรกับ webhooks

Webhooks เป็นด้านขาออกของสแต็กการรวม โดยจะสะท้อนกิจกรรมของลูกค้าและการให้รางวัลไปยังระบบที่คุณไว้วางใจอยู่แล้วในด้านการขาย การบริการ การวิเคราะห์ และการส่งข้อความ

สะท้อนประวัติความภักดีไปยัง CRM ของคุณ

ทริกเกอร์การประทับตรา บัตรกำนัล วันเกิด และการไม่มีกิจกรรมทุกรายการจะเข้าสู่บันทึกลูกค้าใน CRM ของคุณ คุณจะเห็นไทม์ไลน์สำหรับสมาชิกแบบเต็มถัดจากการขาย การโทร และตั๋วโดยไม่ต้องเข้าสู่ระบบ 7stamp

ทริกเกอร์สแต็กข้อความของคุณเอง

เมื่อลูกค้าแลกบัตรกำนัล ให้ส่ง SMS ขอบคุณจากเกตเวย์ SMS ที่มีอยู่ของคุณ เมื่อลูกค้าบรรลุเป้าหมาย โพสต์ฉลองใน Slack เมื่อมีคนไม่มีการใช้งาน ให้กำหนดเส้นทางให้กับผู้จัดการบัญชีของคุณ

เพิ่มประสิทธิภาพการวิเคราะห์และการกระทบยอด

สตรีมเหตุการณ์ลงในเครื่องมือ BI คลังสินค้า หรือไปป์ไลน์การกระทบยอดของคุณ จับคู่การแลกบัตรกำนัลกับใบเสร็จรับเงิน POS และคำนวณความภักดี ROI ในตัวชี้วัดของคุณเอง

ประเภทเหตุการณ์การ์ด

SCAN — การ์ดได้รับการดำเนินการ scan/stamp
REWARD_EARNED — ได้รับรางวัลบนการ์ด
VOUCHER_ISSUED — มีการออกบัตรกำนัลแล้ว
VOUCHER_REDEEMED — บัตรกำนัลถูกแลกแล้ว
LOTTERY_WIN — ลอตเตอรี่ส่งผลให้ถูกรางวัล
DELIVERY_INSERT — มีการบันทึกโฟลว์การแทรกการส่งมอบ
CARD_JOINED — ลูกค้าเข้าร่วมการ์ด
CARD_CAMPAIGN — มีเหตุการณ์แคมเปญการ์ดเกิดขึ้น
BIRTHDAY_GREETING — มีเหตุการณ์อวยพรวันเกิดเกิดขึ้น
ADMIN_VOUCHER_ISSUE — ผู้ดูแลระบบออกบัตรกำนัล
CARD_ADDED_TO_WALLET — ลูกค้าเพิ่มบัตรลงในกระเป๋าเงินของตน
CARD_REMOVED_FROM_WALLET — ลูกค้านำบัตรออกจากกระเป๋าเงินของตน

สร้างตัวรับ webhook ที่ปลอดภัย

รับทราบหลังจากการจัดการที่ทนทาน

ตำแหน่งข้อมูลของคุณควรยอมรับ HTTPS POST ตรวจสอบรูปร่างคำขอ คงอยู่หรือจัดคิวเหตุการณ์ จากนั้นส่งคืนการตอบสนอง 2xx ที่สำเร็จ อย่าโทร CRM หรือส่งข้อความช้าๆ ก่อนการตอบรับ หากสามารถเข้าคิวได้อย่างปลอดภัย

สัมพันธ์กับ External ID

ทุกเหตุการณ์ที่เกี่ยวข้องสามารถพกพา External ID และ External Source เสริมที่คุณใช้เมื่อสร้างหรือสแกนการ์ด ใช้คู่นี้เพื่ออัปเดต CRM, POS หรือบันทึกการสั่งซื้อของคุณเองโดยไม่ต้องเดาจากชื่อหรืออีเมล

Make การนำส่ง idempotent

จัดเก็บคีย์การประมวลผลที่ทนทานหรือลายนิ้วมือของเหตุการณ์ก่อนที่จะกระตุ้นให้เกิดผลข้างเคียง หากผู้รับของคุณเห็นการจัดส่งแบบเดียวกันอีกครั้ง ไม่ควรเพิ่มบันทึก ใบสำคัญ หรือข้อความ CRM ที่ซ้ำกัน ถือว่าจุดปลาย URL เป็นความลับ

ตัวอย่างรูปร่างเพย์โหลดเหตุการณ์

คัดลอกสิ่งนี้ลงในขั้นตอนการทำงานอัตโนมัติของคุณ json
{
  "event_type": "SCAN",
  "scanned_at": "2026-07-23T12:34:56Z",
  "user_card_id": 123,
  "card_template_id": 42,
  "card_template_name": "Coffee Loyalty",
  "stamps_added": 1,
  "stamps_before": 4,
  "stamps_after": 5,
  "amount": 24.5,
  "external_order_id": "order_2048",
  "external_id": "crm_contact_8821",
  "external_source": "hubspot"
}

กำหนดค่าและทดสอบ webhook

01

สร้างตำแหน่งข้อมูล HTTPS ในแบ็กเอนด์ของคุณ, CRM integrated layer, Make webhook หรือ Zapier Catch Hook Make ต้องแน่ใจว่าคุณควบคุมปลายทางก่อนที่จะคัดลอก URL

02

ใน 7stamp Admin ให้เปิด Stamp Cards → API & Integrations → Webhooks

03

เพิ่มจุดปลาย URL และเลือกเฉพาะชนิดเหตุการณ์ที่เวิร์กโฟลว์การรับต้องการจริงๆ

04

บันทึกการตั้งค่าโปรไฟล์ จากนั้นทริกเกอร์การทดสอบการสแกนแบบใช้แล้วทิ้งหรือการดำเนินการของการ์ดเพื่อสร้างเหตุการณ์

05

ตรวจสอบเพย์โหลดที่ได้รับ จับคู่ External ID และ External Source กับเร็กคอร์ดที่คาดหวัง และยืนยันว่าผู้รับส่งคืนการตอบกลับที่สำเร็จ

06

เปิดใช้งาน CRM, voucher หรือผลข้างเคียงของการส่งข้อความหลังจากที่คุณมีการจัดการที่ปลอดภัยสำหรับการเล่นซ้ำและการมอนิเตอร์ความล้มเหลวเท่านั้น

อ็อพชันแบบไม่มีโค้ด: Make และ Zapier

ใน Make ให้ใช้ Webhooks → Custom webhook เพื่อสร้าง URL ที่รับ และวางลงในโปรไฟล์ 7stamp ใน Zapier ให้ใช้ Webhooks by Zapier → Catch Hook เพื่อจุดประสงค์เดียวกัน โปรไฟล์ 7stamp เป็นเจ้าของการสมัครสมาชิก เนื่องจาก API ปัจจุบันไม่เปิดเผยจุดปลายการลงทะเบียน webhook อัตโนมัติ

การรักษาความปลอดภัยและสัญญาการส่งมอบ

ใช้ส่วน Webhooks ของการอ้างอิง OpenAPI พับลิกเป็นแหล่งที่มาสำหรับสกีมาเพย์โหลดปัจจุบันและความหมายของฟิลด์ ต้องการ HTTPS เก็บตัวรับ URL ออกจากบันทึกพับลิก และทำให้การประมวลผลเป็น idempotent ยืนยันขั้นตอน request-authentication/signature สำหรับโปรไฟล์ 7stamp ของคุณในระหว่างการออนบอร์ด ก่อนที่จะบังคับใช้ชื่อส่วนหัวเฉพาะหรือลองนโยบายอีกครั้งในการใช้งานจริง

คำถามที่พบบ่อย

ฉันสามารถเลือกเฉพาะกิจกรรม webhook บางรายการได้หรือไม่

ใช่ เลือกประเภทเหตุการณ์ในการตั้งค่าเว็บฮุคของโปรไฟล์ 7stamp เพื่อให้ผู้รับได้รับเฉพาะเหตุการณ์ที่สำคัญต่อเวิร์กโฟลว์เท่านั้น

ฉันจะเชื่อมต่อ webhooks กับ Make หรือ Zapier ได้อย่างไร

สร้าง webhook ที่ได้รับใน Make หรือ Catch Hook ใน Zapier คัดลอก URL ที่สร้างขึ้น จากนั้นวางลงในการตั้งค่า webhook ของโปรไฟล์ 7stamp และส่งเหตุการณ์ทดสอบ

ฉันจะจับคู่เหตุการณ์กับผู้ติดต่อ CRM ของฉันได้อย่างไร

ใช้ External ID และ External Source หากมี สิ่งเหล่านี้คือตัวระบุที่การรวมระบบของคุณให้มาเมื่อสร้างหรือสแกนการ์ด

ฉันควรถือว่าส่วนหัวของลายเซ็นหรือลองกำหนดเวลาอีกครั้งหรือไม่

ไม่ ใช้สัญญาการส่งมอบ OpenAPI/profile ปัจจุบัน และยืนยันขั้นตอนการรับรองความถูกต้องสำหรับโปรไฟล์ของคุณในระหว่างการเริ่มต้นใช้งานก่อนที่จะฮาร์ดโค้ดส่วนหัวหรือลองอีกครั้ง

ขั้นตอนถัดไป

พร้อมส่งกิจกรรมการ์ดใบแรกหรือยัง?

สร้างตัวรับ วาง HTTPS URL ลงในโปรไฟล์ รันการสแกนแบบใช้แล้วทิ้ง และตรวจสอบความถูกต้องของ External ID ที่ตรงกันก่อนที่จะเปิดใช้งานดาวน์สตรีมอัตโนมัติ