Kehittäjäintegraatio
Siirrä jokainen kanta-asiakastapahtuma numerosta 7Stamp omiin järjestelmiisi reaaliajassa. Ei kyselyä eikä ajoitettuja 20802⟧-puheluita. Tapahtumat saapuvat HTTPS POST-pyyntöinä muutamassa sekunnissa tapahtumisesta.
Käytä webhookeja pitääksesi CRM, ERP tai mukautettu taustatietosi synkronoituna uskollisuuspuolen tapahtumien kanssa: kuka liittyi, kuka sai leiman, kuka lunasti kupongin, kuka laukaisi syntymäpäivälahjan ja ketkä tulivat passiivisiksi. Sitten järjestelmäsi päättävät, mitä tehdä niille tiedoille.
Webhookit ovat integrointipinon lähtevä puoli. Ne heijastavat asiakas- ja palkitsemistoimintaa järjestelmiin, joihin jo luotat myynnin, palvelun, analytiikan ja viestien osalta.
Jokainen leima, kuponki, syntymäpäivä ja toimettomuuden liipaisin laskeutuu asiakastietueeseen numerossasi CRM. Näet täydellisen uskollisuusaikajanan myynnin, puheluiden ja lippujen vieressä kirjautumatta sisään numeroon 7Stamp.
Kun asiakas lunastaa kupongin, lähetä kiitos SMS nykyisestä SMS-yhdyskäytävästäsi. Kun asiakas saavuttaa tavoitteen, julkaise juhlanumero Slack. Kun joku tulee epäaktiiviseksi, ohjaa tapaus tilivastaavallesi.
Suoratoista tapahtumat BI työkalullesi, varastoosi tai täsmäytysputkistoon. Yhdistä kuponkien lunastukset kuitteihin POS ja laske uskollisuus ROI omissa mittareissasi.
Päätepisteesi tulee hyväksyä HTTPS POST, vahvistaa pyynnön muoto, säilyttää tapahtuma tai asettaa tapahtuma jonoon ja palauttaa sitten onnistunut 2xx-vastaus. Älä soita hidasta CRM- tai viestipuhelua ennen kuittausta, jos se voidaan asettaa turvallisesti jonoon.
Jokaisessa asiaan liittyvässä tapahtumassa voi olla External ID ja valinnainen External Source, joita käytit korttia luodessasi tai skannaessasi. Käytä tätä paria päivittääksesi omat numerosi CRM, POS tai tilata tietueesi arvaamatta nimen tai sähköpostiosoitteen perusteella.
Säilytä kestävä käsittelyavain tai tapahtumasormenjälki ennen sivuvaikutusten laukaisemista. Jos vastaanottaja näkee saman toimituksen uudelleen, sen ei pitäisi lisätä kaksoiskappaletta CRM muistiinpanoa, kuponkia tai viestiä. Käsittele päätepistettä URL salaisuutena.
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
}
}
}Luo HTTPS päätepiste taustajärjestelmääsi, CRM integrointikerrokseen, ⟦20836 tai webhook36 Zapier Catch Hook. Make varmista, että hallitset kohdetta ennen kuin kopioit sen URL.
Avaa numerossa 7Stamp Admin Stamp Cards → API & Integrations → Webhooks.
Lisää päätepisteen URL. Webhook vastaanottaa profiilin jokaisen korttitapahtuman, joten suodata vastaanottavassa järjestelmässäsi data.event_type-kentän mukaan.
Tallenna profiiliasetukset ja käynnistä sitten kertakäyttöinen testiskannaus tai korttitoiminto tapahtuman tuottamiseksi.
Tarkista vastaanotettu hyötykuorma. Yhdistä External ID ja External Source odotettuun tietueeseen ja varmista, että vastaanottaja palauttaa onnistuneen vastauksen.
Ota CRM-, kuponki- tai viestisivuvaikutukset käyttöön vasta sen jälkeen, kun olet käsitellyt uudelleen ja valvonut vikoja.
Luo kohdassa Make Webhooks → Custom webhook vastaanottava URL ja liitä se profiiliin 7Stamp. Käytä kohdassa Zapier numeroa Webhooks by Zapier → Catch Hook samaan tarkoitukseen. Profiili 7Stamp omistaa tilauksen, koska nykyinen API ei paljasta automaattisia webhook-rekisteröintipäätepisteitä.
Käytä julkisen OpenAPI-viitteen Webhooks-osiota nykyisen payload-skeeman lähteenä. Runko on kirjekuori: profile_id ja profile_name nimeävät 7Stamp-profiilin, event_id yksilöi tapahtuman ja itse korttitapahtuma on kentässä data (Make- tai Zapier-URL:n kohdalla avain on card_event). Jokainen toimitus allekirjoitetaan yhdessä otsakkeessa, X-Webhook-Signature: t=…,s=…. Laske HMAC-SHA256 webhookin salaisuudella arvosta t, jota seuraa pyynnön raaka runko, koodaa tulos heksadesimaaliseksi ja vertaa sitä arvoon s; salaisuus on webhookin sivulla 7Stamp Adminissa. Käytä X-Webhook-Event-Id-otsaketta toistuvien toimitusten hylkäämiseen: uudelleenyritys allekirjoitetaan uudelleen uudella t-arvolla. Voit suojata päätepisteen myös Basic Auth -todennuksella. Vaadi HTTPS ja pidä vastaanottajan URL poissa julkisista lokeista.
Ei. 7Stamp-webhook vastaanottaa profiilin jokaisen korttitapahtuman. Suodata vastaanottavassa järjestelmässäsi data.event_type-kentän mukaan; Makessa ja Zapierissa tapahtuma tulee kentän card_event alla, joten suodata card_event.event_type-kentän mukaan.
Luo vastaanottava webhook kohteessa Make tai Catch Hook tiedostossa Zapier, kopioi luotu URL, liitä se profiilin 7Stamp webhook-asetuksiin ja lähetä testitapahtuma.
Käytä kenttää data.external_id ja, jos se on mukana, kenttää data.external_source: ne palautuvat jokaisessa webhookissa korteille, jotka olet myöntänyt API:n kautta omalla tunnuksellasi. Asiakkaalla, joka otti kortin itse, ei ole External ID -tunnusta, joten yhdistä hänet kentän data.user.email perusteella. Applen ”Hide My Email” -osoite on välitysosoite, ei se osoite, joka on CRM-järjestelmässäsi.
Jaa X-Webhook-Signature-otsake osiin t ja s, laske HMAC-SHA256 7Stamp Administa saadulla webhookin salaisuudella arvosta t, jota seuraa pyynnön raaka runko, koodaa tulos heksadesimaaliseksi ja vertaa sitä arvoon s. Käytä t-arvoa täsmälleen sellaisena kuin se lähetettiin ja runkoa vastaanotettuina raakatavuina ennen minkäänlaista JSON-jäsennystä. Hylkää toimitus, jonka X-Webhook-Event-Id on jo käsitelty: uudelleenyritys allekirjoitetaan uudelleen uudella t-arvolla.
Aiheeseen liittyvät sivut
Seuraava askel
Luo vastaanotin, liitä sen HTTPS URL profiiliin, suorita kertakäyttöinen skannaus ja vahvista vastaava External ID ennen kuin otat myöhemmän automatisoinnin käyttöön.