Pagsasama ng developer
Itulak ang bawat kaganapan ng katapatan mula 7stamp papunta sa sarili mong mga system sa real time. Walang botohan at walang naka-iskedyul na API na tawag. Dumating ang mga kaganapan bilang HTTPS POST mga kahilingan sa loob ng ilang segundo pagkatapos mangyari.
Gumamit ng mga webhook upang panatilihing naka-sync ang iyong CRM, ERP, o custom na backend sa kung ano ang nangyayari sa panig ng katapatan: sino ang sumali, sino ang nakakuha ng selyo, sino ang nag-redeem ng isang voucher, sino ang nag-trigger ng regalo sa kaarawan, at sino ang naging hindi aktibo. Pagkatapos ay magpapasya ang iyong mga system kung ano ang gagawin sa data na iyon.
Ang mga webhook ay ang papalabas na bahagi ng integration stack. Sinasalamin nila ang aktibidad ng customer at reward sa mga system na pinagkakatiwalaan mo na para sa mga benta, serbisyo, analytics, at pagmemensahe.
Bawat stamp, voucher, birthday, at inactivity trigger ay dumarating sa rekord ng customer sa iyong CRM. Makikita mo ang buong timeline ng katapatan sa tabi ng mga benta, tawag, at ticket nang hindi nagla-log in sa 7stamp.
Kapag nag-redeem ng voucher ang isang customer, magpadala ng thank-you SMS mula sa iyong kasalukuyang SMS gateway. Kapag naabot ng customer ang layunin, mag-post ng pagdiriwang sa Slack. Kapag naging hindi aktibo ang isang tao, iruta ang kaso sa iyong account manager.
I-stream ang mga kaganapan sa iyong BI tool, warehouse, o pipeline ng reconciliation. Itugma ang mga pagkuha ng voucher laban sa POS na mga resibo at kalkulahin ang katapatan ROI sa iyong sariling mga sukatan.
Dapat tanggapin ng iyong endpoint ang HTTPS POST, patunayan ang hugis ng kahilingan, ipagpatuloy o i-queue ang kaganapan, pagkatapos ay magbalik ng matagumpay na 2xx na tugon. Huwag gumawa ng mabagal na CRM o tawag sa pagmemensahe bago ang pag-acknowledgement kung maaari itong ma-queue nang ligtas.
Ang bawat nauugnay na kaganapan ay maaaring magdala ng External ID at opsyonal na External Source na ginamit mo sa paggawa o pag-scan ng card. Gamitin ang pares na ito para i-update ang sarili mong CRM, POS, o record ng order nang hindi hinuhulaan ang pangalan o email.
Mag-imbak ng matibay na processing key o event fingerprint bago mag-trigger ng mga side effect. Kung nakita muli ng iyong receiver ang parehong paghahatid, hindi ito dapat magdagdag ng duplicate na CRM note, voucher, o mensahe. Tratuhin ang endpoint URL bilang sikreto.
json {
"event_type": "SCAN",
"scanned_at": "2026-07-23T12:34:56Z",
"user_card_id": 123,
"card_template_id": 42,
"card_template_name": "Coffee Loyalty",
"stamps_added": 1,
"stamps_before": 4,
"stamps_after": 5,
"amount": 24.5,
"external_order_id": "order_2048",
"external_id": "crm_contact_8821",
"external_source": "hubspot"
}Gumawa ng HTTPS endpoint sa iyong backend, CRM integration layer, Make webhook, o Zapier Catch Hook. Make siguraduhing kontrolin mo ang patutunguhan bago kopyahin ang URL nito.
Sa 7stamp Admin, buksan ang Stamp Cards → API & Integrations → Webhooks.
Idagdag ang endpoint URL at piliin lamang ang mga uri ng kaganapan na talagang kailangan ng daloy ng trabaho sa pagtanggap.
I-save ang mga setting ng profile, pagkatapos ay mag-trigger ng disposable test scan o card action para makagawa ng event.
Suriin ang natanggap na kargamento. Itugma ang External ID at External Source sa inaasahang tala at kumpirmahin na ang receiver ay nagbabalik ng matagumpay na tugon.
I-enable lang ang CRM, voucher, o messaging side effect pagkatapos mong magkaroon ng replay-safe na paghawak at pagsubaybay para sa mga pagkabigo.
Sa Make, gamitin ang Webhooks → Custom webhook para bumuo ng receiving URL at i-paste ito sa 7stamp profile. Sa Zapier, gamitin ang Webhooks by Zapier → Catch Hook para sa parehong layunin. Ang 7stamp profile ay nagmamay-ari ng subscription dahil ang kasalukuyang API ay hindi naglalantad ng mga awtomatikong webhook registration endpoints.
Gamitin ang seksyong Webhooks ng pampublikong OpenAPI reference bilang pinagmulan para sa kasalukuyang payload schema at kahulugan ng field. Kinakailangan ang HTTPS, ilayo ang receiver URL sa mga pampublikong log, at gawing idempotent ang pagproseso. Kumpirmahin ang proseso ng kahilingan-pagpapatotoo/signature para sa iyong 7stamp profile habang nag-onboard bago magpatupad ng isang partikular na pangalan ng header o muling subukan ang patakaran sa produksyon.
Oo. Piliin ang mga uri ng kaganapan sa mga setting ng webhook ng 7stamp profile upang makuha lang ng receiver ang mga kaganapang mahalaga sa daloy ng trabaho nito.
Gawin ang receiving webhook sa Make o isang Catch Hook sa Zapier, kopyahin ang nabuong URL, pagkatapos ay i-paste ito sa 7stamp na mga setting ng webhook ng profile at magpadala ng test event.
Gamitin ang External ID at, kapag naroroon, External Source. Ito ang mga identifier na ibinigay ng iyong integration noong ginawa o na-scan ang card.
Hindi. Gamitin ang kasalukuyang OpenAPI/profile kontrata sa paghahatid at kumpirmahin ang pamamaraan ng pagpapatotoo para sa iyong profile habang nasa onboarding bago i-hard-coding ang isang header o subukang muli ang pagpapalagay.
Mga kaugnay na pahina
Susunod na hakbang
Gumawa ng receiver, i-paste ang HTTPS URL nito sa profile, magpatakbo ng disposable scan, at i-validate ang pagtutugma ng External ID bago i-enable ang downstream automation.