Buat undangan dari CRM kontak
Picu kontak baru atau yang memenuhi syarat, petakan CRM ID ke External ID, buat undangan kartu, dan teruskan instalasi yang dikembalikan URL ke email atau langkah SMS.
Panduan otomatisasi tanpa kode
Hubungkan 7stamp ke Zapier — langkah demi langkah
Panduan implementasiGunakan Zapier ketika alur kerja Anda memiliki urutan yang jelas: kontak atau pesanan muncul, 7stamp melakukan suatu tindakan, lalu alat bisnis lainnya diperbarui. Rute aman hari ini adalah API oleh Zapier untuk panggilan keluar 7stamp API dan Webhooks by Zapier → Catch Hook untuk acara masuk 7stamp.
Tidak ada aplikasi 7stamp publik di pasar Zapier. Gunakan API by Zapier → API Request jika tersedia: ini menyimpan kunci statis API di koneksi aplikasi alih-alih mengeksposnya dalam langkah Zap. Gunakan Webhooks by Zapier hanya untuk acara Catch Hook yang masuk; jangan masukkan kunci 7stamp Bearer ke dalam bidang tindakan Webhook yang terlihat.
Mulailah dengan Zap yang linier dan dapat diuji
Jaga agar Zap pertama tetap kecil. Aliran kontak-ke-kartu atau pesanan-bayar-ke-prangko yang andal merupakan titik awal yang lebih baik dibandingkan sinkronisasi dua arah CRM yang luas.
Tambahkan prangko setelah checkout
Pemicu dari pesanan berbayar atau tanda terima tertutup, petakan identitas pelanggan dan pesanan ID, lalu gunakan Scan Card dengan jumlah pesanan atau nomor prangko yang jelas.
Terbitkan voucher pemulihan satu kali
Gunakan aturan CRM, acara dukungan, atau ekspor segmen untuk mengidentifikasi pelanggan, menerbitkan voucher ke kartu mereka, dan mengirim pesan tindak lanjut dari saluran yang benar.
Tulis kembali acara kartu ke CRM
Gunakan Webhooks by Zapier > Catch Hook untuk menerima 7stamp acara kartu. Cocokkan External ID yang dikembalikan dengan catatan CRM dan tambahkan catatan, tag, atau tugas yang relevan.
7stamp operasi untuk menelepon dari API oleh Zapier
Tambahkan API by Zapier → API Request setelah pemicu Anda. Buat satu koneksi kunci 7stamp API, lalu pilih metode yang tepat dan lengkap URL di bawah. Setiap operasi mengembalikan bidang yang dapat Anda petakan ke langkah Zap berikutnya.
API dengan Zapier tindakan
POST /cards/invite Buat Card Invite
Membuat pemasangan kartu dompet baru URL dan kode pengiriman-masukkan untuk satu kontak eksternal.
- Diperlukan
- external_id dari pemicu CRM/contact.
- Langkah selanjutnya
- Petakan install_url ke dalam email, SMS, atau kolom CRM.
API oleh Zapier tindakan
POST /cards/invite/bulk Buat Massal Card Invites
Membuat hingga 100 tautan undangan dari kumpulan JSON yang dikontrol.
- Diperlukan
- susunan item dengan 1–100 objek undangan.
- Periksa
- Baca success_count, error_count, dan setiap hasil sebelum pengiriman.
API oleh Zapier aksi
POST /cards/scan Scan Card
Menambahkan prangko sebanyak User Card ID atau External ID, dengan jumlah, jumlah prangko, pesanan ID, dan data tanda terima opsional.
- Identitas
- external_id ditambah opsional external_source; user_card_id menang jika keduanya hadir.
- Aturan stempel
- stamps_count lebih diutamakan daripada jumlah.
API oleh Zapier tindakan
POST /vouchers/issue Issue Voucher
Menerbitkan voucher langsung ke pemilik kartu.
- Diperlukan
- voucher.short_description dan target external_id atau dikenal user_card_id.
- Hasil
- Peta unique_code, status, atau expires_at ke CRM catatan atau pesan.
API oleh Zapier tindakan
POST /messages/send Send Message
Mengirim dorongan kartu dompet dan/or konten email ke pemilik kartu.
- Dorongan kartu
- card_push_text dibatasi hingga 20 karakter.
- subjek plus isi; hasilnya melaporkan apakah pengiriman dalam antrian.
API oleh Zapier action
GET /cards Find Cards
Menemukan catatan kartu berdasarkan External ID, dengan sumber opsional dan filter templat.
- Diperlukan
- external_id sebagai parameter kueri.
- Gunakan terlebih dahulu
- Gunakan sebelum membuat undangan ketika aturan Anda menghindari undangan duplikat.
API oleh Zapier tindakan
GET /cards/{user_card_id} Dapatkan Detail Kartu
Membaca status kartu dengan 7stamp internal ID.
- Wajib
- Ganti {user_card_id} dengan ID yang dikembalikan oleh 7stamp.
- Output berguna
- stamps_count, status dompet, dan active_vouchers_count.
API oleh Zapier tindakan
GET /templates List Templates
Mencantumkan templat yang tersedia untuk profil yang terhubung dan memverifikasi koneksi API.
- Tes pertama
- Panggil sebelum tindakan tulis apa pun: ini tidak mengubah data pelanggan.
- Gunakan nanti
- ID aktif menjadi template_id bila ada banyak templat.
API oleh Zapier action
GET /templates/{template_id}/design Get Template Design
Mengambil pengaturan desain templat untuk templat yang dikenal ID.
Zapier trigger
Webhooks by Zapier → Catch Hook Menerima acara kartu
Catch Hook memberi Zapier HTTPS URL yang unik. Tempelkan di pengaturan webhook 7stamp Admin dan uji dengan kejadian kartu nyata.
- Dalam Zapier
- Gunakan Catch Hook untuk data peristiwa yang diurai; gunakan Catch Raw Hook hanya jika Anda juga membutuhkan header permintaan mentah/body.
- Cocokkan
- Temukan kontak CRM menggunakan external_id dan opsional external_source dari acara.
Tiga Zapier alur kerja yang dapat Anda buat langkah demi langkah
Setiap skenario menggunakan modul Zapier nyata yang tersedia saat ini. Buat satu rute kecil terlebih dahulu dan uji dengan kontak sekali pakai sebelum menyalakan Zap.
1. Kontak CRM yang memenuhi syarat → mengeluarkan kartu
Hasil yang diharapkan: Langkah Zap selanjutnya menerima install_url dan dapat mengirimkannya ke pelanggan atau menulisnya kembali ke catatan CRM.
- 1 Buat Zap dan pilih acara CRM yang berarti kontak memenuhi syarat untuk loyalitas. Uji pemicunya dan konfirmasikan bahwa Anda memiliki ID kontak yang tidak dapat diubah.
- 2 Tambahkan API by Zapier → API Request. Buat atau pilih koneksi tombol 7stamp API, pilih POST, dan atur URL ke https://api.7loc.com/cards-api/cards/invite.
- 3 Atur isi ke JSON. Petakan CRM ID ke external_id, tetapkan external_source seperti kommo, dan tambahkan template_id hanya jika lebih dari satu templat 7stamp aktif.
- 4 Uji aksinya. Konfirmasikan respons berisi install_url dan delivery_insert_code untuk external_id yang sama.
- 5 Tambahkan CRM Pembaruan, email, atau tindakan SMS Anda. Peta install_url dari tanggapan API; jangan melakukan hard-code atau menyalin tes URL.
Periksa: Buat Card Invite selalu mengembalikan undangan baru. Tambahkan permintaan Find Cards atau Filter Zapier terlebih dahulu jika kebijakan Anda adalah satu undangan per kontak.
2. Pesanan berbayar → stempel penghargaan
Hasil yang diharapkan: Pesanan membuat pemindaian 7stamp yang dapat dilacak dan Zap dapat merekam stamps_added atau scan_id di sistem sumber.
- 1 Gunakan Pesanan Berbayar/Closed Pemicu tanda terima dan ujilah. Konfirmasikan pelanggan ID dan pesanan unik ID keduanya ada sebelum melanjutkan.
- 2 Tambahkan API by Zapier → API Request dengan POST https://api.7loc.com/cards-api/cards/scan dan pilih koneksi 7stamp yang sama.
- 3 Kirim JSON dengan external_id, external_source, external_order_id, dan jumlah untuk templat berdasarkan jumlah atau stamps_count untuk penghargaan prangko eksplisit.
- 4 Tes dengan pesanan sekali pakai. Periksa keberhasilan, scan_id, dan stamps_added dalam respons.
- 5 Tambahkan Filter yang berlanjut hanya setelah respons berhasil, lalu perbarui pesanan/CRM dengan hasil yang dikonfirmasi.
Periksa: Jika Zap diputar ulang, periksa pesanan asli sebelum mengirim pindaian lagi. Jaga agar external_order_id tetap stabil agar peristiwa tersebut dapat direkonsiliasi nanti.
3. 7stamp acara → buat CRM catatan atau tugas
Hasil yang diharapkan: Zapier menerima acara 7stamp yang diuraikan, menemukan pelanggan pada external_id, dan membuat tindak lanjut yang sesuai.
- 1 Buat Zap baru dengan Webhooks by Zapier sebagai pemicunya. Pilih Catch Hook, lanjutkan, dan salin URL unik yang ditunjukkan pada langkah Pengujian.
- 2 Di 7stamp Admin, buka API & Integrations → Webhooks, tambahkan Catch Hook URL, pilih hanya jenis acara yang diperlukan, dan simpan.
- 3 Menyebabkan pemindaian tes atau kejadian kartu yang sebenarnya. Kembali ke Zapier, klik Test trigger dan konfirmasi event_type, external_id, dan external_source tiba sebagai kolom sampel.
- 4 Tambahkan CRM Tindakan Temukan Kontak menggunakan external_id. Tambahkan aturan Filter atau Jalur untuk event_type, misalnya pisahkan SCAN dari REWARD_EARNED.
- 5 Buat CRM catatan/task dan petakan hanya kolom yang ada untuk peristiwa tersebut, seperti scanned_at, stamps_after, external_order_id, atau issued_vouchers.
Periksa: A Catch Hook URL adalah rahasia. Jika Zap ditransfer ke pemilik lain, perbarui URL di 7stamp Admin sebelum mengandalkannya.
Buat kunci 7stamp API sebelum membuat Zap
Ini adalah langkah samping 7stamp. Lakukan ini sekali, lalu gunakan kunci hanya di dalam koneksi API kali Zapier—bukan di kolom tindakan atau catatan Webhooks by Zapier.
Aturan koneksi yang mencegah ketidakcocokan data
Simpan kunci API di koneksi API kali Zapier
Di 7stamp Admin, pilih API & Integrations → API Keys → Add API Key. Di API oleh Zapier, buat koneksi kunci API dengan header Authorization statis yang berisi Bearer diikuti dengan kunci tersebut. API oleh Zapier menyimpan kredensial dalam koneksi alih-alih langkah Zap yang terlihat; batasi akses ke koneksi dan putar kunci jika terbuka.
Peta External ID dan External Source secara konsisten
External ID adalah pengidentifikasi pelanggan stabil Anda sendiri; External Source label dari mana asalnya, misalnya hubspot, bitrix24, shopify, atau poster. Gunakan pasangan yang sama untuk alur buat, temukan, pindai, voucher, dan webhook.
Ketahui pengidentifikasi kartu mana yang menang
Tindakan penargetan kartu menerima User Card ID atau External ID. Jika keduanya hadir, User Card ID menjadi prioritas. Gunakan ID internal hanya setelah dikembalikan melalui langkah 7stamp yang tepercaya; jika tidak, lebih suka sistem sumber External ID.
Tepat API oleh Zapier permintaan: berikan satu stempel
Salin ini ke langkah otomatisasi Anda
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"
}Bangun Zap pertama Anda
Buat kunci 7stamp API di Admin: API & Integrations → API Keys → Add API Key. Gunakan kunci tes terpisah/profile bila tersedia.
Di Zapier, buat Zap dan uji pemicu sumber. Gunakan sampel nyata sehingga kontak ID, pelanggan ID, pesanan ID, dan jumlah tersedia untuk pemetaan.
Tambahkan API by Zapier → API Request. Buat koneksi 7stamp untuk header statis Bearer Authorization daripada meletakkan rahasia di kolom tindakan Webhooks by Zapier.
Hubungi GET https://api.7loc.com/cards-api/templates dulu. Ini mengonfirmasi bahwa kunci berfungsi dan menunjukkan ID templat aktif mana yang tersedia tanpa mengubah data pelanggan.
Pilih POST /cards/invite atau POST /cards/scan, tetapkan JSON sebagai tipe tubuh, dan petakan bidang stabil External ID ditambah templat/order yang relevan dari pemicu.
Jalankan tindakan dengan kontak sekali pakai, periksa kolom respons persisnya, lalu petakan kolom tersebut ke langkah CRM, email, atau perpesanan berikutnya sebelum memublikasikan Zap.
Gunakan permintaan universal hanya untuk rute yang terdokumentasi
Gunakan API oleh Zapier untuk permintaan 7stamp dengan kunci Bearer API: ini menyimpan kunci header statis dalam koneksi aplikasi. Gunakan Webhooks by Zapier untuk Catch Hook pengiriman acara, bukan sebagai lokasi pilihan untuk rahasia 7stamp. Pertahankan basis URL di https://api.7loc.com/cards-api, gunakan referensi publik OpenAPI untuk skema yang tepat, dan jangan pernah mengirimkan kredensial atau data pelanggan ke URL yang belum terverifikasi.
Terima 7stamp acara melalui Catch Hook
Buat Webhooks by Zapier → Catch Hook, salin URL unik yang ditampilkan dalam pengaturan pengujian, tempelkan ke pengaturan webhook profil 7stamp, pilih jenis acara, lalu kirim pemindaian atau kartu pengujian nyata acara. Gunakan External ID dan External Source muatan acara untuk menemukan kontak CRM yang tepat. Pilih Catch Raw Hook hanya ketika Anda secara khusus membutuhkan isi yang belum diurai dan header permintaan.
Gunakan rute aman Zapier sekarang
API oleh Zapier dan Catch Hook sudah cukup untuk setiap operasi 7stamp API publik dan acara kartu. Jika Anda membutuhkan aplikasi 7stamp Zapier asli di masa mendatang, kirimkan kepada kami tindakan tepat/trigger yang paling sering digunakan tim Anda.
Pertanyaan yang sering diajukan
Di mana saya dapat menemukan aplikasi 7stamp di Zapier?
Tidak ada aplikasi pasar 7stamp publik saat ini. Gunakan API by Zapier → API Request untuk 7stamp API panggilan dan Webhooks by Zapier → Catch Hook untuk acara 7stamp masuk.
Di mana saya membuat token Zapier?
Buat kunci 7stamp API di Admin di bawah API & Integrations → API Keys → Add API Key. Simpan sebagai header statis Bearer Authorization di koneksi API by Zapier, bukan di kolom tindakan Webhooks by Zapier yang terlihat.
Bagaimana cara Zapier menerima stempel atau voucher acara?
Buat Catch Hook di Webhooks by Zapier, tempelkan URL yang dihasilkan ke pengaturan webhook profil 7stamp, pilih acara, dan kirim acara uji sebelum mengaktifkan pembaruan CRM.
Haruskah saya memilih Zapier atau Make?
Pilih Zapier untuk alur kerja aksi pemicu yang sebagian besar linier. Pilih Make bila Anda memerlukan router, transformasi kompleks, atau skenario multi-cabang yang panjang. Keduanya menggunakan kunci 7stamp API dan titik akhir yang sama.
Langkah selanjutnya
Bangun Zap pertama dengan kontak uji
Buat kunci API, uji GET /templates hingga API oleh Zapier, lalu buat satu tindakan kontak-ke-kartu atau pesanan-ke-stempel. Tambahkan Catch Hook setelah aliran keluar memiliki hasil pengujian yang terbukti.