Buat kad selepas kenalan CRM baharu
Gunakan CRM kenalan ID sebagai External ID, buat 7stamp jemputan kad, kemudian hantar pemasangan kembali URL melalui e-mel biasa anda, SMS, atau langkah pemesejan.
Panduan automasi tanpa kod
Sambungkan 7stamp ke Make — langkah demi langkah
Panduan pelaksanaanGunakan Make untuk menyambungkan 7stamp dengan CRM, POS, kedai dalam talian, hamparan, alat pemesejan atau mana-mana sistem yang boleh menghantar data ke dalam senario. Laluan sedia pengeluaran hari ini ialah apl Make HTTP untuk 7stamp API panggilan dan Make Custom webhook untuk acara 7stamp masuk.
Belum ada apl 7stamp awam dalam pemilih apl Make lagi. Jangan tunggu satu: tambah HTTP → Make a request, gunakan URL tepat, kaedah, pengepala Bearer dan JSON di bawah, kemudian petakan medan daripada modul sumber anda. Ini adalah sama 7stamp Integration API penyambung masa depan yang akan digunakan.
Pilih senario pertama yang sepadan dengan aliran kerja anda
Mulakan dengan satu acara dan satu hasil. Setelah data ujian betul, tambahkan penapis, penghala, kemas kini CRM dan mesej susulan di sekelilingnya.
Tambah setem selepas pesanan berbayar
Cetuskan senario daripada pesanan POS atau e-dagang berbayar. Petakan pelanggannya yang stabil ID dan pesan ID ke dalam Imbas Kad, kemudian gunakan jumlah atau kiraan setem yang jelas.
Hantar susulan ganjaran
Apabila acara kad melaporkan ganjaran atau baucar, cabangkan senario: kemas kini CRM, maklumkan pasukan dan hantar tolak kad dompet atau e-mel hanya apabila diperlukan.
Kendalikan sistem tanpa apl Make asli
Gunakan modul Make HTTP untuk menghubungi 7stamp terus. Ini adalah pilihan universal untuk POS tersuai, ERP, enjin tempahan, atau mana-mana perkhidmatan API-pertama.
7stamp operasi untuk membuat panggilan daripada Make HTTP
Untuk setiap kad di bawah, tambahkan HTTP → Make a request, kemudian tetapkan kaedah dan URL betul-betul seperti yang ditunjukkan. Gunakan kekunci Bearer yang sama untuk setiap permintaan. Pemetaan yang diperlukan memberitahu anda perkara yang perlu dibekalkan daripada pencetus CRM, POS atau e-dagang anda.
Make pencetus
Webhooks → Custom webhook Terima acara kad
Cipta Custom webhook dalam Make, salin URLnya, kemudian tampalkan URL ke dalam tetapan web 7stamp. Ini memulakan senario apabila 7stamp menghantar acara seperti SCAN, REWARD_EARNED atau VOUCHER_ISSUED.
- Dalam Make
- Webhooks → Custom webhook → Tambah; berikan nama yang jelas dan salin URL yang dihasilkan.
- Dalam 7stamp
- Admin → API & Integrations → Webhooks; tampal URL, pilih jenis acara, simpan, kemudian buat acara ujian.
HTTP tindakan
POST /cards/invite Cipta Card Invite
Mencipta pemasangan peribadi baharu URL dan kod sisip penghantaran untuk satu kenalan luaran.
- Diperlukan
- external_id — petakan kandang anda CRM/contact ID, bukan nama.
- Kemudian gunakan
- Peta install_url daripada jawapan ke dalam e-mel anda, SMS atau CRM langkah kemas kini.
HTTP tindakan
POST /cards/invite/bulk Buat Pukal Card Invites
Mencipta sehingga 100 pautan jemputan dalam satu permintaan. Gunakannya untuk migrasi atau kempen terkawal, bukan eksport hubungan tanpa had.
- Diperlukan
- item — susunan JSON 1–100 objek permintaan jemputan individu.
- Semak
- Baca success_count, error_count, dan setiap keputusan sebelum menghantar sebarang pautan.
HTTP tindakan
GET /cards Find Cards
Cari rekod kad mengikut External ID, dengan templat pilihan dan penapis sumber.
- Diperlukan
- Parameter pertanyaan external_id.
- Pilihan
- external_source dan template_id sempitkan carian apabila satu sistem mempunyai berbilang program.
HTTP tindakan
GET /cards/{user_card_id} Dapatkan Butiran Kad
Membaca keadaan penuh satu kad apabila langkah sebelumnya telah mengembalikan dalaman User Card ID.
- Diperlukan
- Gantikan {user_card_id} dengan dalaman ID dikembalikan oleh respons 7stamp yang dipercayai.
- Elakkan
- Jangan meneka atau simpan kad ID dari profil lain.
HTTP tindakan
POST /cards/scan Imbas Kad
Menambah setem daripada jumlah pembelian atau kiraan yang jelas. Ia menerima User Card ID atau External ID dan boleh mengekalkan rujukan pesanan luaran.
- Identiti
- Gunakan external_id dan pilihan external_source; user_card_id menang jika kedua-duanya dibekalkan.
- Beli
- Gunakan jumlah untuk kad berdasarkan jumlah atau stamps_count untuk nombor yang jelas; stamps_count diutamakan.
- Kebolehkesanan
- Petakan external_order_id daripada pesanan berbayar/receipt jadi 7stamp acara boleh dipadankan kembali.
HTTP tindakan
GET /templates List Templates
Menyenaraikan templat kad yang tersedia untuk kekunci API. Gunakannya untuk menguji sambungan atau untuk memilih templat secara dinamik.
- Ujian pertama
- Ini adalah permintaan pertama yang paling selamat: ia tidak mempunyai badan dan tidak mengubah data pelanggan.
- Peta kemudian
- Gunakan id templat aktif sebagai template_id hanya apabila profil mempunyai lebih daripada satu templat aktif.
HTTP tindakan
GET /templates/{template_id}/design Get Template Design
Mengembalikan tetapan reka bentuk visual untuk templat yang diketahui, berguna apabila sistem lain perlu memaparkan pilihan kad yang konsisten.
HTTP tindakan
POST /vouchers/issue Keluarkan Baucar
Mengeluarkan baucar kepada pemilik kad yang dikenal pasti oleh External ID atau User Card ID.
- Diperlukan
- baucar.short_description. Sasarkan kad dengan external_id atau user_card_id yang diketahui.
- Kesahan
- Gunakan validity_type dengan validity_value, atau baca rujukan OpenAPI untuk tarikh luput tetap.
HTTP tindakan
POST /messages/send Hantar Mesej
Menghantar kandungan kepada pemilik kad melalui tolak kad dompet dan/or e-mel, tertakluk pada saluran yang dikonfigurasikan dan peraturan persetujuan.
- Tekan kad
- card_push_text terhad kepada 20 aksara dan memerlukan pas dompet yang dipasang.
- E-mel
- Hantar subjek tambah badan; asas HTML disokong dalam badan.
Make modul
Full 7stamp endpoint URL HTTP → Make a request
Ini ialah modul Make yang memanggil setiap 7stamp laluan di atas. Gunakan URL lengkap, pilih kaedah yang didokumenkan, tambahkan pengepala Bearer dan gunakan JSON hanya apabila laluan memerlukan badan.
- Pangkalan URL
- https://api.7loc.com/cards-api
- Tajuk
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json untuk POST permintaan.
Tiga Make senario yang anda boleh bina betul-betul seperti yang ditulis
Nama-nama di bawah adalah modul Make sebenar. Mulakan dengan senario pertama, jalankannya terhadap kenalan pakai buang, dan kemudian tambahkan penghala, penapis atau penjadualan pengeluaran.
1. Baru CRM kenalan → hantar pautan 7stamp kad
Hasil yang dijangkakan: Pelanggan menerima install_url dikembalikan oleh 7stamp; CRM anda boleh menyimpan URL itu dalam rekod hubungan yang sama.
- 1 Buat senario dan tambahkan CRM Baharu/Created Pencetus Kenalan anda. Untuk Kommo, pilih pencetus penciptaan kenalan dan jalankannya sekali untuk memuatkan contoh kenalan.
- 2 Tambah HTTP → Make a request. Tetapkan Kaedah kepada POST dan URL kepada https://api.7loc.com/cards-api/cards/invite.
- 3 Tambah Authorization: Bearer YOUR_7STAMP_⟦1553 dan ⟦1553⟦: application/json. Dalam kandungan JSON, petakan CRM kenalan ID ke dalam external_id dan tetapkan external_source kepada label tetap seperti kommo.
- 4 Jalankan modul HTTP sekali. Sahkan output mempunyai install_url, delivery_insert_code, external_id dan template_id.
- 5 Tambahkan e-mel anda/SMS/CRM modul kemas kini selepas HTTP dan petakan install_url daripada output HTTP. Simpan URL pada CRM kenalan jika pasukan mesti menghantarnya semula kemudian.
Semak: POST /cards/invite sentiasa mencipta jemputan baharu. Gunakan Find Cards dahulu jika peraturan perniagaan anda adalah untuk mengelakkan jemputan lain untuk kenalan sedia ada.
2. Pesanan berbayar → tambah setem kesetiaan
Hasil yang dijangkakan: Respons imbasan yang berjaya termasuk kejayaan, scan_id, stamps_added, dan keadaan kad pasca-imbasan untuk langkah seterusnya anda.
- 1 Mulakan daripada pencetus POS/ecommerce Pesanan Berbayar. Make pasti sampelnya mengandungi pelanggan yang stabil ID dan pesanan/receipt ID.
- 2 Tambahkan HTTP → Make a request dengan POST https://api.7loc.com/cards-api/cards/scan dan pengepala Bearer yang sama.
- 3 Peta external_id daripada pelanggan, external_source daripada nama sistem dan external_order_id daripada pesanan ID. Tambahkan amaun untuk kad berasaskan amaun atau stamps_count untuk bilangan setem yang jelas.
- 4 Run once dengan pesanan ujian. Semak bendera kejayaan yang dikembalikan dan stamps_added sebelum mendayakan jadual senario.
- 5 Tambah penapis selepas langkah HTTP: teruskan hanya apabila kejayaan benar, kemudian tulis scan_id atau stamps_added kembali ke rekod pesanan/CRM.
Semak: Gunakan external_order_id yang sama semasa mencuba semula supaya pesanan boleh dikesan dalam acara webhook kemudian; jangan berikan setem dua kali selepas larian gagal yang tidak jelas.
3. 7stamp acara → kemas kini acara CRM
Hasil yang dijangkakan: Make menerima acara 7stamp serta-merta dan boleh mencari padanan ⟦1602 melalui ⟦1602 external_source.
- 1 Buat senario Make berasingan. Tambah Webhooks → Custom webhook, pilih Tambah, namakannya 7stamp-card-events, dan salin URL yang dihasilkan.
- 2 Dalam 7stamp Admin, buka API & Integrations → Webhooks. Tambahkan URL itu dan pilih set kecil acara, contohnya SCAN dan REWARD_EARNED.
- 3 Buat imbasan ujian pakai buang atau acara kad dalam 7stamp. Kembali ke Make dan gunakan Run once untuk membenarkan Make menentukan struktur data peristiwa.
- 4 Tambah CRM langkah carian menggunakan external_id. Tambahkan penapis atau penghala pada event_type supaya SCAN, REWARD_EARNED dan VOUCHER_ISSUED boleh mengambil tindakan yang berbeza.
- 5 Tambahkan tindakan CRM kemas kini/note. Peta scanned_at, stamps_after, external_order_id dan issued_vouchers hanya apabila medan tersebut hadir untuk jenis acara yang dipilih.
Semak: Pastikan webhook URL peribadi. Uji peristiwa sebenar sebelum menghidupkan mesej tidak boleh balik, baucar atau CRM perubahan.
Dapatkan kunci 7stamp API sebelum membuka Make
Ini adalah skrin 7stamp Admin yang tepat. Cipta kunci sekali, salin ke dalam sambungan Make selamat HTTP/keychain, kemudian keluarkannya dengan segera daripada papan keratan anda.
Sediakan sambungan sebelum membina
Cipta satu kunci API setiap persekitaran
Dalam 7stamp Admin, pergi ke API & Integrations → API Keys → Add API Key. Simpan nilai dalam Make's HTTP API-sambungan kunci/keychain apabila pilihan itu tersedia. Jangan sekali-kali memetakan kunci daripada medan teks, letakkannya dalam nota atau gunakannya dalam aliran kerja yang menghadap pelayar. Kunci kepunyaan satu 7stamp tempat kerja/profile.
Gunakan kandang External ID
Map the immutable ID from your CRM, POS, or commerce platform—for example a CRM contact ID or customer UUID. Add External Source such as hubspot, shopify, or poster when the same identifier could appear in more than one system.
Tentukan templat yang digunakan
Apabila profil 7stamp yang disambungkan mempunyai satu templat kad aktif, Templat boleh dibiarkan kosong. Dengan berbilang templat, petakan atau pilih template_id dengan sengaja supaya setiap jemputan dan imbasan mencapai program kesetiaan yang dimaksudkan.
Persediaan Make HTTP tepat: buat satu jemputan kad
Salin ini ke dalam langkah automasi 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
}Bina dan uji senario Make pertama anda
Dalam 7stamp Admin⟦ cipta kunci masuk 7stamp Admin⟦. Gunakan profil ujian yang berasingan/key apabila persediaan akaun anda membenarkannya.
Dalam Make, buat senario dan tambah pencetus sumber. Jalankannya sekali sebelum memetakan supaya anda boleh melihat contoh kenalan sebenar atau pesanan berbayar.
Klik tambah seterusnya, cari HTTP, dan pilih Make permintaan. Tetapkan kaedah, penuh URL, dan pengepala daripada kad operasi pada halaman ini.
Gunakan GET https://api.7loc.com/cards-api/templates sebagai permintaan pertama. Sambutan yang berjaya membuktikan kunci berfungsi tanpa mengubah sebarang data pelanggan.
Untuk laluan POST, pilih application/json dan tampal bentuk badan daripada panduan ini. Petakan kandang External ID; tambah template_id hanya jika profil mempunyai berbilang templat aktif.
Jalankan dengan sesentuh pakai buang, periksa output HTTP, dan kemudian petakan medan tindak balas tepatnya ke dalam CRM, e-mel atau modul pemesejan seterusnya.
Bilakah anda patut menggunakan Make HTTP?
Gunakan HTTP untuk 7stamp sekarang: ia adalah laluan yang didokumenkan, sedia pengeluaran, bukan sandaran yang dikurangkan. Pilihnya pada bila-bila masa anda memerlukan operasi 7stamp, laluan API baharu atau sambungan POS/ERP tersuai. Rujukan OpenAPI ialah sumber kebenaran untuk kaedah, laluan penuh, isi dan skema tindak balas; kunci pembawa dan tapak URL kekal sama.
Terima 7stamp acara dalam Make
Untuk senario dipacu peristiwa, tambah Webhooks → Custom webhook dan buat webhook. Salin URLnya, buka API & Integrations → Webhooks dalam profil 7stamp, tampal URL, pilih jenis acara, simpan dan hantar acara ujian sebenar. Profil 7stamp memiliki langganan itu; API semasa tidak mendedahkan titik tamat langganan webhook automatik/unsubscribe.
Tiada penyambung Make awam diperlukan
Arahan pada halaman ini menggunakan modul Make yang tersedia untuk setiap akaun Make. Jika anda mahukan modul 7stamp asli masa hadapan dan bukannya HTTP, hantarkan aliran kerja yang anda perlukan kepada kami; sehingga itu, HTTP dan Custom webhooks meliputi setiap operasi 7stamp yang didokumenkan.
Soalan lazim
Saya tidak dapat mencari 7stamp dalam Make. Bolehkah saya masih mengautomasikannya?
Ya. Tiada apl 7stamp awam dalam Make hari ini. Tambahkan HTTP > Make permintaan, gunakan titik akhir 7stamp lengkap URL, dan hantar Authorization: Bearer diikuti dengan kunci 7stamp API anda. HTTP boleh menghubungi setiap titik akhir yang didokumenkan.
Di manakah saya boleh mendapatkan token untuk sambungan Make?
Dalam 7stamp Admin, buka API Integrasi, kemudian API Keys, kemudian Add API Key. Kunci itu diskop kepada tempat kerja/profile yang menciptanya, jadi gunakan profil ujian untuk senario ujian apabila boleh.
Pengecam mana yang harus saya petakan sebagai External ID?
Gunakan pengecam stabil daripada sistem sumber, sebaiknya hubungi CRM ID atau pelanggan UUID. Jangan gunakan nama paparan. Nombor telefon atau e-mel boleh berfungsi, tetapi boleh berubah dan harus dikendalikan secara konsisten.
Bagaimanakah saya boleh mendapatkan 7stamp acara ke dalam Make?
Cipta Webhooks > Custom webhook dalam Make, kemudian tampal URL terjananya ke dalam tetapan webhook profil 7stamp. Gunakan penapis atau penghala Make selepas penghantaran untuk mengendalikan event_type yang masuk.
Langkah seterusnya
Bersedia untuk mengautomasikan tindakan kesetiaan pertama?
Cipta kekunci API, uji List Templates dan bina satu senario jemputan atau imbas dengan kenalan pakai buang. Tambahkan penghala dan pemesejan hanya selepas aliran mudah itu boleh dipercayai.