คู่มือการทำงานอัตโนมัติแบบไม่มีโค้ด

เชื่อมต่อ 7stamp กับ Zapier — ทีละขั้นตอน

คู่มือการใช้งาน

ใช้ Zapier เมื่อเวิร์กโฟลว์ของคุณมีลำดับที่ชัดเจน: ผู้ติดต่อหรือคำสั่งซื้อปรากฏขึ้น 7stamp ดำเนินการ จากนั้นเครื่องมือทางธุรกิจอื่นจะได้รับการอัปเดต เส้นทางที่ปลอดภัยวันนี้คือ API โดย Zapier สำหรับการเรียก 7stamp API ขาออก และ Webhooks by Zapier → Catch Hook สำหรับเหตุการณ์ 7stamp ขาเข้า

ไม่มีแอป 7stamp สาธารณะในตลาดของ Zapier ใช้ API by Zapier → API Request หากมี โดยจะจัดเก็บคีย์ API แบบคงที่ในการเชื่อมต่อแอป แทนที่จะเปิดเผยในขั้นตอน Zap ใช้ Webhooks by Zapier สำหรับเหตุการณ์ Catch Hook ขาเข้าเท่านั้น อย่าใส่คีย์ 7stamp Bearer ลงในฟิลด์การดำเนินการ Webhooks ที่มองเห็นได้

เปิด Zapier เปิด API อ้างอิง

เริ่มต้นด้วย Zap เชิงเส้นที่ทดสอบได้

เก็บ Zap อันแรกให้เล็กไว้ โฟลว์แบบติดต่อไปยังการ์ดหรือแบบชำระเงินตามคำสั่งซื้อไปยังแสตมป์ที่เชื่อถือได้เป็นจุดเริ่มต้นที่ดีกว่าการซิงค์ CRM แบบสองทางในวงกว้าง

สร้างคำเชิญจากผู้ติดต่อ CRM

ทริกเกอร์บนผู้ติดต่อใหม่หรือผู้ติดต่อที่ผ่านการรับรอง แม็พ CRM ID กับ External ID สร้างคำเชิญการ์ด และส่งการติดตั้ง URL ที่ส่งคืนไปยังอีเมลหรือขั้นตอน SMS

เพิ่มแสตมป์หลังจากชำระเงิน

Trigger จากคำสั่งซื้อที่ชำระเงินหรือใบเสร็จรับเงินที่ปิดแล้ว แมปข้อมูลระบุตัวตนของลูกค้าและคำสั่งซื้อ ID จากนั้นใช้ Scan Card กับจำนวนคำสั่งซื้อหรือจำนวนแสตมป์ที่ชัดเจน

ออกบัตรกำนัลการกู้คืนแบบครั้งเดียว

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

เขียนเหตุการณ์การ์ดกลับไปที่ CRM

ของคุณ ใช้ Webhooks by Zapier > Catch Hook เพื่อรับเหตุการณ์การ์ด 7stamp จับคู่ External ID ที่ส่งคืนกับเร็กคอร์ด CRM และเพิ่มบันทึกย่อ แท็ก หรืองานที่เกี่ยวข้อง

7stamp เพื่อโทรจาก API โดย Zapier

เพิ่ม API by Zapier → API Request หลังทริกเกอร์ของคุณ สร้างการเชื่อมต่อคีย์ 7stamp API หนึ่งรายการ จากนั้นเลือกวิธีการที่แน่นอนและ URL แบบเต็มด้านล่าง การดำเนินการแต่ละรายการจะส่งคืนฟิลด์ที่คุณสามารถแมปลงในขั้นตอน Zap ถัดไป

API โดยการดำเนินการ Zapier POST /cards/invite

สร้าง Card Invite

สร้างการติดตั้ง wallet-card ใหม่ URL และโค้ดการแทรกการจัดส่งสำหรับผู้ติดต่อภายนอกหนึ่งราย

ต้องใช้
external_id จากทริกเกอร์ CRM/contact
ขั้นตอนถัดไป
แม็พ install_url ในอีเมล, SMS หรือฟิลด์ CRM
API โดยการดำเนินการ Zapier POST /cards/invite/bulk

สร้าง Card Invites เป็นกลุ่ม

สร้างลิงก์เชิญได้มากถึง 100 ลิงก์จากแบตช์ JSON ที่มีการควบคุม

อาร์เรย์รายการ
ที่จำเป็นพร้อมอ็อบเจ็กต์การเชิญ 1–100 รายการ
ตรวจสอบ
อ่าน success_count, error_count และทุกผลลัพธ์ก่อนส่งมอบ
API โดยการดำเนินการ Zapier POST /cards/scan

Scan Card

เพิ่มแสตมป์โดย User Card ID หรือ External ID พร้อมด้วยจำนวนเงิน จำนวนแสตมป์ คำสั่งซื้อ ID และข้อมูลการรับเพิ่มเติม

Identity
external_id บวก external_source เสริม; user_card_id ชนะหากมีทั้งสองรายการ
กฎการประทับตรา
stamps_count มีลำดับความสำคัญมากกว่าจำนวน
API โดยการดำเนินการ Zapier POST /vouchers/issue

Issue Voucher

ออกบัตรกำนัลให้กับเจ้าของบัตรโดยตรง

บัตรกำนัล
ที่จำเป็น short_description และเป้าหมาย external_id หรือ user_card_id ที่รู้จัก
ผลลัพธ์
แม็พ unique_code สถานะ หรือ expires_at กับโน้ตหรือข้อความ CRM
API โดย Zapier action POST /messages/send

Send Message

ส่ง wallet-card push และเนื้อหาอีเมล /or ไปยังเจ้าของการ์ด

การพุชการ์ด
card_push_text จำกัดอยู่ที่ 20 อักขระ
อีเมล หัวเรื่อง
และเนื้อหา; ผลลัพธ์จะรายงานว่าการจัดส่งอยู่ในคิวหรือไม่
API โดย Zapier แอ็คชัน GET /cards

Find Cards

ค้นหาเรคคอร์ดการ์ดโดย External ID พร้อมด้วยแหล่งตัวเลือกและตัวกรองเทมเพลต

ต้องใช้
external_id เป็นพารามิเตอร์เคียวรี
ใช้ครั้งแรก
ใช้ก่อนสร้างคำเชิญเมื่อกฎของคุณหลีกเลี่ยงการเชิญซ้ำกัน
API โดยการดำเนินการ Zapier GET /cards/{user_card_id}

รับรายละเอียดการ์ด

อ่านสถานะของการ์ดโดย 7stamp ภายใน ID

จำเป็น
แทนที่ {user_card_id} ด้วย ID ที่ส่งคืนโดย 7stamp
เอาต์พุตที่มีประโยชน์
stamps_count, สถานะกระเป๋าสตางค์ และ active_vouchers_count
API โดย Zapier แอ็คชัน GET /templates

List Templates

แสดงรายการเทมเพลตที่พร้อมใช้งานสำหรับโปรไฟล์ที่เชื่อมต่อ และตรวจสอบการเชื่อมต่อ API

ทดสอบครั้งแรก
เรียกมันก่อนดำเนินการเขียน: ไม่มีการเปลี่ยนแปลงข้อมูลลูกค้า
ใช้
ในภายหลัง id ที่แอ็คทีฟจะกลายเป็น template_id เมื่อมีหลายเทมเพลต
API โดย Zapier แอ็คชัน GET /templates/{template_id}/design

Get Template Design

เรียกค่าติดตั้งการออกแบบของเทมเพลตสำหรับเทมเพลตที่รู้จัก ID

Zapier ทริกเกอร์ Webhooks by Zapier → Catch Hook

รับเหตุการณ์การ์ด

Catch Hook ให้ Zapier HTTPS URL ที่ไม่ซ้ำใคร วางลงในการตั้งค่าเว็บฮุคของ 7stamp Admin และทดสอบกับเหตุการณ์การ์ดจริง

ใน Zapier
ใช้ Catch Hook สำหรับข้อมูลเหตุการณ์ที่แยกวิเคราะห์ ใช้ Catch Raw Hook เฉพาะเมื่อคุณต้องการส่วนหัวคำร้องขอดิบ /body.
จับคู่
ค้นหาผู้ติดต่อ CRM โดยใช้ external_id และ external_source ทางเลือกจากเหตุการณ์

เวิร์กโฟลว์ Zapier สามเวิร์กโฟลว์ที่คุณสามารถสร้างได้ทีละขั้นตอน

แต่ละสถานการณ์ใช้โมดูล Zapier จริงที่พร้อมใช้งานในปัจจุบัน สร้างเส้นทางเล็กๆ เส้นหนึ่งก่อนแล้วทดสอบด้วยหน้าสัมผัสแบบใช้แล้วทิ้งก่อนเปิด Zap

1. ผู้ติดต่อ CRM ที่ผ่านการรับรอง → ออกการ์ด

ผลลัพธ์ที่คาดหวัง: ขั้นตอน Zap ถัดไปจะได้รับ install_url และสามารถส่งไปให้ลูกค้าหรือเขียนกลับไปที่บันทึก CRM

  1. 1 สร้าง Zap และเลือกเหตุการณ์ CRM ซึ่งหมายความว่าผู้ติดต่อมีสิทธิ์ได้รับความภักดี ทดสอบทริกเกอร์และยืนยันว่าคุณมี ID ที่ไม่เปลี่ยนรูปของผู้ติดต่อ
  2. 2 เพิ่ม API by Zapier → API Request สร้างหรือเลือกการเชื่อมต่อคีย์ 7stamp API เลือก POST และตั้งค่า URL เป็น https://api.7loc.com/cards-api/cards/invite.
  3. 3 ตั้งค่าเนื้อหาเป็น JSON แม็พ CRM ID เข้ากับ external_id ตั้งค่า external_source คงที่ เช่น kommo และเพิ่ม template_id เมื่อเทมเพลต 7stamp มากกว่าหนึ่งเทมเพลตแอ็คทีฟเท่านั้น
  4. 4 ทดสอบแอ็คชัน ยืนยันการตอบสนองที่มี install_url และ delivery_insert_code สำหรับ external_id เดียวกัน
  5. 5 เพิ่มการดำเนินการอัพเดต CRM อีเมล หรือ SMS ของคุณ แม็พ install_url จากการตอบกลับ API อย่าฮาร์ดโค้ดหรือคัดลอกการทดสอบ URL

ตรวจสอบ: สร้าง Card Invite จะส่งคืนคำเชิญใหม่เสมอ เพิ่มคำขอ Find Cards หรือตัวกรอง Zapier ก่อน หากนโยบายของคุณมีหนึ่งคำเชิญต่อผู้ติดต่อ

2. คำสั่งซื้อที่ชำระเงิน → ประทับตรารางวัล

ผลลัพธ์ที่คาดหวัง: คำสั่งซื้อจะสร้างการสแกน 7stamp ที่ติดตามได้ และ Zap สามารถบันทึก stamps_added หรือ scan_id ในระบบต้นทางได้

  1. 1 ใช้ทริกเกอร์ใบเสร็จรับเงิน /Closed และทดสอบ ยืนยันว่าลูกค้า ID และคำสั่งซื้อเฉพาะ ID มีอยู่ทั้งคู่ก่อนดำเนินการต่อ
  2. 2 เพิ่ม API by Zapier → API Request ด้วย POST https://api.7loc.com/cards-api/cards/scan และเลือกการเชื่อมต่อ 7stamp เดียวกัน
  3. 3 ส่ง JSON ด้วย external_id, external_source, external_order_id และจำนวนอย่างใดอย่างหนึ่งสำหรับเทมเพลตตามจำนวน หรือ stamps_count สำหรับรางวัลการประทับตราที่ชัดเจน
  4. 4 ทดสอบด้วยคำสั่งใช้แล้วทิ้ง ตรวจสอบความสำเร็จ scan_id และ stamps_added ในการตอบกลับ
  5. 5 เพิ่มตัวกรองที่ดำเนินการต่อหลังจากการตอบกลับสำเร็จเท่านั้น จากนั้นอัพเดตลำดับ /CRM ด้วยผลลัพธ์ที่ยืนยันแล้ว

ตรวจสอบ: หากมีการเล่น Zap ซ้ำ ให้ตรวจสอบลำดับเดิมก่อนที่จะส่งการสแกนอีกครั้ง รักษา external_order_id ให้เสถียรเพื่อให้สามารถกระทบยอดเหตุการณ์ได้ในภายหลัง

3. เหตุการณ์ 7stamp → สร้างบันทึกย่อหรืองาน CRM

ผลลัพธ์ที่คาดหวัง: Zapier ได้รับเหตุการณ์ 7stamp ที่แยกวิเคราะห์ ค้นหาลูกค้าโดย external_id และสร้างการติดตามผลที่เหมาะสม

  1. 1 สร้าง Zap ใหม่โดยมี Webhooks by Zapier เป็นตัวกระตุ้น เลือก Catch Hook ดำเนินการต่อ และคัดลอก URL เฉพาะที่แสดงในขั้นตอนการทดสอบ
  2. 2 ใน 7stamp Admin เปิด API & Integrations → Webhooks เพิ่ม Catch Hook URL เลือกเฉพาะชนิดเหตุการณ์ที่จำเป็น และบันทึก
  3. 3 ทำให้เกิดการทดสอบจริงหรือเหตุการณ์การ์ด ย้อนกลับไปใน Zapier คลิก Test trigger และยืนยันว่า event_type, external_id และ external_source มาถึงเป็นฟิลด์ตัวอย่าง
  4. 4 เพิ่มการดำเนินการ CRM Find Contact โดยใช้ external_id เพิ่มกฎตัวกรองหรือพาธสำหรับ event_type เช่น แยก SCAN ออกจาก REWARD_EARNED
  5. 5 สร้าง CRM note/task และแม็พเฉพาะฟิลด์ที่มีอยู่สำหรับเหตุการณ์นั้น เช่น scanned_at, stamps_after, external_order_id หรือ issued_vouchers

ตรวจสอบ: Catch Hook URL เป็นความลับ หาก Zap ถูกโอนไปยังเจ้าของรายอื่น ให้อัพเดต URL ใน 7stamp Admin ก่อนที่จะใช้งาน

สร้างคีย์ 7stamp API ก่อนที่จะสร้าง Zap

นี่คือขั้นตอนด้าน 7stamp ทำสิ่งนี้เพียงครั้งเดียว จากนั้นใช้คีย์เฉพาะภายในการเชื่อมต่อ API โดย Zapier เท่านั้น ไม่ใช่ในฟิลด์การดำเนินการ Webhooks by Zapier หรือบันทึกย่อ หน้าจอ

7stamp Admin API & Integrations พร้อมด้วยการกระทำ Add API Key
เปิด API & Integrations เลือก API Keys จากนั้นสร้างคีย์แยกต่างหากสำหรับ Zap ซึ่งการตั้งค่าบัญชีของคุณอนุญาต
คีย์ 7stamp API ที่สร้างขึ้นใหม่พร้อมที่จะคัดลอก
คัดลอกคีย์ลงใน API ที่ปลอดภัยโดยการเชื่อมต่อ Zapier ไม่ใช่ในขั้นตอน Webhooks แบบข้อความธรรมดาหรือเอกสารที่แบ่งใช้

กฎการเชื่อมต่อที่ป้องกันข้อมูลไม่ตรงกัน

เก็บคีย์ API ไว้ใน API โดยการเชื่อมต่อ Zapier

ใน 7stamp Admin ให้เลือก API & Integrations → API Keys → Add API Key ใน API โดย Zapier ให้สร้างการเชื่อมต่อคีย์ API ด้วยส่วนหัว Authorization แบบสแตติกที่มี Bearer ตามด้วยคีย์นั้น API โดย Zapier เก็บหนังสือรับรองในการเชื่อมต่อแทนขั้นตอน Zap ที่มองเห็นได้ จำกัดการเข้าถึงการเชื่อมต่อและหมุนคีย์หากมีการเปิดเผย

แผนที่ External ID และ External Source อย่างสม่ำเสมอ

External ID เป็นตัวระบุลูกค้าที่มั่นคงของคุณเอง ป้ายกำกับ External Source ที่มาจาก เช่น hubspot, bitrix24, shopify หรือโปสเตอร์ ใช้คู่เดียวกันสำหรับการสร้าง ค้นหา สแกน ใบสำคัญ และโฟลว์เว็บฮุค

รู้ว่าตัวระบุการ์ดตัวใดชนะ

การดำเนินการกำหนดเป้าหมายการ์ดยอมรับ User Card ID หรือ External ID เมื่อทั้งสองปรากฏ User Card ID จะมีลำดับความสำคัญ ใช้ ID ภายในหลังจากที่ส่งคืนโดยขั้นตอน 7stamp ที่เชื่อถือได้เท่านั้น หรือเลือกใช้ระบบต้นทาง External ID

ตรงตามเงื่อนไข API โดยคำขอ Zapier: ให้รางวัลหนึ่งแสตมป์

คัดลอกสิ่งนี้ลงในขั้นตอนการทำงานอัตโนมัติของคุณ http 
Method: POST
URL: https://api.7loc.com/cards-api/cards/scan
Headers:
  Authorization: Bearer YOUR_7STAMP_API_KEY
  Content-Type: application/json
Data:

{
  "external_id": "crm_contact_8821",
  "external_source": "hubspot",
  "stamps_count": 1,
  "external_order_id": "order_2048"
}

สร้าง Zap แรกของคุณ

01

สร้างคีย์ 7stamp API ในผู้ดูแลระบบ: API & Integrations → API Keys → Add API Key ใช้คีย์ทดสอบ /profile แยกต่างหากเมื่อพร้อมใช้งาน

02

ใน Zapier ให้สร้าง Zap และทดสอบทริกเกอร์ต้นทาง ใช้ตัวอย่างจริงเพื่อให้ผู้ติดต่อ ID, ลูกค้า ID, คำสั่งซื้อ ID และจำนวนเงินพร้อมสำหรับการแมป

03

เพิ่ม API by Zapier → API Request สร้างการเชื่อมต่อ 7stamp สำหรับส่วนหัว Bearer Authorization แบบสแตติก แทนที่จะใส่ข้อมูลลับในฟิลด์การดำเนินการ Webhooks by Zapier

04

เรียก GET https://api.7loc.com/cards-api/templates ก่อน นี่เป็นการยืนยันการทำงานหลักและแสดงว่ารหัสเทมเพลตที่ใช้งานอยู่ใดบ้างที่พร้อมใช้งานโดยไม่ต้องแก้ไขข้อมูลลูกค้า

05

เลือก POST /cards/invite หรือ POST /cards/scan ตั้งค่า JSON เป็นประเภทเนื้อหา และแมป External ID ที่เสถียรบวกกับฟิลด์เทมเพลต /order ที่เกี่ยวข้องจากทริกเกอร์

06

ดำเนินการด้วยผู้ติดต่อแบบใช้แล้วทิ้ง ตรวจสอบฟิลด์การตอบกลับที่แน่นอน จากนั้นแมปฟิลด์เหล่านั้นลงในขั้นตอน CRM อีเมล หรือการส่งข้อความถัดไปก่อนที่จะเผยแพร่ Zap

ใช้คำขอสากลสำหรับเส้นทางที่มีเอกสารประกอบเท่านั้น

ใช้ API โดย Zapier สำหรับคำขอ 7stamp ด้วยคีย์ Bearer API: โดยจะเก็บคีย์ส่วนหัวแบบคงที่ไว้ในการเชื่อมต่อแอป ใช้ Webhooks by Zapier สำหรับการนำส่งเหตุการณ์ Catch Hook ไม่ใช่ตำแหน่งที่ต้องการสำหรับข้อมูลลับ 7stamp เก็บฐาน URL ไว้ที่ https://api.7loc.com/cards-api, ใช้การอ้างอิง OpenAPI สาธารณะสำหรับสกีมาที่แน่นอน และอย่าส่งข้อมูลประจำตัวหรือข้อมูลลูกค้าไปยัง URL ที่ไม่ได้รับการตรวจสอบ

รับเหตุการณ์ 7stamp ผ่าน Catch Hook

สร้าง Webhooks by Zapier → Catch Hook คัดลอก URL เฉพาะที่แสดงในการตั้งค่าการทดสอบ วางลงในการตั้งค่า webhook ของโปรไฟล์ 7stamp เลือกประเภทเหตุการณ์ จากนั้นส่งการสแกนการทดสอบจริงหรือเหตุการณ์การ์ด ใช้ External ID และ External Source ของเพย์โหลดเหตุการณ์เพื่อค้นหาตำแหน่งผู้ติดต่อ CRM ที่ถูกต้อง เลือก Catch Raw Hook เฉพาะเมื่อคุณต้องการเนื้อหาที่ไม่ได้แยกวิเคราะห์และส่วนหัวของคำขอเป็นพิเศษ

ใช้เส้นทาง Zapier ที่ปลอดภัยทันที

API โดย Zapier และ Catch Hook เพียงพอสำหรับการดำเนินการ 7stamp API พับลิกทุกรายการและเหตุการณ์การ์ด หากคุณต้องการแอป 7stamp Zapier แบบเนทีฟในอนาคต โปรดส่งการดำเนินการที่แน่นอน /trigger ที่ทีมของคุณใช้บ่อยที่สุดมาให้เรา

ถามเกี่ยวกับตัวเชื่อมต่อเนทิฟ

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

ฉันจะหาแอป 7stamp ใน Zapier ได้ที่ไหน

ไม่มีแอปตลาด 7stamp สาธารณะในปัจจุบัน ใช้ API by Zapier → API Request สำหรับการเรียก 7stamp API และ Webhooks by Zapier → Catch Hook สำหรับเหตุการณ์ 7stamp ขาเข้า

ฉันจะสร้างโทเค็น Zapier ได้ที่ไหน

สร้างคีย์ 7stamp API ใน Admin ภายใต้ API & Integrations → API Keys → Add API Key จัดเก็บเป็นส่วนหัว Bearer Authorization แบบคงที่ในการเชื่อมต่อ API โดย Zapier ไม่ใช่ในฟิลด์การดำเนินการ Webhooks by Zapier ที่มองเห็นได้

Zapier สามารถรับแสตมป์หรือบัตรกำนัลเหตุการณ์ได้อย่างไร?

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

ฉันควรเลือก Zapier หรือ Make หรือไม่

เลือก Zapier สำหรับเวิร์กโฟลว์การดำเนินการทริกเกอร์เชิงเส้นเป็นส่วนใหญ่ เลือก Make เมื่อคุณต้องการเราเตอร์ การแปลงที่ซับซ้อน หรือสถานการณ์แบบหลายสาขาที่ยาวนาน ทั้งสองใช้คีย์ 7stamp API และจุดปลายเดียวกัน

หน้าที่เกี่ยวข้อง

เปิด Zapier API โดย Zapier ช่วย Zapier Catch Hook ช่วย 7stamp API อ้างอิง การตั้งค่า Webhook Make คู่มือ

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

สร้างครั้งแรก Zap ด้วยคอนแทคเลนส์ทดสอบ

สร้างคีย์ API ทดสอบ GET /templates ถึง API โดย Zapier จากนั้นสร้างการดำเนินการแบบสัมผัสต่อการ์ดหรือคำสั่งต่อแสตมป์ เพิ่ม Catch Hook เมื่อโฟลว์ขาออกมีผลการทดสอบที่พิสูจน์แล้ว

เปิด 7stamp Admin อ่านการดำเนินการอ้างอิง API