충성도 내역을 CRM에 미러링
모든 스탬프, 바우처, 생일 및 비활성 트리거는 CRM의 고객 기록에 기록됩니다. 7stamp에 로그인하지 않고도 판매, 통화, 티켓 옆에서 전체 충성도 타임라인을 볼 수 있습니다.
개발자 통합
7stamp 웹후크
사용 가능7stamp의 모든 충성도 이벤트를 실시간으로 자체 시스템으로 푸시합니다. 폴링 및 예약된 API 호출이 없습니다. 이벤트는 발생 후 몇 초 내에 HTTPS POST 요청으로 도착합니다.
웹후크를 사용하여 CRM, ERP 또는 사용자 정의 백엔드를 충성도 측에서 일어나는 일(가입자, 스탬프 받은 사람, 바우처 교환한 사람, 생일 선물을 촉발한 사람, 비활성화된 사람)과 동기화 상태를 유지하세요. 그런 다음 시스템이 해당 데이터로 무엇을 할지 결정합니다.
What 웹후크를 사용하여 수행할 수 있습니다.
웹후크는 통합 스택의 아웃바운드 측입니다. 판매, 서비스, 분석 및 메시징에 대해 이미 신뢰하는 시스템에 고객 및 보상 활동을 반영합니다.
자체 메시징 스택 실행
고객이 바우처를 사용하면 기존 SMS 게이트웨이에서 감사 SMS를 보냅니다. 고객이 목표를 달성하면 Slack에 축하 메시지를 게시하세요. 누군가 활동하지 않으면 케이스를 계정 관리자에게 전달하세요.
강력한 분석 및 조정
이벤트를 BI 도구, 웨어하우스 또는 조정 파이프라인으로 스트리밍합니다. 바우처 상환을 POS 영수증과 일치시키고 자체 지표로 충성도 ROI를 계산하세요.
카드 이벤트 유형
SCAN — 카드가 scan/stamp 작업을 수신했습니다.
REWARD_EARNED — 카드에서 보상을 받았습니다.
VOUCHER_ISSUED — 바우처가 발행되었습니다.
VOUCHER_REDEEMED — 바우처가 사용되었습니다.
LOTTERY_WIN — 복권에 당첨되었습니다.
DELIVERY_INSERT - 전달-삽입 흐름이 기록되었습니다.
CARD_JOINED — 고객이 카드에 가입했습니다.
CARD_CAMPAIGN — 카드 캠페인 이벤트가 발생했습니다.
BIRTHDAY_GREETING — 생일 축하 이벤트가 발생했습니다.
ADMIN_VOUCHER_ISSUE — 관리자가 바우처를 발행했습니다.
CARD_ADDED_TO_WALLET — 고객이 지갑에 카드를 추가했습니다.
CARD_REMOVED_FROM_WALLET — 고객이 지갑에서 카드를 제거했습니다.
안전한 웹훅 수신기 구축
내구성 있는 처리 후 승인
엔드포인트는 HTTPS POST를 승인하고 요청 형태를 검증하고 이벤트를 유지하거나 대기열에 추가한 다음 성공적인 2xx 응답을 반환해야 합니다. 안전하게 대기열에 추가할 수 있는 경우 승인 전에 느린 CRM 또는 메시징 호출을 하지 마십시오.
External ID
와 상관 관계 모든 관련 이벤트는 카드를 생성하거나 스캔할 때 사용한 External ID 및 선택적 External Source를 전달할 수 있습니다. 이 쌍을 사용하여 이름이나 이메일을 추측하지 않고도 자신의 CRM, POS 또는 주문 기록을 업데이트할 수 있습니다.
Make 전달 멱등성
부작용을 유발하기 전에 내구성 있는 처리 키 또는 이벤트 지문을 저장합니다. 수신자가 동일한 배송을 다시 보게 되면 중복된 CRM 메모, 바우처 또는 메시지를 추가해서는 안 됩니다. 엔드포인트 URL를 비밀로 처리하십시오.
이벤트 페이로드 형태의 예
이를 자동화 단계에 복사하십시오.
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"
}웹훅 구성 및 테스트
백엔드, CRM 통합 계층, Make 웹훅 또는 Zapier Catch Hook에서 HTTPS 엔드포인트를 생성합니다. Make URL를 복사하기 전에 대상을 제어해야 합니다.
7stamp Admin에서 Stamp Cards → API & Integrations → Webhooks를 여십시오.
엔드포인트 URL를 추가하고 수신 작업 흐름에 실제로 필요한 이벤트 유형만 선택하십시오.
프로필 설정을 저장한 다음 일회용 테스트 스캔 또는 카드 작업을 트리거하여 이벤트를 생성합니다.
수신된 페이로드를 검사합니다. External ID 및 External Source를 예상 레코드와 일치시키고 수신자가 성공적인 응답을 반환하는지 확인합니다.
재생 안전 처리 및 실패 모니터링을 수행한 후에만 CRM, 바우처 또는 메시징 부작용을 활성화하십시오.
코드 없음 옵션: Make 및 Zapier
Make에서 Webhooks → Custom webhook를 사용하여 수신 URL를 생성하고 이를 7stamp 프로필에 붙여넣습니다. Zapier에서는 동일한 목적으로 Webhooks by Zapier → Catch Hook를 사용하십시오. 현재 API는 자동 웹후크 등록 끝점을 노출하지 않기 때문에 7stamp 프로필은 구독을 소유합니다.
보안 및 전달 계약
공개 OpenAPI 참조의 Webhooks 섹션을 현재 페이로드 스키마 및 필드 의미의 소스로 사용하십시오. HTTPS가 필요하고, 수신자 URL를 공용 로그에서 제외하고, 처리를 멱등성으로 만듭니다. 프로덕션에서 특정 헤더 이름이나 재시도 정책을 시행하기 전에 온보딩 중에 7stamp 프로필에 대한 요청 인증/signature 절차를 확인하세요.
자주 묻는 질문
특정 웹훅 이벤트만 선택할 수 있나요?
예. 7stamp 프로필의 웹후크 설정에서 이벤트 유형을 선택하면 수신자가 워크플로에 중요한 이벤트만 받을 수 있습니다.
웹후크를 Make 또는 Zapier에 어떻게 연결합니까?
Make 또는 Zapier의 Catch Hook에서 수신 웹훅을 생성하고 생성된 URL를 복사한 다음 이를 7stamp 프로필의 웹훅 설정에 붙여넣고 테스트 이벤트를 보냅니다.
이벤트를 CRM 연락처와 어떻게 일치시켜야 합니까?
External ID 및 External Source(있는 경우)를 사용하십시오. 이는 카드가 생성되거나 스캔될 때 통합에서 제공한 식별자입니다.
서명 헤더를 가정해야 합니까, 아니면 재시도 타이밍을 가정해야 합니까?
아니요. 헤더를 하드 코딩하거나 재시도 가정을 하기 전에 현재 OpenAPI/profile 배달 계약을 사용하고 온보딩 중에 프로필에 대한 인증 절차를 확인하세요.
다음 단계
첫 번째 카드 이벤트를 보낼 준비가 되셨나요?
수신기를 생성하고, 해당 HTTPS URL를 프로필에 붙여넣고, 일회용 스캔을 실행하고, 다운스트림 자동화를 활성화하기 전에 일치하는 External ID를 검증합니다.