Panduan otomatisasi tanpa kode

Hubungkan 7stamp ke Make — langkah demi langkah

Panduan implementasi

Gunakan Make untuk menghubungkan 7stamp dengan CRM, POS, toko online, spreadsheet, alat perpesanan, atau sistem apa pun yang dapat mengirim data ke dalam skenario. Rute siap produksi hari ini adalah aplikasi Make HTTP untuk panggilan 7stamp API dan Custom webhook dari Make untuk acara 7stamp yang masuk.

Belum ada aplikasi 7stamp publik di pemilih aplikasi Make. Jangan menunggu satu pun: tambahkan HTTP → Make a request, gunakan metode URL, header Bearer, dan JSON yang tepat di bawah, lalu petakan bidang dari modul sumber Anda. Ini adalah 7stamp Integration API yang sama yang akan digunakan oleh konektor masa depan.

Buka Make Buka API referensi

Pilih skenario pertama yang cocok dengan alur kerja Anda

Mulailah dengan satu peristiwa dan satu hasil. Setelah data pengujian benar, tambahkan filter, router, pembaruan CRM, dan pesan tindak lanjut di sekitarnya.

Buat kartu setelah CRM kontak baru

Gunakan CRM kontak ID sebagai External ID, buat undangan kartu 7stamp, lalu kirimkan instalasi yang dikembalikan URL melalui email Anda yang biasa, SMS, atau langkah pengiriman pesan.

Tambahkan prangko setelah pesanan berbayar

Picu skenario dari pesanan berbayar POS atau e-niaga. Petakan pelanggan stabilnya ID dan pesan ID ke dalam Pindai Kartu, lalu gunakan jumlah atau jumlah prangko yang jelas.

Kirim tindak lanjut hadiah

Saat acara kartu melaporkan hadiah atau voucher, buat skenario berbeda: perbarui CRM, beri tahu tim, dan kirim push atau email kartu dompet hanya jika diperlukan.

Tangani sistem tanpa aplikasi asli Make

Gunakan modul Make HTTP untuk memanggil 7stamp secara langsung. Ini adalah pilihan universal untuk POS, ERP, mesin pemesanan khusus, atau layanan apa pun yang mengutamakan API.

7stamp operasi panggilan dari Make HTTP

Untuk setiap kartu di bawah, tambahkan HTTP → Make a request, lalu atur metode dan URL persis seperti yang ditunjukkan. Gunakan kunci Bearer yang sama untuk setiap permintaan. Pemetaan yang diperlukan memberi tahu Anda apa yang harus disuplai dari CRM, POS, atau pemicu e-commerce Anda.

Make trigger Webhooks → Custom webhook

Menerima acara kartu

Buat Custom webhook di Make, salin URL-nya, lalu tempelkan URL tersebut ke pengaturan webhook profil 7stamp. Ini memulai skenario ketika 7stamp mengirimkan peristiwa seperti SCAN, REWARD_EARNED, atau VOUCHER_ISSUED.

Dalam Make
Webhooks → Custom webhook → Tambahkan; beri nama yang jelas dan salin URL yang dihasilkannya.
Dalam 7stamp
Admin → API & Integrations → Webhooks; tempel URL, pilih jenis acara, simpan, lalu buat acara pengujian.
HTTP POST /cards/invite

Buat tindakan Card Invite

Membuat instalasi pribadi baru URL dan kode sisipan pengiriman untuk satu kontak eksternal.

Wajib
external_id — petakan kandang Anda CRM/contact ID, bukan nama.
Kemudian gunakan
Peta install_url dari respons ke email Anda, SMS, atau CRM langkah pembaruan.
HTTP tindakan POST /cards/invite/bulk

Pembuatan Massal Card Invites

Membuat hingga 100 tautan undangan dalam satu permintaan. Gunakan untuk migrasi atau kampanye terkontrol, bukan ekspor kontak tanpa batas.

Item
yang diperlukan — susunan JSON yang terdiri dari 1–100 objek permintaan undangan individu.
Periksa
Baca success_count, error_count, dan setiap hasil sebelum mengirim tautan apa pun.
HTTP action GET /cards

Find Cards

Menemukan catatan kartu berdasarkan External ID, dengan template opsional dan filter sumber.

Diperlukan
Parameter kueri external_id.
Opsional
external_source dan template_id mempersempit pencarian ketika satu sistem memiliki beberapa program.
HTTP tindakan GET /cards/{user_card_id}

Dapatkan Detail Kartu

Membaca status lengkap satu kartu ketika langkah sebelumnya telah mengembalikan User Card ID internalnya.

Wajib
Ganti {user_card_id} dengan ID internal yang dikembalikan oleh respons 7stamp yang tepercaya.
Hindari
Jangan menebak atau menyimpan kartu ID dari profil lain.
HTTP tindakan POST /cards/scan

Pindai Kartu

Menambahkan prangko dari jumlah pembelian atau hitungan eksplisit. Ia menerima User Card ID atau External ID dan dapat mempertahankan referensi pesanan eksternal.

Identitas
Gunakan external_id dan opsional external_source; user_card_id menang jika keduanya disediakan.
Pembelian
Gunakan jumlah untuk kartu berdasarkan jumlah atau stamps_count untuk nomor eksplisit; stamps_count mendapat prioritas.
Ketertelusuran
Petakan external_order_id dari pesanan berbayar/receipt sehingga acara 7stamp dapat dicocokkan kembali.
HTTP action GET /templates

List Templates

Mencantumkan templat kartu yang tersedia untuk kunci API. Gunakan untuk menguji koneksi atau untuk memilih template secara dinamis.

Tes pertama
Ini adalah permintaan pertama yang paling aman: tidak memiliki isi dan tidak mengubah data pelanggan.
Petakan nanti
Gunakan id template aktif sebagai template_id hanya jika profil memiliki lebih dari satu template aktif.
HTTP action GET /templates/{template_id}/design

Get Template Design

Mengembalikan pengaturan desain visual untuk templat yang dikenal, berguna ketika sistem lain perlu menampilkan pilihan kartu yang konsisten.

HTTP tindakan POST /vouchers/issue

Menerbitkan Voucher

Menerbitkan voucher kepada pemilik kartu yang diidentifikasi oleh External ID atau User Card ID.

Diperlukan
voucher.short_description. Targetkan kartu dengan external_id atau yang dikenal user_card_id.
Validitas
Gunakan validity_type dengan validity_value, atau baca referensi OpenAPI untuk mengetahui tanggal kedaluwarsa yang tetap.
HTTP tindakan POST /messages/send

Kirim Pesan

Mengirim konten ke pemilik kartu melalui push dompet-kartu dan email /or, tunduk pada saluran yang dikonfigurasi dan aturan persetujuan.

Dorongan kartu
card_push_text dibatasi hingga 20 karakter dan memerlukan pass dompet terpasang.
Email
Kirim subjek plus isi; dasar HTML didukung di dalam tubuh.
Make modul Full 7stamp endpoint URL

HTTP → Make a request

Ini adalah modul Make yang memanggil setiap rute 7stamp di atas. Gunakan URL lengkap, pilih metode yang terdokumentasi, tambahkan header Bearer, dan gunakan JSON hanya ketika rute memerlukan isi.

Basis URL
https://api.7loc.com/cards-api
Tajuk
Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json untuk permintaan POST.

Tiga skenario Make yang dapat Anda buat persis seperti yang tertulis

Nama di bawah adalah modul Make yang sebenarnya. Mulailah dengan skenario pertama, jalankan pada kontak sekali pakai, dan baru kemudian tambahkan router, filter, atau penjadwalan produksi.

1. Kontak baru CRM → kirim tautan kartu 7stamp

Hasil yang diharapkan: Pelanggan menerima install_url yang dikembalikan oleh 7stamp; CRM Anda dapat menyimpannya URL dalam catatan kontak yang sama.

  1. 1 Buat skenario dan tambahkan pemicu Kontak BaruCRM/Created Anda. Untuk Kommo, pilih pemicu pembuatan kontak dan jalankan sekali untuk memuat kontak sampel.
  2. 2 Tambahkan HTTP → Make a request. Tetapkan Metode ke POST dan URL ke https://api.7loc.com/cards-api/cards/invite.
  3. 3 Tambahkan Authorization: Bearer YOUR_7STAMP_API_KEY dan Content-Type: application/json. Di badan JSON, petakan kontak CRM ID ke external_id dan atur external_source ke label tetap seperti kommo.
  4. 4 Jalankan modul HTTP satu kali. Konfirmasikan keluarannya memiliki install_url, delivery_insert_code, external_id, dan template_id.
  5. 5 Tambahkan modul pembaruan email/SMS/CRM Anda setelah HTTP dan petakan install_url dari keluaran HTTP. Simpan URL pada kontak CRM jika nanti tim harus mengirimnya ulang.

Periksa: POST /cards/invite selalu membuat undangan baru. Gunakan Find Cards terlebih dahulu jika aturan bisnis Anda adalah menghindari undangan lain untuk kontak yang sudah ada.

2. Pesanan berbayar → tambahkan stempel loyalitas

Hasil yang diharapkan: Respons pemindaian yang berhasil mencakup keberhasilan, scan_id, stamps_added, dan status kartu pasca-pemindaian untuk langkah Anda selanjutnya.

  1. 1 Mulai dari pemicu Pesanan Berbayar POS/ecommerce. Make yakin sampelnya berisi pelanggan stabil ID dan pesanan/receipt ID.
  2. 2 Tambahkan HTTP → Make a request dengan POST https://api.7loc.com/cards-api/cards/scan dan header Bearer yang sama.
  3. 3 Peta external_id dari pelanggan, external_source dari nama sistem, dan external_order_id dari pesanan ID. Tambahkan jumlah untuk kartu berdasarkan jumlah, atau stamps_count untuk jumlah prangko yang jelas.
  4. 4 Run once dengan perintah tes. Periksa tanda keberhasilan yang dikembalikan dan stamps_added sebelum mengaktifkan jadwal skenario.
  5. 5 Secara opsional tambahkan filter setelah langkah HTTP: lanjutkan hanya jika sukses benar, lalu tulis scan_id atau stamps_added kembali ke catatan pesanan/CRM.

Periksa: Gunakan external_order_id yang sama pada percobaan ulang sehingga urutannya dapat dilacak di acara webhook selanjutnya; jangan memberikan prangko dua kali setelah kegagalan yang tidak jelas.

3. 7stamp acara → perbarui CRM

Hasil yang diharapkan: Make segera menerima acara 7stamp dan dapat menemukan catatan CRM yang cocok melalui external_id dan external_source.

  1. 1 Buat skenario Make terpisah. Tambahkan Webhooks → Custom webhook, pilih Tambah, beri nama 7stamp-card-events, dan salin URL yang dihasilkan.
  2. 2 Di 7stamp Admin, buka API & Integrations → Webhooks. Tambahkan URL tersebut dan pilih sekumpulan kecil peristiwa, misalnya SCAN dan REWARD_EARNED.
  3. 3 Buat pemindaian tes sekali pakai atau acara kartu di 7stamp. Kembali ke Make dan gunakan Run once agar Make menentukan struktur data peristiwa.
  4. 4 Tambahkan langkah pencarian CRM menggunakan external_id. Tambahkan filter atau router di event_type sehingga SCAN, REWARD_EARNED, dan VOUCHER_ISSUED dapat mengambil tindakan berbeda.
  5. 5 Tambahkan tindakan CRM update/note. Petakan scanned_at, stamps_after, external_order_id, dan issued_vouchers hanya jika kolom tersebut ada untuk jenis peristiwa yang dipilih.

Periksa: Jaga privasi webhook URL. Uji peristiwa nyata sebelum mengaktifkan pesan yang tidak dapat diubah, voucher, atau perubahan CRM.

Dapatkan kunci 7stamp API sebelum membuka Make

Ini adalah layar 7stamp Admin yang sebenarnya. Buat kunci sekali, salin ke Make koneksi amanHTTP/keychain, lalu segera hapus dari clipboard Anda.

7stamp Admin API & Layar Integrasi dengan daftar API Keys dan kontrol Add API Key
Di 7stamp Admin, buka API & Integrasi, lalu API Keys, dan pilih Add API Key.
Dialog kunci 7stamp API baru dengan kontrol penyalinan terlihat
Salin kunci hanya ke dalam koneksi Make HTTP yang aman/keychain. Perlakukan itu seperti kata sandi dan putar jika terbuka.

Siapkan koneksi sebelum membangun

Buat satu API kunci per lingkungan

Di 7stamp Admin, buka API & Integrations → API Keys → Add API Key. Simpan nilai dalam koneksi kunci Make HTTP API/keychain ketika opsi tersebut tersedia. Jangan pernah memetakan kunci dari bidang teks, menempatkannya dalam catatan, atau menggunakannya dalam alur kerja yang menghadap browser. Kunci milik salah satu 7stamp tempat kerja/profile.

Gunakan kandang External ID

Petakan ID yang tidak dapat diubah dari CRM, POS, atau platform perdagangan Anda—misalnya a CRM hubungi ID atau pelanggan UUID. Tambahkan External Source seperti hubspot, shopify, atau poster ketika pengenal yang sama dapat muncul di lebih dari satu sistem.

Putuskan templat mana yang berlaku

Bila profil 7stamp yang terhubung memiliki satu templat kartu aktif, Templat dapat dikosongkan. Dengan beberapa templat, petakan atau pilih template_id dengan sengaja sehingga setiap undangan dan pemindaian mencapai program loyalitas yang diinginkan.

Pengaturan tepat Make HTTP: buat satu undangan kartu

Salin ini ke langkah otomatisasi Anda 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
}

Bangun dan uji Make skenario pertama Anda

01

Di 7stamp Admin, buat kunci di API & Integrations → API Keys → Add API Key. Gunakan profil pengujian terpisah/key jika pengaturan akun Anda mengizinkannya.

02

Di Make, buat skenario dan tambahkan pemicu sumber. Jalankan sekali sebelum memetakan sehingga Anda dapat melihat contoh kontak nyata atau pesanan berbayar.

03

Klik tanda tambah berikutnya, cari HTTP, dan pilih Make permintaan. Atur metode, URL lengkap, dan header dari kartu operasi di halaman ini.

04

Gunakan GET https://api.7loc.com/cards-api/templates sebagai permintaan pertama. Responsnya yang berhasil membuktikan bahwa kuncinya berfungsi tanpa mengubah data pelanggan apa pun.

05

Untuk rute POST, pilih application/json dan tempel bentuk tubuh dari panduan ini. Petakan kandang External ID; tambahkan template_id hanya jika profil memiliki beberapa templat aktif.

06

Jalankan dengan kontak sekali pakai, periksa keluaran HTTP, dan baru kemudian petakan bidang respons persisnya ke modul CRM, email, atau perpesanan berikutnya.

Kapan sebaiknya Anda menggunakan Make HTTP?

Gunakan HTTP untuk 7stamp sekarang: ini adalah rute siap produksi yang terdokumentasi, bukan fallback yang dikurangi. Pilih kapan pun Anda memerlukan operasi 7stamp, rute API baru, atau koneksi khusus POS/ERP. Referensi OpenAPI adalah sumber kebenaran untuk metode, jalur lengkap, isi, dan skema respons; kunci pembawa dan alasnya URL tetap sama.

Menerima 7stamp peristiwa di Make

Untuk skenario berbasis peristiwa, tambahkan Webhooks → Custom webhook dan buat webhook. Salin URL-nya, buka API & Integrations → Webhooks di profil 7stamp, tempel URL, pilih jenis acara, simpan, dan kirim acara pengujian sebenarnya. Profil 7stamp memiliki langganan itu; API saat ini tidak mengekspos titik akhir berlangganan webhook otomatis/unsubscribe.

Tidak diperlukan konektor Make publik

Petunjuk di halaman ini menggunakan modul Make yang tersedia untuk setiap akun Make. Jika Anda menginginkan modul 7stamp asli masa depan daripada HTTP, kirimkan kepada kami alur kerja yang Anda perlukan; sampai saat itu, HTTP dan Custom webhook mencakup setiap operasi 7stamp yang terdokumentasi.

Tanyakan tentang konektor asli

Pertanyaan yang sering diajukan

Saya tidak dapat menemukan 7stamp di Make. Apakah saya masih bisa mengotomatiskannya?

Ya. Tidak ada aplikasi 7stamp publik di Make hari ini. Tambahkan HTTP > Make permintaan, gunakan titik akhir 7stamp lengkap URL, dan kirim Authorization: Bearer diikuti dengan kunci 7stamp API Anda. HTTP dapat memanggil setiap titik akhir yang terdokumentasi.

Di mana saya bisa mendapatkan token untuk koneksi Make?

Di 7stamp Admin, buka API Integrasi, lalu API Keys, lalu Add API Key. Kuncinya tercakup dalam tempat kerja/profile yang menciptakannya, jadi gunakan profil pengujian untuk skenario pengujian bila memungkinkan.

Pengidentifikasi mana yang harus saya petakan sebagai External ID?

Gunakan pengenal stabil dari sistem sumber, sebaiknya kontak CRM ID atau pelanggan UUID. Jangan gunakan nama tampilan. Nomor telepon atau email bisa berfungsi, namun bisa berubah dan harus ditangani secara konsisten.

Bagaimana cara memasukkan acara 7stamp ke Make?

Buat Webhook > Custom webhook di Make, lalu tempelkan URL yang dihasilkan ke pengaturan webhook profil 7stamp. Gunakan filter atau router Make setelah pengiriman untuk menangani event_type yang masuk.

Halaman terkait

Buka Make Make HTTP bantuan Make Custom webhook bantuan 7stamp API referensi Penyiapan webhook Zapier panduan

Langkah selanjutnya

Siap mengotomatiskan tindakan loyalitas pertama?

Buat kunci API, uji List Templates, dan buat satu skenario undangan atau pindaian dengan kontak sekali pakai. Tambahkan router dan perpesanan hanya setelah aliran sederhana itu dapat diandalkan.

Buka 7stamp Admin Baca referensi API