Tạo lời mời từ một liên hệ CRM
Kích hoạt một liên hệ mới hoặc đủ điều kiện, ánh xạ CRM ID của liên hệ đó tới External ID, tạo lời mời thẻ và chuyển cài đặt được trả lại URL tới email hoặc bước SMS.
Hướng dẫn tự động hóa không có mã
Kết nối 7stamp với Zapier — từng bước
Hướng dẫn triển khaiSử dụng Zapier khi quy trình làm việc của bạn là một trình tự rõ ràng: một liên hệ hoặc đơn đặt hàng xuất hiện, 7stamp thực hiện một hành động, sau đó một công cụ kinh doanh khác được cập nhật. Tuyến đường an toàn hôm nay là API bởi Zapier cho các cuộc gọi đi 7stamp API và Webhooks by Zapier → Catch Hook cho các sự kiện đến 7stamp.
Không có ứng dụng 7stamp công khai nào trên thị trường của Zapier. Sử dụng API by Zapier → API Request nếu có: nó lưu trữ khóa API tĩnh trong kết nối ứng dụng thay vì hiển thị khóa đó trong bước Zap. Chỉ sử dụng Webhooks by Zapier cho các sự kiện Catch Hook sắp tới; không đặt khóa 7stamp Bearer vào trường hành động Webhooks hiển thị.
Bắt đầu với Zap tuyến tính, có thể kiểm tra
Giữ Zap đầu tiên ở mức nhỏ. Luồng liên hệ với thẻ hoặc đơn hàng trả phí đến tem đáng tin cậy là điểm khởi đầu tốt hơn so với đồng bộ hóa hai chiều rộng rãi CRM.
Thêm tem sau khi thanh toán
Kích hoạt từ đơn hàng đã thanh toán hoặc biên lai đã đóng, ánh xạ danh tính khách hàng và đơn hàng ID, sau đó sử dụng Scan Card với số tiền đặt hàng hoặc số lượng tem rõ ràng.
Phát hành chứng từ khôi phục một lần
Sử dụng quy tắc CRM, sự kiện hỗ trợ hoặc xuất phân đoạn để xác định khách hàng, cấp chứng từ cho thẻ của họ và gửi tin nhắn tiếp theo từ đúng kênh.
Ghi lại các sự kiện thẻ vào CRM
của bạn Sử dụng Webhooks by Zapier > Catch Hook để nhận 7stamp sự kiện thẻ. Khớp External ID được trả về với bản ghi CRM và thêm ghi chú, thẻ hoặc tác vụ có liên quan.
7stamp thao tác để gọi từ API bởi Zapier
Thêm API by Zapier → API Request sau khi kích hoạt. Tạo một kết nối khóa 7stamp API, sau đó chọn phương thức chính xác và URL đầy đủ bên dưới. Mỗi thao tác trả về các trường mà bạn có thể ánh xạ vào bước Zap tiếp theo.
API bởi Zapier hành động
POST /cards/invite Tạo Card Invite
Tạo cài đặt thẻ ví mới URL và mã chèn giao hàng cho một liên hệ bên ngoài.
- Bắt buộc
- external_id từ trình kích hoạt CRM/contact.
- Bước tiếp theo
- Ánh xạ install_url vào email, SMS hoặc trường CRM.
API bởi Zapier 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 từ một lô JSON được kiểm soát.
- Bắt buộc
- mảng vật phẩm có từ 1–100 đối tượng mời.
- Kiểm tra
- Đọc success_count, error_count và mọi kết quả trước khi giao hàng.
API bởi Zapier hành động
POST /cards/scan Scan Card
Thêm tem theo User Card ID hoặc External ID, với số lượng, số lượng tem, thứ tự ID và dữ liệu biên nhận tùy chọn.
- Danh tính
- external_id cộng với tùy chọn external_source; user_card_id thắng nếu cả hai đều có mặt.
- Quy tắc tem
- stamps_count được ưu tiên hơn số lượng.
API bởi Zapier hành động
POST /vouchers/issue Issue Voucher
Cấp voucher trực tiếp cho chủ thẻ.
- Bắt buộc phải có
- chứng từ.short_description và mục tiêu external_id hoặc đã biết user_card_id.
- Kết quả
- Bản đồ unique_code, trạng thái hoặc expires_at tới ghi chú hoặc tin nhắn CRM.
API bởi Zapier hành động
POST /messages/send Send Message
Gửi nội dung email đẩy thẻ ví và/or cho chủ sở hữu thẻ.
- Đẩy thẻ
- card_push_text được giới hạn ở 20 ký tự.
- chủ đề và nội dung; kết quả báo cáo liệu việc giao hàng có được xếp hàng hay không.
API bởi Zapier hành động
GET /cards Find Cards
Tìm bản ghi thẻ theo External ID, với các bộ lọc mẫu và nguồn tùy chọn.
- Bắt buộc
- external_id làm tham số truy vấn.
- Sử dụng trước
- Sử dụng trước khi tạo lời mời khi quy tắc của bạn tránh các lời mời trùng lặp.
API bởi Zapier hành động
GET /cards/{user_card_id} Nhận chi tiết thẻ
Đọc trạng thái của thẻ bằng 7stamp nội bộ ID của nó.
- Bắt buộc
- Thay thế {user_card_id} bằng ID được trả về bởi 7stamp.
- Đầu ra hữu ích
- stamps_count, trạng thái ví và active_vouchers_count.
API bởi Zapier hành động
GET /templates List Templates
Liệt kê các mẫu có sẵn cho hồ sơ được kết nối và xác minh kết nối API.
- Thử nghiệm đầu tiên
- Gọi nó trước bất kỳ hành động ghi nào: nó không thay đổi dữ liệu khách hàng.
- Sử dụng sau
- Id đang hoạt động sẽ trở thành template_id khi tồn tại nhiều mẫu.
API bởi Zapier hành động
GET /templates/{template_id}/design Get Template Design
Truy xuất cài đặt thiết kế của mẫu cho mẫu đã biết ID.
Zapier kích hoạt
Webhooks by Zapier → Catch Hook Nhận sự kiện thẻ
Catch Hook mang lại cho Zapier một HTTPS URL độc nhất. Dán nó vào cài đặt webhook của 7stamp Admin và kiểm tra nó bằng một sự kiện thẻ thực.
- Trong Zapier
- Sử dụng Catch Hook cho dữ liệu sự kiện được phân tích cú pháp; chỉ sử dụng Catch Raw Hook khi bạn cũng cần tiêu đề yêu cầu thô/body.
- Đối sánh
- Tìm liên hệ CRM bằng cách sử dụng external_id và tùy chọn external_source từ sự kiện.
Ba quy trình công việc Zapier bạn có thể xây dựng từng bước
Mỗi kịch bản sử dụng mô-đun Zapier thực, hiện có sẵn. Trước tiên, hãy xây dựng một tuyến đường nhỏ và kiểm tra nó bằng một điểm tiếp xúc dùng một lần trước khi bật Zap.
1. Đủ điều kiện CRM liên hệ → phát hành thẻ
Kết quả mong đợi: Bước Zap tiếp theo nhận được install_url và có thể gửi cho khách hàng hoặc ghi lại vào bản ghi CRM.
- 1 Tạo Zap và chọn sự kiện CRM có nghĩa là một người liên hệ đủ điều kiện để trở thành khách hàng thân thiết. Kiểm tra trình kích hoạt và xác nhận rằng bạn có liên hệ bất biến ID.
- 2 Thêm API by Zapier → API Request. Tạo hoặc chọn kết nối phím 7stamp API, chọn POST và đặt URL thành https://api.7loc.com/cards-api/cards/invite.
- 3 Đặt nội dung thành JSON. Ánh xạ CRM ID vào external_id, đặt external_source cố định chẳng hạn như kommo và chỉ thêm template_id khi có nhiều hơn một mẫu 7stamp đang hoạt động.
- 4 Kiểm tra hành động. Xác nhận phản hồi chứa install_url và delivery_insert_code cho cùng external_id.
- 5 Thêm hành động CRM Cập nhật, email hoặc SMS của bạn. Bản đồ install_url từ phản hồi API; không viết mã cứng hoặc sao chép bài kiểm tra URL.
Kiểm tra: Tạo Card Invite luôn trả lại lời mời mới. Trước tiên, hãy thêm yêu cầu Find Cards hoặc Zapier Lọc nếu chính sách của bạn là một lời mời cho mỗi người liên hệ.
2. Đơn hàng đã thanh toán → tem giải thưởng
Kết quả mong đợi: Đơn hàng tạo ra một bản quét 7stamp có thể theo dõi và Zap có thể ghi lại stamps_added hoặc scan_id trong hệ thống nguồn.
- 1 Sử dụng Đơn đặt hàng phải trả tiền/Closed Kích hoạt biên nhận và kiểm tra nó. Xác nhận khách hàng ID và đơn hàng duy nhất ID đều có mặt trước khi tiếp tục.
- 2 Thêm API by Zapier → API Request với POST https://api.7loc.com/cards-api/cards/scan và chọn kết nối 7stamp tương tự.
- 3 Gửi JSON với external_id, external_source, external_order_id và số tiền cho các mẫu dựa trên số lượng hoặc stamps_count để nhận giải thưởng tem rõ ràng.
- 4 Kiểm tra với một đơn đặt hàng dùng một lần. Kiểm tra thành công, scan_id và stamps_added trong phản hồi.
- 5 Thêm Bộ lọc chỉ tiếp tục sau khi phản hồi thành công, sau đó cập nhật đơn hàng/CRM với kết quả đã được xác nhận.
Kiểm tra: Nếu Zap được phát lại, hãy kiểm tra thứ tự ban đầu trước khi gửi một lần quét khác. Giữ external_order_id ổn định để sự kiện có thể được điều chỉnh sau này.
3. sự kiện 7stamp → tạo ghi chú hoặc nhiệm vụ CRM
Kết quả mong đợi: Zapier nhận sự kiện 7stamp được phân tích cú pháp, tìm khách hàng theo external_id và tạo hoạt động theo dõi thích hợp.
- 1 Tạo Zap mới với Webhooks by Zapier làm trình kích hoạt. Chọn Catch Hook, tiếp tục và sao chép URL duy nhất được hiển thị trong bước Kiểm tra.
- 2 Trong 7stamp Admin, mở API & Integrations → Webhooks, thêm Catch Hook URL, chỉ chọn các loại sự kiện cần thiết và lưu.
- 3 Gây ra sự kiện quét thẻ hoặc quét thử nghiệm thực tế. Quay lại Zapier, nhấp vào Test trigger và xác nhận event_type, external_id và external_source đến dưới dạng trường mẫu.
- 4 Thêm CRM Tìm tác vụ Liên hệ bằng cách sử dụng external_id. Thêm quy tắc Bộ lọc hoặc Đường dẫn cho event_type, ví dụ: tách SCAN khỏi REWARD_EARNED.
- 5 Tạo ghi chú CRM/task và chỉ ánh xạ các trường tồn tại cho sự kiện đó, chẳng hạn như scanned_at, stamps_after, external_order_id hoặc issued_vouchers.
Kiểm tra: A Catch Hook URL là một bí mật. Nếu Zap được chuyển cho chủ sở hữu khác, hãy cập nhật URL trong 7stamp Admin trước khi dựa vào nó.
Tạo khóa 7stamp API trước khi tạo Zap
Đây là các bước bên 7stamp. Thực hiện việc này một lần, sau đó chỉ sử dụng khóa bên trong kết nối API by Zapier—không phải trong trường hành động Webhooks by Zapier hoặc ghi chú.
Các quy tắc kết nối ngăn dữ liệu không khớp
Giữ khóa API trong kết nối API by Zapier
Trong 7stamp Admin, chọn API & Integrations → API Keys → Add API Key. Trong API của Zapier, hãy tạo kết nối khóa API với tiêu đề tĩnh Authorization chứa Bearer theo sau là khóa đó. API bởi Zapier giữ thông tin xác thực trong kết nối thay vì bước Zap hiển thị; hạn chế quyền truy cập vào kết nối và xoay phím nếu nó bị lộ.
Bản đồ External ID và External Source nhất quán
External ID là mã định danh khách hàng ổn định của riêng bạn; External Source nhãn nguồn gốc của nó, ví dụ như hubspot, bitrix24, shopify hoặc poster. Sử dụng cùng một cặp để tạo, tìm, quét, chứng từ và webhook.
Biết mã nhận dạng thẻ nào thắng
Các hành động nhắm mục tiêu thẻ chấp nhận User Card ID hoặc External ID. Khi cả hai đều có mặt, User Card ID được ưu tiên. Chỉ sử dụng ID nội bộ sau khi nó được trả về bởi bước 7stamp đáng tin cậy; nếu không thì thích hệ thống nguồn External ID.
Chính xác API bởi Zapier yêu cầu: trao một con tem
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/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"
}Tạo Zap đầu tiên của bạn
Tạo khóa 7stamp API trong Quản trị viên: API & Integrations → API Keys → Add API Key. Sử dụng khóa kiểm tra riêng/profile khi có sẵn.
Trong Zapier, tạo Zap và kiểm tra trình kích hoạt nguồn. Sử dụng mẫu thực để liên hệ ID, khách hàng ID, đặt hàng ID và số lượng có sẵn để lập bản đồ.
Thêm API by Zapier → API Request. Tạo kết nối 7stamp cho tiêu đề tĩnh Bearer Authorization thay vì đặt bí mật vào trường hành động Webhooks by Zapier.
Trước tiên hãy gọi GET https://api.7loc.com/cards-api/templates. Điều này xác nhận khóa hoạt động và hiển thị ID mẫu hoạt động nào có sẵn mà không sửa đổi dữ liệu khách hàng.
Chọn POST /cards/invite hoặc POST /cards/scan, đặt JSON làm loại nội dung và ánh xạ trường ổn định External ID cộng với các trường mẫu có liên quan/order từ kích hoạt.
Chạy hành động với một liên hệ dùng một lần, kiểm tra các trường phản hồi chính xác của liên hệ đó, sau đó ánh xạ các trường đó vào bước CRM, email hoặc nhắn tin tiếp theo trước khi xuất bản Zap.
Chỉ sử dụng yêu cầu chung cho các tuyến được ghi lại
Sử dụng API by Zapier cho yêu cầu 7stamp với khóa Bearer API: nó giữ các khóa tiêu đề tĩnh trong kết nối ứng dụng. Sử dụng Webhooks by Zapier để tổ chức sự kiện Catch Hook chứ không phải làm địa điểm ưu tiên cho bí mật 7stamp. Giữ cơ sở URL tại https://api.7loc.com/cards-api, sử dụng tham chiếu công khai OpenAPI cho các lược đồ chính xác và không bao giờ gửi thông tin xác thực hoặc dữ liệu khách hàng đến URL chưa được xác minh.
Nhận 7stamp sự kiện thông qua Catch Hook
Tạo Webhooks by Zapier → Catch Hook, sao chép URL duy nhất hiển thị trong thiết lập thử nghiệm, dán nó vào cài đặt webhook của hồ sơ 7stamp, chọn loại sự kiện, và sau đó gửi bản quét thử nghiệm thực tế hoặc sự kiện thẻ. Sử dụng tải trọng sự kiện External ID và External Source để xác định đúng liên hệ CRM. Chỉ chọn Catch Raw Hook khi bạn đặc biệt cần phần nội dung chưa được phân tích cú pháp và các tiêu đề yêu cầu.
Sử dụng tuyến đường Zapier an toàn ngay bây giờ
API bởi Zapier và Catch Hook là đủ cho mọi hoạt động 7stamp API công khai và sự kiện thẻ. Nếu bạn cần một ứng dụng gốc 7stamp Zapier trong tương lai, hãy gửi cho chúng tôi hành động chính xác/trigger mà nhóm của bạn sử dụng nhiều nhất.
Câu hỏi thường gặp
Tôi có thể tìm ứng dụng 7stamp trong Zapier ở đâu?
Hiện nay không có ứng dụng thị trường 7stamp công khai nào. Sử dụng API by Zapier → API Request cho các cuộc gọi 7stamp API và Webhooks by Zapier → Catch Hook cho các sự kiện đến 7stamp.
Tôi tạo mã thông báo Zapier ở đâu?
Tạo khóa 7stamp API trong Quản trị viên dưới API & Integrations → API Keys → Add API Key. Lưu trữ nó dưới dạng tiêu đề tĩnh Bearer Authorization trong kết nối API by Zapier, không phải trong trường hành động Webhooks by Zapier hiển thị.
Làm thế nào Zapier có thể nhận được sự kiện tem hoặc voucher?
Tạo Catch Hook trong Webhooks by Zapier, dán URL đã tạo vào cài đặt webhook của hồ sơ 7stamp, chọn sự kiện và gửi sự kiện thử nghiệm trước khi bật cập nhật CRM.
Tôi nên chọn Zapier hay Make?
Chọn Zapier cho quy trình làm việc hành động kích hoạt chủ yếu là tuyến tính. Chọn Make khi bạn cần bộ định tuyến, các phép biến đổi phức tạp hoặc kịch bản dài nhiều nhánh. Cả hai đều sử dụng cùng khóa và điểm cuối 7stamp API.
Bước tiếp theo
Tạo Zap đầu tiên với một liên hệ thử nghiệm
Tạo khóa API, thử nghiệm GET /templates đến API bởi Zapier, sau đó xây dựng một hành động liên hệ với thẻ hoặc đặt hàng theo tem. Thêm Catch Hook sau khi luồng đi ra có kết quả kiểm tra đã được chứng minh.