Kehittäjäintegraatio

7stamp Webhooks

Saatavilla

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.

Mitä voit tehdä webhookeilla

Webhookit ovat integrointipinon lähtevä puoli. Ne heijastavat asiakas- ja palkitsemistoimintaa järjestelmiin, joihin jo luotat myynnin, palvelun, analytiikan ja viestien osalta.

Peilaa uskollisuushistoria numeroosi CRM

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.

Käynnistä oma viestipino

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.

Tehoanalytiikka ja täsmäytys

Suoratoista tapahtumat BI työkalullesi, varastoosi tai täsmäytysputkistoon. Yhdistä kuponkien lunastukset kuitteihin POS ja laske uskollisuus ROI omissa mittareissasi.

Kortin tapahtumatyypit

SCAN — Kortti vastaanotti skannaustoiminnon/stamp.
REWARD_EARNED — Kortille ansaittiin palkinto.
VOUCHER_ISSUED — Tosite myönnettiin.
VOUCHER_REDEEMED — Kuponki lunastettiin.
LOTTERY_WIN — Lotto johti voittoon.
DELIVERY_INSERT — Toimitus-lisäosien virtaus tallennettiin.
CARD_JOINED — Asiakas liittyi korttiin.
CARD_CAMPAIGN — Tapahtui korttikampanjatapahtuma.
BIRTHDAY_GREETING — Syntymäpäivätervehdystapahtuma tapahtui.
ADMIN_VOUCHER_ISSUE — Järjestelmänvalvoja myönsi kupongin.
CARD_ADDED_TO_WALLET — Asiakas lisäsi kortin lompakkoonsa.
CARD_REMOVED_FROM_WALLET — Asiakas poisti kortin lompakosta.

Rakenna turvallinen webhook-vastaanotin

Hyväksy kestävän käsittelyn jälkeen

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.

Korreloi External ID kanssa

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.

Make toimitus idempotentti

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.

Esimerkkitapahtuman hyötykuorman muoto

Kopioi tämä automaatiovaiheeseen 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"
}

Määritä ja testaa webhook

01

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.

02

Avaa numerossa 7stamp Admin Stamp Cards → API & Integrations → Webhooks.

03

Lisää päätepiste URL ja valitse vain tapahtumatyypit, joita vastaanottava työnkulku todella tarvitsee.

04

Tallenna profiiliasetukset ja käynnistä sitten kertakäyttöinen testiskannaus tai korttitoiminto tapahtuman tuottamiseksi.

05

Tarkista vastaanotettu hyötykuorma. Yhdistä External ID ja External Source odotettuun tietueeseen ja varmista, että vastaanottaja palauttaa onnistuneen vastauksen.

06

Ota CRM-, kuponki- tai viestisivuvaikutukset käyttöön vasta sen jälkeen, kun olet käsitellyt uudelleen ja valvonut vikoja.

Koodittomat vaihtoehdot: Make ja Zapier

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ä.

Suojaus- ja toimitussopimus

Käytä julkisen OpenAPI-viitteen Webhooks-osiota nykyisen hyötykuormakaavion ja kentän merkityksen lähteenä. Vaadi HTTPS, pidä vastaanotin URL poissa julkisista lokeista ja tee käsittelystä idempotenttia. Vahvista 7stamp-profiilisi pyyntö-todennus/signature -menettely käyttöönottovaiheessa, ennen kuin otat käyttöön tietyn otsikon nimen tai yritä uudelleen käytäntöä tuotannossa.

Usein kysytyt kysymykset

Voinko valita vain tiettyjä webhook-tapahtumia?

Kyllä. Valitse tapahtumatyypit profiilin 7stamp webhook-asetuksista, jotta vastaanottaja saa vain ne tapahtumat, joilla on merkitystä sen työnkululle.

Kuinka yhdistän webhookit numeroihin Make tai Zapier?

Luo vastaanottava webhook kohteessa Make tai Catch Hook tiedostossa Zapier, kopioi luotu URL, liitä se profiilin 7stamp webhook-asetuksiin ja lähetä testitapahtuma.

Kuinka yhdistän tapahtuman numeroon CRM?

Käytä numeroa External ID ja External Source, kun se on olemassa. Nämä ovat tunnisteita, jotka integraatiosi toimitti, kun kortti luotiin tai skannattiin.

Pitäisikö minun olettaa allekirjoituksen otsikko vai yrittää uudelleen ajoitus?

Ei. Käytä nykyistä toimitussopimusta OpenAPI/profile ja vahvista profiilisi todennusprosessi käyttöönottovaiheessa ennen kuin koodaat otsikon tai yrität uudelleen oletusta.

Seuraava askel

Oletko valmis lähettämään ensimmäisen korttitapahtuman?

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.