สร้างการ์ดหลังจากผู้ติดต่อ CRM ใหม่
ใช้ผู้ติดต่อ CRM ID เป็น External ID สร้างคำเชิญการ์ด 7stamp จากนั้นส่งการติดตั้ง URL ที่ส่งคืนผ่านอีเมลปกติของคุณ SMS หรือขั้นตอนการส่งข้อความ
คู่มือการทำงานอัตโนมัติแบบไม่มีโค้ด
ใช้ Make เพื่อเชื่อมต่อ 7stamp กับ CRM, POS, ร้านค้าออนไลน์, สเปรดชีต, เครื่องมือส่งข้อความ หรือระบบใดๆ ที่สามารถส่งข้อมูลไปยังสถานการณ์ได้ เส้นทางที่พร้อมสำหรับการผลิตในวันนี้คือแอป HTTP ของ Make สำหรับการเรียก 7stamp API และ Make ของ Custom webhook สำหรับเหตุการณ์ 7stamp ที่เข้ามา
ยังไม่มีแอป 7stamp สาธารณะในตัวเลือกแอปของ Make อย่ารอ: เพิ่ม HTTP → Make a request ใช้ URL, เมธอด, ส่วนหัว Bearer และ JSON ด้านล่าง จากนั้นแมปฟิลด์จากโมดูลต้นทางของคุณ นี่เป็น 7stamp Integration API แบบเดียวกับที่ตัวเชื่อมต่อในอนาคตจะใช้
เริ่มต้นด้วยหนึ่งเหตุการณ์และหนึ่งผลลัพธ์ เมื่อข้อมูลการทดสอบถูกต้อง ให้เพิ่มตัวกรอง เราเตอร์ การอัพเดต CRM และข้อความติดตามผลโดยรอบ
ใช้ผู้ติดต่อ CRM ID เป็น External ID สร้างคำเชิญการ์ด 7stamp จากนั้นส่งการติดตั้ง URL ที่ส่งคืนผ่านอีเมลปกติของคุณ SMS หรือขั้นตอนการส่งข้อความ
ทริกเกอร์สถานการณ์จาก POS ที่ชำระเงินหรือคำสั่งซื้ออีคอมเมิร์ซ แมป ID ของลูกค้าที่มีความเสถียร และสั่งซื้อ ID ลงใน Scan a Card จากนั้นใช้จำนวนเงินหรือจำนวนแสตมป์ที่ชัดเจน
เมื่อกิจกรรมการ์ดรายงานรางวัลหรือบัตรกำนัล ให้แยกสถานการณ์: อัปเดต CRM แจ้งทีม และส่งพุชการ์ด Wallet หรืออีเมลเมื่อจำเป็นเท่านั้น
ใช้โมดูล Make ของ HTTP เพื่อเรียก 7stamp โดยตรง นี่คือตัวเลือกสากลสำหรับ POS, ERP แบบกำหนดเอง, กลไกการจอง หรือเซอร์วิสแรกสุดของ API ใดๆ
สำหรับแต่ละการ์ดด้านล่าง ให้เพิ่ม HTTP → Make a request จากนั้นตั้งค่าเมธอดและ URL ให้ตรงตามที่แสดง ใช้คีย์ Bearer เดียวกันสำหรับทุกคำร้องขอ การแมปที่จำเป็นจะบอกคุณว่าต้องจัดหาอะไรจาก CRM, POS หรือทริกเกอร์อีคอมเมิร์ซ
Webhooks → Custom webhook สร้าง Custom webhook ใน Make คัดลอก URL จากนั้นวาง URL นั้นลงในการตั้งค่า webhook โปรไฟล์ 7stamp สิ่งนี้จะเริ่มต้นสถานการณ์เมื่อ 7stamp ส่งเหตุการณ์ เช่น SCAN, REWARD_EARNED หรือ VOUCHER_ISSUED
POST /cards/invite สร้างการติดตั้งส่วนบุคคล URL และโค้ดการแทรกการนำส่งสำหรับผู้ติดต่อภายนอกหนึ่งราย
POST /cards/invite/bulk สร้างลิงก์คำเชิญได้มากถึง 100 ลิงก์ในคำขอเดียว ใช้สำหรับการโยกย้ายหรือแคมเปญที่มีการควบคุม ไม่ใช่การส่งออกผู้ติดต่อที่ไม่จำกัด
GET /cards ค้นหาบันทึกการ์ดตาม External ID พร้อมด้วยเทมเพลตเสริมและตัวกรองแหล่งที่มา
GET /cards/{user_card_id} อ่านสถานะเต็มของการ์ดหนึ่งใบ เมื่อขั้นตอนก่อนหน้าส่งคืน User Card ID ภายใน
POST /cards/scan เพิ่มแสตมป์จากยอดซื้อหรือการนับที่ชัดเจน ยอมรับ User Card ID หรือ External ID และสามารถเก็บการอ้างอิงคำสั่งภายนอกได้
GET /templates แสดงรายการเทมเพลตการ์ดที่ใช้ได้กับคีย์ API ใช้เพื่อทดสอบการเชื่อมต่อหรือเพื่อเลือกเทมเพลตแบบไดนามิก
GET /templates/{template_id}/design ส่งกลับการตั้งค่าการออกแบบภาพสำหรับเทมเพลตที่รู้จัก ซึ่งมีประโยชน์เมื่อระบบอื่นจำเป็นต้องแสดงตัวเลือกการ์ดที่สอดคล้องกัน
POST /vouchers/issue ออกบัตรกำนัลให้กับเจ้าของบัตรที่ระบุโดย External ID หรือ User Card ID
POST /messages/send ส่งเนื้อหาไปยังเจ้าของบัตรผ่านการพุชบัตรกระเป๋าสตางค์และอีเมล /or ขึ้นอยู่กับช่องทางที่กำหนดค่าและกฎการยินยอม
Full 7stamp endpoint URL นี่คือโมดูล Make ที่เรียกทุกเส้นทาง 7stamp ข้างต้น ใช้ URL ที่สมบูรณ์ เลือกวิธีการที่ระบุไว้ เพิ่มส่วนหัว Bearer และใช้ JSON เมื่อเส้นทางต้องการเนื้อหาเท่านั้น
ชื่อด้านล่างคือโมดูล Make จริง เริ่มต้นด้วยสถานการณ์แรก รันกับผู้ติดต่อแบบใช้แล้วทิ้ง และจากนั้นเพิ่มเราเตอร์ ตัวกรอง หรือการจัดกำหนดการการผลิตเท่านั้น
ผลลัพธ์ที่คาดหวัง: ลูกค้าได้รับ install_url ที่ส่งคืนโดย 7stamp; CRM ของคุณสามารถเก็บ URL นั้นไว้ในบันทึกผู้ติดต่อเดียวกัน
ตรวจสอบ: POST /cards/invite จะสร้างคำเชิญใหม่เสมอ ใช้ Find Cards ก่อน หากกฎทางธุรกิจของคุณคือการหลีกเลี่ยงการเชิญอีกครั้งสำหรับผู้ติดต่อที่มีอยู่
ผลลัพธ์ที่คาดหวัง: การตอบสนองการสแกนที่สำเร็จประกอบด้วยความสำเร็จ scan_id, stamps_added และสถานะการ์ดหลังการสแกนสำหรับขั้นตอนต่อไปของคุณ
ตรวจสอบ: ใช้ external_order_id เดียวกันในการลองใหม่ เพื่อให้สามารถติดตามลำดับได้ในเหตุการณ์ webhook ในภายหลัง อย่าให้รางวัลแสตมป์สองครั้งหลังจากการวิ่งล้มเหลวที่ไม่ชัดเจน
ผลลัพธ์ที่คาดหวัง: Make รับเหตุการณ์ 7stamp ทันทีและสามารถค้นหาบันทึก CRM ที่ตรงกันผ่าน external_id และ external_source
ตรวจสอบ: ทำให้ webhook URL เป็นส่วนตัว ทดสอบเหตุการณ์จริงก่อนเปิดข้อความ บัตรกำนัล หรือการเปลี่ยนแปลง CRM ที่ไม่สามารถย้อนกลับได้
นี่คือหน้าจอ 7stamp Admin ที่แน่นอน สร้างคีย์หนึ่งครั้ง คัดลอกลงในการเชื่อมต่อ HTTP ที่ปลอดภัยของ Make/keychain จากนั้นลบออกจากคลิปบอร์ดของคุณทันที หน้าจอ
ใน 7stamp Admin ไปที่ API & Integrations → API Keys → Add API Key เก็บค่าในการเชื่อมต่อคีย์ Make HTTP API/keychain ของ Make เมื่ออ็อพชันนั้นพร้อมใช้งาน อย่าแมปคีย์จากช่องข้อความ ใส่ไว้ในบันทึก หรือใช้เวิร์กโฟลว์ที่ต้องใช้เบราว์เซอร์ คีย์เป็นของสถานที่ทำงาน 7stamp แห่งเดียว/profile.
ที่เสถียร แมป ID ที่ไม่เปลี่ยนรูปจาก CRM, POS หรือแพลตฟอร์มการค้าของคุณ เช่น CRM ติดต่อ ID หรือลูกค้า UUID เพิ่ม External Source เช่น hubspot, shopify หรือโปสเตอร์ เมื่อตัวระบุเดียวกันอาจปรากฏในมากกว่าหนึ่งระบบ
เมื่อโปรไฟล์ 7stamp ที่เชื่อมต่อมีเทมเพลตการ์ดที่ใช้งานอยู่หนึ่งเทมเพลต คุณสามารถปล่อยเทมเพลตว่างไว้ได้ ด้วยเทมเพลตที่หลากหลาย สร้างแผนที่หรือเลือก template_id อย่างตั้งใจ เพื่อให้ทุกคำเชิญและการสแกนไปถึงโปรแกรมสะสมคะแนนที่ต้องการ
http Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Body type: Raw / JSON
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
} ใน 7stamp Admin สร้างคีย์ใน API & Integrations → API Keys → Add API Key ใช้โปรไฟล์ทดสอบแยกต่างหาก/key เมื่อการตั้งค่าบัญชีของคุณอนุญาต
ใน Make ให้สร้างสถานการณ์จำลองและเพิ่มทริกเกอร์ต้นทาง เรียกใช้งานหนึ่งครั้งก่อนที่จะแม็ป เพื่อให้คุณสามารถดูตัวอย่างการติดต่อจริงหรือคำสั่งซื้อที่ชำระเงินได้
คลิกเครื่องหมายบวกถัดไป ค้นหา HTTP และเลือก Make คำร้องขอ ตั้งค่าวิธีการ URL แบบเต็ม และส่วนหัวจากการ์ดการดำเนินการในหน้านี้
ใช้ GET https://api.7loc.com/cards-api/templates เป็นคำร้องขอแรก การตอบสนองที่ประสบความสำเร็จพิสูจน์ให้เห็นถึงผลงานหลักโดยไม่ต้องเปลี่ยนแปลงข้อมูลลูกค้าใดๆ
สำหรับเส้นทาง POST ให้เลือก application/json และวางรูปร่างจากคู่มือนี้ แมป External ID ที่เสถียร เพิ่ม template_id เฉพาะในกรณีที่โปรไฟล์มีหลายเทมเพลตที่แอ็คทีฟ
รันด้วยผู้ติดต่อแบบใช้แล้วทิ้ง ตรวจสอบเอาต์พุต HTTP และจากนั้นแม็พฟิลด์ตอบกลับที่แน่นอนลงในโมดูล CRM อีเมล หรือข้อความถัดไปเท่านั้น
ใช้ HTTP สำหรับ 7stamp ทันที: เป็นเส้นทางที่พร้อมสำหรับการผลิตที่ได้รับการบันทึกไว้ ไม่ใช่ทางเลือกที่ลดลง เลือกเมื่อใดก็ตามที่คุณต้องการการดำเนินการ 7stamp, เส้นทาง API ใหม่ หรือการเชื่อมต่อ POS/ERP แบบกำหนดเอง การอ้างอิง OpenAPI เป็นแหล่งที่มาของความจริงสำหรับเมธอด พาธแบบเต็ม เนื้อหา และสกีมาการตอบสนอง คีย์ผู้ถือและฐาน URL ยังคงเหมือนเดิม
สำหรับสถานการณ์จำลองที่ขับเคลื่อนด้วยเหตุการณ์ ให้เพิ่ม Webhooks → Custom webhook และสร้าง webhook คัดลอก URL เปิด API & Integrations → Webhooks ในโปรไฟล์ 7stamp วาง URL เลือกประเภทเหตุการณ์ บันทึก และส่งเหตุการณ์ทดสอบจริง โปรไฟล์ 7stamp เป็นเจ้าของการสมัครสมาชิกนั้น API ปัจจุบันไม่เปิดเผยจุดปลาย webhook Subscribe/unsubscribe อัตโนมัติ
คำแนะนำในเพจนี้ใช้โมดูล Make ที่พร้อมใช้งานสำหรับทุกบัญชี Make หากคุณต้องการโมดูล Native 7stamp ในอนาคต แทนที่จะเป็น HTTP โปรดส่งเวิร์กโฟลว์ที่คุณต้องการมาให้เรา จนกว่าจะถึงตอนนั้น HTTP และ Custom webhook จะครอบคลุมทุกการดำเนินการ 7stamp ที่จัดทำเอกสารไว้
ใช่ วันนี้ไม่มีแอป 7stamp สาธารณะใน Make เพิ่มคำร้องขอ HTTP > Make ใช้จุดปลาย 7stamp URL ที่สมบูรณ์ และส่ง Authorization: Bearer ตามด้วยคีย์ 7stamp API ของคุณ HTTP สามารถเรียกจุดปลายเอกสารทุกจุดได้
ใน 7stamp Admin ให้เปิด API Integrations จากนั้น API Keys จากนั้น Add API Key คีย์ถูกกำหนดขอบเขตไว้ที่สถานที่ทำงาน/profile ที่สร้างขึ้น ดังนั้นให้ใช้โปรไฟล์ทดสอบสำหรับสถานการณ์การทดสอบทุกครั้งที่เป็นไปได้
ใช้ตัวระบุที่เสถียรจากระบบต้นทาง โดยเฉพาะอย่างยิ่ง CRM ติดต่อ ID หรือลูกค้า UUID อย่าใช้ชื่อที่แสดง หมายเลขโทรศัพท์หรืออีเมลสามารถใช้งานได้ แต่สามารถเปลี่ยนแปลงได้และควรได้รับการจัดการอย่างสม่ำเสมอ
สร้าง Webhooks > Custom webhook ใน Make จากนั้นวาง URL ที่สร้างขึ้นลงในการตั้งค่า webhook ของโปรไฟล์ 7stamp ใช้ตัวกรอง Make หรือเราเตอร์หลังการส่งมอบเพื่อจัดการกับ event_type ขาเข้า
ขั้นตอนถัดไป
สร้างคีย์ API ทดสอบ List Templates และสร้างสถานการณ์คำเชิญหรือสแกนหนึ่งเหตุการณ์ด้วยผู้ติดต่อแบบใช้แล้วทิ้ง เพิ่มเราเตอร์และการส่งข้อความหลังจากขั้นตอนง่ายๆ นั้นเชื่อถือได้เท่านั้น