Tạo thẻ sau liên hệ CRM mới
Sử dụng liên hệ CRM ID dưới dạng External ID, tạo lời mời thẻ 7stamp, sau đó gửi cài đặt được trả lại URL thông qua email thông thường của bạn, SMS hoặc bước nhắn tin.
Hướng dẫn tự động hóa không cần mã
Kết nối 7stamp với Make — từng bước
Hướng dẫn triển khaiSử dụng Make để kết nối 7stamp với CRM, POS, cửa hàng trực tuyến, bảng tính, công cụ nhắn tin hoặc bất kỳ hệ thống nào có thể gửi dữ liệu vào một tình huống. Lộ trình sẵn sàng sản xuất hôm nay là ứng dụng HTTP của Make cho các cuộc gọi 7stamp API và Make's Custom webhook cho các sự kiện sắp tới 7stamp.
Chưa có ứng dụng 7stamp công khai nào trong bộ chọn ứng dụng của Make. Đừng chờ đợi một: hãy thêm HTTP → Make a request, sử dụng chính xác URL, phương thức, tiêu đề Bearer và JSON bên dưới, sau đó ánh xạ các trường từ mô-đun nguồn của bạn. Đây cũng chính là 7stamp Integration API mà trình kết nối trong tương lai sẽ sử dụng.
Chọn kịch bản đầu tiên phù hợp với quy trình làm việc của bạn
Bắt đầu với một sự kiện và một kết quả. Sau khi dữ liệu kiểm tra chính xác, hãy thêm bộ lọc, bộ định tuyến, bản cập nhật CRM và các thông báo tiếp theo xung quanh dữ liệu đó.
Thêm tem sau đơn hàng đã thanh toán
Kích hoạt kịch bản từ đơn hàng POS hoặc thương mại điện tử đã thanh toán. Lập bản đồ khách hàng ổn định ID và đặt hàng ID vào phần Quét thẻ, sau đó sử dụng số tiền hoặc số lượng tem rõ ràng.
Gửi phần thưởng theo dõi
Khi một sự kiện thẻ báo cáo phần thưởng hoặc phiếu thưởng, hãy phân nhánh kịch bản: cập nhật CRM, thông báo cho nhóm và chỉ gửi email hoặc đẩy thẻ ví khi cần.
Xử lý hệ thống không có ứng dụng Make gốc
Sử dụng mô-đun HTTP của Make để gọi trực tiếp 7stamp. Đây là lựa chọn phổ biến cho POS, ERP, công cụ đặt chỗ tùy chỉnh hoặc bất kỳ dịch vụ đầu tiên nào của API.
7stamp thao tác gọi từ Make HTTP
Đối với mỗi thẻ bên dưới, hãy thêm HTTP → Make a request, sau đó đặt phương thức và URL chính xác như được hiển thị. Sử dụng cùng một phím Bearer cho mọi yêu cầu. Ánh xạ bắt buộc sẽ cho bạn biết những gì cần cung cấp từ CRM, POS hoặc trình kích hoạt thương mại điện tử của bạn.
Trình kích hoạt Make
Webhooks → Custom webhook Nhận sự kiện thẻ
Tạo Custom webhook trong Make, sao chép URL của nó, sau đó dán URL đó vào cài đặt webhook của hồ sơ 7stamp. Điều này bắt đầu một kịch bản khi 7stamp gửi một sự kiện như SCAN, REWARD_EARNED hoặc VOUCHER_ISSUED.
- Trong Make
- Webhooks → Custom webhook → Thêm; đặt tên rõ ràng cho nó và sao chép URL mà nó tạo ra.
- Trong 7stamp
- Quản trị viên → API & Integrations → Webhooks; dán URL, chọn loại sự kiện, lưu, sau đó tạo sự kiện thử nghiệm.
HTTP hành động
POST /cards/invite Tạo hành động Card Invite
Tạo cài đặt cá nhân mới URL và mã chèn phân phối cho một liên hệ bên ngoài.
- Bắt buộc
- external_id — lập bản đồ chuồng ngựa của bạn CRM/contact ID, không phải tên.
- Sau đó, sử dụng
- Bản đồ install_url từ phản hồi vào email của bạn, SMS hoặc CRM bước cập nhật.
HTTP hành động
POST /cards/invite/bulk Tạo hàng loạt Card Invites
Tạo tối đa 100 liên kết mời trong một yêu cầu. Sử dụng nó để di chuyển hoặc chiến dịch có kiểm soát, không phải xuất liên hệ không giới hạn.
- Bắt buộc
- mục — một mảng JSON gồm 1–100 đối tượng yêu cầu mời riêng lẻ.
- Kiểm tra
- Đọc success_count, error_count và từng kết quả trước khi gửi bất kỳ liên kết nào.
HTTP hành động
GET /cards Find Cards
Tìm bản ghi thẻ theo External ID, với các bộ lọc nguồn và mẫu tùy chọn.
- Bắt buộc
- Tham số truy vấn external_id.
- Tùy chọn
- external_source và template_id thu hẹp phạm vi tra cứu khi một hệ thống có nhiều chương trình.
HTTP hành động
GET /cards/{user_card_id} Nhận chi tiết thẻ
Đọc trạng thái đầy đủ của một thẻ khi bước trước đã trả về nội bộ User Card ID.
- Bắt buộc
- Thay thế {user_card_id} bằng ID nội bộ được trả về bởi phản hồi 7stamp đáng tin cậy.
- Tránh
- Không đoán hoặc lưu thẻ ID từ một hồ sơ khác.
HTTP hành động
POST /cards/scan Quét thẻ
Thêm tem từ số tiền mua hoặc số lượng rõ ràng. Nó chấp nhận User Card ID hoặc External ID và có thể giữ lại tham chiếu đơn hàng bên ngoài.
- Danh tính
- Sử dụng external_id và tùy chọn external_source; user_card_id thắng nếu cả hai đều được cung cấp.
- Mua hàng
- Sử dụng số tiền cho thẻ dựa trên số tiền hoặc stamps_count cho một số rõ ràng; stamps_count được ưu tiên.
- Truy xuất nguồn gốc
- Bản đồ external_order_id từ đơn hàng đã thanh toán/receipt để các sự kiện 7stamp có thể được khớp lại.
HTTP hành động
GET /templates List Templates
Liệt kê các mẫu thẻ có sẵn cho phím API. Sử dụng nó để kiểm tra kết nối hoặc chọn mẫu động.
- Thử nghiệm đầu tiên
- Đây là yêu cầu đầu tiên an toàn nhất: nó không có nội dung và không thay đổi dữ liệu khách hàng.
- Lập bản đồ sau
- Chỉ sử dụng id của mẫu đang hoạt động là template_id khi hồ sơ có nhiều mẫu đang hoạt động.
HTTP hành động
GET /templates/{template_id}/design Get Template Design
Trả về cài đặt thiết kế trực quan cho một mẫu đã biết, hữu ích khi hệ thống khác cần hiển thị lựa chọn thẻ nhất quán.
HTTP hành động
POST /vouchers/issue Phát hành Phiếu thưởng
Cấp phiếu thưởng cho chủ thẻ được xác định bởi External ID hoặc User Card ID.
- Bắt buộc phải có
- phiếu thưởng.short_description. Nhắm mục tiêu thẻ bằng external_id hoặc user_card_id đã biết.
- Hiệu lực
- Sử dụng validity_type với validity_value hoặc đọc tài liệu tham khảo OpenAPI để biết ngày hết hạn cố định.
HTTP hành động
POST /messages/send Gửi tin nhắn
Gửi nội dung cho chủ sở hữu thẻ thông qua email đẩy thẻ ví và/or, tuân theo kênh đã định cấu hình và các quy tắc đồng ý.
- Đẩy thẻ
- card_push_text được giới hạn ở 20 ký tự và yêu cầu cài đặt thẻ ví.
- Gửi chủ đề kèm theo nội dung; cơ bản HTML được hỗ trợ trong cơ thể.
Make mô-đun
Full 7stamp endpoint URL HTTP → Make a request
Đây là mô-đun Make gọi mọi tuyến đường 7stamp ở trên. Sử dụng URL hoàn chỉnh, chọn phương thức được ghi lại, thêm tiêu đề Bearer và chỉ sử dụng JSON khi tuyến đường cần phần nội dung.
- Cơ sở URL
- https://api.7loc.com/cards-api
- Tiêu đề
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json cho các yêu cầu POST.
Ba kịch bản Make bạn có thể xây dựng chính xác như đã viết
Các tên bên dưới là các mô-đun Make thực. Bắt đầu với kịch bản đầu tiên, chạy nó với một liên hệ dùng một lần và chỉ sau đó thêm bộ định tuyến, bộ lọc hoặc lập kế hoạch sản xuất.
1. Liên hệ CRM mới → gửi liên kết thẻ 7stamp
Kết quả mong đợi: Khách hàng nhận được install_url được trả lại bởi 7stamp; CRM của bạn có thể giữ URL đó trong cùng một bản ghi liên hệ.
- 1 Tạo một kịch bản và thêm Trình kích hoạt liên hệ MớiCRM của CRM của bạn. Đối với Kommo, hãy chọn trình kích hoạt tạo liên hệ và chạy nó một lần để tải một liên hệ mẫu.
- 2 Thêm HTTP → Make a request. Đặt Phương thức thành POST và URL thành https://api.7loc.com/cards-api/cards/invite.
- 3 Thêm Authorization: Bearer YOUR_7STAMP_API_KEY và Content-Type: application/json. Trong phần nội dung JSON, ánh xạ liên hệ CRM ID vào external_id và đặt external_source thành nhãn cố định chẳng hạn như kommo.
- 4 Chạy mô-đun HTTP một lần. Xác nhận đầu ra có install_url, delivery_insert_code, external_id và template_id.
- 5 Thêm email của bạn/SMS/CRM cập nhật mô-đun sau HTTP và ánh xạ install_url từ đầu ra HTTP. Lưu URL trên liên hệ CRM nếu nhóm phải gửi lại sau.
Kiểm tra: POST /cards/invite luôn tạo ra lời mời mới. Trước tiên, hãy sử dụng Find Cards nếu quy tắc công việc của bạn là tránh lời mời khác cho người liên hệ hiện có.
2. Đơn hàng trả phí → thêm tem khách hàng thân thiết
Kết quả mong đợi: Phản hồi quét thành công bao gồm thành công, scan_id, stamps_added và trạng thái thẻ sau quét cho bước tiếp theo của bạn.
- 1 Bắt đầu từ trình kích hoạt Đơn hàng trả phí POS/ecommerce. Make chắc chắn rằng mẫu của nó có lượng khách hàng ổn định ID và đơn hàng/receipt ID.
- 2 Thêm HTTP → Make a request với POST https://api.7loc.com/cards-api/cards/scan và tiêu đề Bearer tương tự.
- 3 Bản đồ external_id từ khách hàng, external_source từ tên hệ thống và external_order_id từ đơn đặt hàng ID. Thêm số tiền cho thẻ dựa trên số tiền hoặc stamps_count cho số lượng tem rõ ràng.
- 4 Run once với đơn hàng kiểm tra. Kiểm tra cờ thành công được trả về và stamps_added trước khi bật lịch trình kịch bản.
- 5 Tùy chọn thêm bộ lọc sau bước HTTP: chỉ tiếp tục khi thành công là đúng, sau đó viết scan_id hoặc stamps_added quay lại thứ tự/CRM ghi lại.
Kiểm tra: Sử dụng tương tự external_order_id khi thử lại để có thể theo dõi thứ tự trong các sự kiện webhook sau này; không trao tem hai lần sau một lần chạy thất bại không rõ ràng.
3. Sự kiện 7stamp → cập nhật CRM
Kết quả mong đợi: Make nhận được sự kiện 7stamp ngay lập tức và có thể tìm thấy bản ghi CRM phù hợp thông qua external_id và external_source.
- 1 Tạo một kịch bản Make riêng biệt. Thêm Webhooks → Custom webhook, chọn Thêm, đặt tên là 7stamp-card-event và sao chép URL đã tạo.
- 2 Trong 7stamp Admin, mở API & Integrations → Webhooks. Thêm URL đó và chọn một nhóm sự kiện nhỏ, ví dụ: SCAN và REWARD_EARNED.
- 3 Tạo sự kiện thẻ hoặc quét thử nghiệm dùng một lần trong 7stamp. Quay lại Make và sử dụng Run once để cho Make xác định cấu trúc dữ liệu sự kiện.
- 4 Thêm bước tìm kiếm CRM bằng cách sử dụng external_id. Thêm bộ lọc hoặc bộ định tuyến trên event_type để SCAN, REWARD_EARNED và VOUCHER_ISSUED có thể thực hiện các hành động khác nhau.
- 5 Thêm hành động CRM cập nhật/note. Bản đồ scanned_at, stamps_after, external_order_id và issued_vouchers chỉ khi các trường đó hiển thị cho loại sự kiện đã chọn.
Kiểm tra: Giữ webhook URL ở chế độ riêng tư. Kiểm tra một sự kiện có thật trước khi bật các tin nhắn, phiếu thưởng hoặc thay đổi CRM không thể đảo ngược.
Lấy khóa 7stamp API trước khi mở Make
Đây là những màn hình 7stamp Admin chính xác. Tạo khóa một lần, sao chép nó vào kết nối HTTP an toàn của Make, sau đó xóa ngay lập tức khỏi bảng nhớ tạm của bạn.
Chuẩn bị kết nối trước khi xây dựng
Tạo một khóa API cho mỗi môi trường
Trong 7stamp Admin, đi tới API & Integrations → API Keys → Add API Key. Lưu trữ giá trị trong Make's HTTP API-kết nối khóa/keychain khi tùy chọn đó khả dụng. Không bao giờ ánh xạ khóa từ trường văn bản, đặt khóa vào ghi chú hoặc sử dụng khóa đó trong quy trình làm việc trên trình duyệt. Chìa khóa thuộc về một 7stamp nơi làm việc/profile.
Sử dụng External ID
Lập bản đồ ID bất biến từ CRM, POS hoặc nền tảng thương mại—ví dụ: liên hệ CRM ID hoặc khách hàng UUID. Thêm External Source chẳng hạn như hubspot, shopify hoặc poster khi cùng một mã nhận dạng có thể xuất hiện trong nhiều hệ thống.
Quyết định áp dụng mẫu nào
Khi hồ sơ 7stamp được kết nối có một mẫu thẻ đang hoạt động, Mẫu có thể để trống. Với nhiều mẫu, hãy lập bản đồ hoặc chọn template_id một cách có chủ ý để mọi lời mời và lượt quét đều đạt được chương trình khách hàng thân thiết dự định.
Thiết lập chính xác Make HTTP: tạo một lời mời thẻ
Sao chép phần này vào bước tự động hóa của bạn
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
}Xây dựng và thử nghiệm kịch bản Make đầu tiên của bạn
Trong 7stamp Admin, tạo khóa trong API & Integrations → API Keys → Add API Key. Sử dụng hồ sơ thử nghiệm riêng/key khi thiết lập tài khoản của bạn cho phép.
Trong Make, tạo kịch bản và thêm trình kích hoạt nguồn. Chạy nó một lần trước khi ánh xạ để bạn có thể xem liên hệ mẫu thực hoặc đơn đặt hàng đã thanh toán.
Nhấp vào dấu cộng tiếp theo, tìm kiếm HTTP và chọn Make một yêu cầu. Đặt phương thức, URL đầy đủ và các tiêu đề từ thẻ thao tác trên trang này.
Sử dụng GET https://api.7loc.com/cards-api/templates làm yêu cầu đầu tiên. Phản hồi thành công của nó chứng tỏ khóa hoạt động mà không thay đổi bất kỳ dữ liệu khách hàng nào.
Đối với các tuyến đường POST, hãy chọn application/json và dán hình dạng cơ thể từ hướng dẫn này. Lập bản đồ ổn định External ID; chỉ thêm template_id nếu hồ sơ có nhiều mẫu đang hoạt động.
Chạy bằng một liên hệ dùng một lần, kiểm tra đầu ra HTTP và chỉ sau đó ánh xạ các trường phản hồi chính xác của nó vào mô-đun nhắn tin, email hoặc CRM tiếp theo.
Khi nào bạn nên sử dụng Make HTTP?
Sử dụng HTTP cho 7stamp ngay bây giờ: đây là lộ trình được ghi lại, sẵn sàng cho sản xuất chứ không phải là một tuyến dự phòng giảm bớt. Chọn nó bất cứ khi nào bạn cần thao tác 7stamp, tuyến API mới hoặc kết nối POS/ERP tùy chỉnh. Tham chiếu OpenAPI là nguồn sự thật cho phương thức, đường dẫn đầy đủ, nội dung và lược đồ phản hồi; khóa mang và đế URL giữ nguyên.
Nhận 7stamp sự kiện trong Make
Đối với kịch bản hướng sự kiện, hãy thêm Webhooks → Custom webhook và tạo webhook. Sao chép URL của nó, mở API & Integrations → Webhooks trong hồ sơ 7stamp, dán URL, chọn loại sự kiện, lưu và gửi sự kiện thử nghiệm thực. Hồ sơ 7stamp sở hữu đăng ký đó; API hiện tại không hiển thị các điểm cuối webhook tự động đăng ký/unsubscribe.
Không cần có trình kết nối Make công khai
Hướng dẫn trên trang này sử dụng mô-đun Make có sẵn cho mọi tài khoản Make. Nếu bạn muốn có mô-đun 7stamp gốc trong tương lai thay vì HTTP, hãy gửi cho chúng tôi quy trình làm việc bạn cần; cho đến lúc đó, HTTP và Custom webhooks bao gồm mọi hoạt động 7stamp được ghi lại.
Câu hỏi thường gặp
Tôi không thể tìm thấy 7stamp trong Make. Tôi vẫn có thể tự động hóa nó chứ?
Vâng. Hiện tại không có ứng dụng 7stamp công khai nào trong Make. Thêm HTTP > Make một yêu cầu, sử dụng điểm cuối 7stamp hoàn chỉnh URL và gửi Authorization: Bearer theo sau là khóa 7stamp API của bạn. HTTP có thể gọi mọi điểm cuối được ghi lại.
Tôi lấy mã thông báo cho kết nối Make ở đâu?
Trong 7stamp Admin, mở API Tích hợp, sau đó API Keys, rồi Add API Key. Khóa này nằm trong phạm vi nơi làm việc/profile đã tạo ra nó, vì vậy hãy sử dụng hồ sơ thử nghiệm cho các tình huống thử nghiệm bất cứ khi nào có thể.
Tôi nên ánh xạ số nhận dạng nào là External ID?
Sử dụng số nhận dạng ổn định từ hệ thống nguồn, tốt nhất là liên hệ CRM ID hoặc khách hàng UUID. Không sử dụng tên hiển thị. Số điện thoại hoặc email có thể hoạt động nhưng có thể thay đổi và cần được xử lý nhất quán.
Làm cách nào để đưa 7stamp sự kiện vào Make?
Tạo Webhooks > Custom webhook trong Make, sau đó dán URL được tạo vào cài đặt webhook của hồ sơ 7stamp. Sử dụng bộ lọc hoặc bộ định tuyến Make sau khi phân phối để xử lý event_type đến.
Bước tiếp theo
Bạn đã sẵn sàng tự động hóa hành động trung thành đầu tiên chưa?
Tạo khóa API, kiểm tra List Templates và xây dựng một kịch bản mời hoặc quét bằng một liên hệ dùng một lần. Chỉ thêm bộ định tuyến và nhắn tin sau khi luồng đơn giản đó đáng tin cậy.