Onyesha historia ya uaminifu kwenye CRM yako
Kila muhuri, vocha, siku ya kuzaliwa na kutotumika huanzisha rekodi ya mteja katika CRM yako. Utaona rekodi kamili ya matukio ya uaminifu karibu na mauzo, simu na tikiti bila kuingia katika 7Stamp.
Ujumuishaji wa msanidi
7Stamp Viboko vya mtandao
InapatikanaSukuma kila tukio la uaminifu kutoka 7Stamp hadi mifumo yako mwenyewe kwa wakati halisi. Hakuna upigaji kura na hakuna simu zilizoratibiwa API. Matukio hufika kama maombi HTTPS POST ndani ya sekunde chache kutokea.
Tumia viboreshaji vya wavuti kuweka CRM, ERP, au mandharinyuma maalum katika kusawazisha na kile kinachotokea kwa upande wa uaminifu: nani alijiunga, aliyepata stempu, aliyekomboa vocha, aliyeanzisha zawadi ya siku ya kuzaliwa, na ambaye aliacha kufanya kazi. Kisha mifumo yako itaamua nini cha kufanya na data hiyo.
Unachoweza kufanya na viboreshaji vya wavuti
Webhooks ni upande wa nje wa safu ya ujumuishaji. Huakisi shughuli za wateja na zawadi katika mifumo ambayo tayari unaiamini kwa mauzo, huduma, takwimu na ujumbe.
Anzisha rafu yako mwenyewe ya ujumbe
Mteja anapokomboa vocha, tuma asante SMS kutoka kwa lango lako la SMS lililopo. Mteja anapofikia lengo, chapisha sherehe katika Slack. Mtu anapoacha kufanya kazi, elekeza kesi kwa msimamizi wa akaunti yako.
Takwimu za nguvu na upatanisho
Tiririsha matukio kwenye BI chombo chako, ghala au bomba la upatanisho. Linganisha ukombozi wa vocha dhidi ya POS risiti na ukokote uaminifu ROI katika vipimo vyako mwenyewe.
Aina za matukio ya kadi
SCAN — Kadi ilipata hatua ya kuchanganua/stamp.
REWARD_EARNED — Zawadi ilitolewa kwenye kadi.
VOUCHER_ISSUED — Vocha ilitolewa.
VOUCHER_REDEEMED — Vocha ilitumika.
LOTTERY_WIN — Bahati nasibu ilisababisha ushindi.
DELIVERY_INSERT — Mtiririko wa kuingiza-uwasilishaji ulirekodiwa.
CARD_JOINED — Mteja alijiunga na kadi.
CARD_CAMPAIGN — Tukio la kampeni ya kadi lilitokea.
BIRTHDAY_GREETING — Tukio la salamu za siku ya kuzaliwa lilitokea.
ADMIN_VOUCHER_ISSUE — Msimamizi alitoa vocha.
CARD_ADDED_TO_WALLET — Mteja aliongeza kadi kwenye pochi yake.
CARD_REMOVED_FROM_WALLET — Mteja aliondoa kadi kwenye pochi yake.
Unda kipokeaji salama cha mtandao
Kubali baada ya utunzaji wa kudumu
Mwisho wako unapaswa kukubali HTTPS POST, uthibitishe umbo la ombi, uendelee au upange tukio kwenye foleni, kisha urudishe jibu lililofaulu la 2xx. Usipige simu polepole CRM au kutuma ujumbe kabla ya kukiri ikiwa inaweza kupangwa kwa usalama.
Kuhusiana na External ID
Kila tukio linalohusiana linaweza kubeba External ID na ya hiari External Source uliyotumia wakati wa kuunda au kuchanganua kadi. Tumia jozi hii kusasisha yako binafsi CRM, POS, au uagize rekodi bila kubahatisha kutoka kwa jina au barua pepe.
Make bila uwezo wa kujifungua
Hifadhi ufunguo wa kudumu wa kuchakata au alama ya vidole vya tukio kabla ya kusababisha athari. Iwapo mpokeaji ataona uwasilishaji sawa tena, haipaswi kuongeza nakala CRM noti, vocha au ujumbe. Chukulia mwisho URL kama siri.
Mfano umbo la upakiaji wa tukio
Nakili hii katika hatua yako ya kiotomatiki
json {
"entity": "card_event",
"action": "created",
"entity_id": 707,
"event_id": "8f05e58decec48e09d328f0edebbacf6",
"profile_id": 2,
"profile_name": "Your Business",
"profile_lang": "en",
"data": {
"event_type": "SCAN",
"scanned_at": "2026-10-01T09:19:24.179424",
"user_card_id": 10,
"card_template_id": 14,
"card_template_name": "Collect your stamps!",
"stamps_added": 3,
"stamps_before": 1,
"stamps_after": 4,
"amount": null,
"external_order_id": "ORDER-1001",
"workplace": { "id": 4, "name": "Bar Counter" },
"device_type": null,
"external_id": "odoo_contact_8821",
"external_source": "odoo",
"issued_vouchers": [
{
"id": 174,
"unique_code": "100425813507",
"stamp_number": 4,
"issued_at": "2026-10-01T09:19:24.191836",
"expires_at": "2027-01-01T23:59:59",
"status": "ACTIVE",
"voucher_template_id": 58,
"voucher_description": "Free coffee",
"voucher_image_url": "https://..."
}
],
"achieved_goals": [],
"user": {
"id": 2,
"name": "Anna",
"full_name": "Anna Smith",
"email": "anna@example.com",
"telegram_chat_id": null,
"telegram_username": null,
"whatsapp_phone": null,
"birth_date": null
}
}
}Sanidi na ujaribu webhook
Unda sehemu ya mwisho ya HTTPS katika mazingira yako ya nyuma, CRM safu ya muunganisho, ⟦7221, CRM safu ya muunganisho, ⟦72, ⟦72, ⟦1271 Zapier Catch Hook. Make hakikisha unadhibiti lengwa kabla ya kunakili URL yake.
Katika 7Stamp Admin, fungua Stamp Cards → API & Integrations → Webhooks.
Ongeza URL ya sehemu ya mwisho. Webhook hupokea kila tukio la kadi la wasifu, kwa hiyo chuja kwa data.event_type kwenye kipokezi chako.
Hifadhi mipangilio ya wasifu, kisha uanzishe uchunguzi wa majaribio unaoweza kutumika au kitendo cha kadi ili kutoa tukio.
Kagua mzigo uliopokelewa. Linganisha External ID na External Source na rekodi inayotarajiwa na uthibitishe kuwa mpokeaji atarejesha jibu lililofaulu.
Washa CRM, vocha, au madhara ya kutuma ujumbe baada tu ya kuwa na ushughulikiaji-salama wa kucheza tena na ufuatiliaji kwa kushindwa.
Chaguo za no-code: Make na Zapier
Katika Make, tumia Webhooks → Custom webhook kutengeneza pokezi URL na ubandike kwenye wasifu 7Stamp. Katika Zapier, tumia Webhooks by Zapier → Catch Hook kwa madhumuni sawa. Wasifu wa 7Stamp unamiliki usajili kwa sababu API ya sasa haionyeshi ncha za usajili za kiotomatiki za wavuti.
Mkataba wa usalama na uwasilishaji
Tumia sehemu ya Webhooks ya marejeleo ya umma ya OpenAPI kama chanzo cha muundo wa sasa wa payload. Mwili wa ombi ni bahasha: profile_id na profile_name hutaja wasifu wa 7Stamp, event_id hutambulisha tukio, na tukio la kadi lenyewe liko ndani ya data (kwa URL ya Make au Zapier, ufunguo ni card_event). Kila uwasilishaji umetiwa sahihi katika kichwa kimoja, X-Webhook-Signature: t=…,s=…. Kokotoa HMAC-SHA256 kwa siri ya webhook yako juu ya t pamoja na mwili ghafi wa ombi, uisimbe kwa hex na uilinganishe na s; siri iko kwenye ukurasa wa webhook katika 7Stamp Admin. Tumia X-Webhook-Event-Id kuondoa uwasilishaji unaorudiwa: jaribio la kurudia hutiwa sahihi upya kwa t mpya. Unaweza pia kulinda sehemu ya mwisho kwa Basic Auth. Lazimisha HTTPS na usiweke URL ya kipokezi kwenye kumbukumbu za umma.
Maswali yanayoulizwa mara kwa mara
Je, ninaweza kuchagua matukio fulani pekee ya mtandao?
Hapana. Webhook ya 7Stamp hupokea kila tukio la kadi la wasifu. Chuja kwa data.event_type kwenye kipokezi chako; katika Make na Zapier tukio huja chini ya card_event, kwa hiyo chuja kwa card_event.event_type.
Je, ninawezaje kuunganisha vijiti vya wavuti kwa Make au Zapier?
Unda kipokezi cha wavuti katika Make au Catch Hook katika Zapier, nakili URL iliyotengenezwa, kisha ubandike kwenye mipangilio ya 7Stamp ya wasifu na utume tukio la jaribio.
Je, ninawezaje kulinganisha tukio na mwasiliani wangu CRM?
Tumia data.external_id na, inapokuwepo, data.external_source: hurudi katika kila webhook kwa kadi ulizotoa kupitia API kwa ID yako mwenyewe. Mteja aliyechukua kadi mwenyewe hana External ID, kwa hiyo mlinganishe kwa data.user.email. Anwani ya Apple “Hide My Email” ni anwani ya kupitisha, si ile iliyo kwenye CRM yako.
Nitathibitishaje kwamba webhook imetoka kwa 7Stamp?
Gawanya kichwa X-Webhook-Signature kuwa t na s, kokotoa HMAC-SHA256 kwa siri ya webhook kutoka 7Stamp Admin juu ya t pamoja na mwili ghafi wa ombi, uisimbe kwa hex na uilinganishe na s. Chukua t hasa kama ilivyotumwa, na mwili kama baiti ghafi zilizopokelewa, kabla ya uchanganuzi wowote wa JSON. Ondoa uwasilishaji ambao X-Webhook-Event-Id yake tayari umeichakata: jaribio la kurudia hutiwa sahihi upya kwa t mpya.
Kurasa zinazohusiana
Hatua inayofuata
Je, uko tayari kutuma tukio la kadi ya kwanza?
Unda kipokezi, ubandike HTTPS URL yake kwenye wasifu, tafuta changanuzi inayoweza kutumika, na uthibitishe ulinganishaji External ID kabla ya kuwezesha uwekaji kiotomatiki wa mkondo wa chini.