코드 없는 자동화 가이드

7stamp를 Make에 연결 — 단계별

구현 가이드

Make를 사용하여 7stamp를 CRM, POS, 온라인 상점, 스프레드시트, 메시징 도구 또는 시나리오에 데이터를 보낼 수 있는 모든 시스템과 연결합니다. 현재 생산 준비가 완료된 경로는 7stamp API 호출을 위한 Make의 HTTP 앱과 수신 7stamp 이벤트를 위한 Make의 Custom webhook입니다.

Make의 앱 선택기에 공개 7stamp 앱이 아직 없습니다. 기다리지 마십시오. HTTP → Make a request를 추가하고 정확한 URL, 메소드, Bearer 헤더 및 JSON를 사용한 다음 소스 모듈에서 필드를 맵핑하십시오. 이는 향후 커넥터에서 사용할 것과 동일한 7stamp Integration API입니다.

Open Make Open API 참조

워크플로와 일치하는 첫 번째 시나리오 선택

하나의 사건과 하나의 결과로 시작하세요. 테스트 데이터가 올바르면 필터, 라우터, CRM 업데이트 및 후속 메시지를 추가하세요.

새 CRM 연락처

후 카드 생성 CRM 연락처 ID를 External ID로 사용하고 7stamp 카드 초대를 만든 다음 일반적인 이메일, SMS 또는 메시징 단계를 통해 반환된 설치 URL를 보냅니다.

유료 주문 후 스탬프 추가

유료 POS 또는 전자상거래 주문에서 시나리오를 트리거합니다. 안정적인 고객 ID를 매핑하고 ID를 카드 스캔으로 주문한 다음 금액이나 명시적인 우표 수를 사용하세요.

보상 후속 조치

보내기 카드 이벤트에서 보상이나 바우처를 보고하면 시나리오를 분기합니다. CRM를 업데이트하고 팀에 알리고 필요할 때만 지갑 카드 푸시 또는 이메일을 보냅니다.

기본 Make 앱 없이 시스템을 처리합니다.

Make의 HTTP 모듈을 사용하여 7stamp를 직접 호출합니다. 이는 맞춤형 POS, ERP, 예약 엔진 또는 모든 API 우선 서비스를 위한 보편적인 선택입니다.

7stamp 작업을 Make에서 호출 HTTP

아래의 각 카드에 대해 HTTP → Make a request를 추가한 다음 표시된 대로 메소드와 URL를 정확하게 설정하십시오. 모든 요청에 ​​동일한 Bearer 키를 사용하십시오. 필수 매핑은 CRM, POS 또는 전자상거래 트리거에서 무엇을 제공할지 알려줍니다.

Make 트리거 Webhooks → Custom webhook

카드 이벤트 수신

Make에서 Custom webhook를 생성하고 해당 URL를 복사한 다음 해당 URL를 7stamp 프로필 웹후크 설정에 붙여넣습니다. 이는 7stamp가 SCAN, REWARD_EARNED 또는 VOUCHER_ISSUED와 같은 이벤트를 보낼 때 시나리오를 시작합니다.

Make
Webhooks → Custom webhook → 추가; 명확한 이름을 지정하고 생성된 URL를 복사하세요.
7stamp
관리 → API & Integrations → Webhooks; URL를 붙여넣고 이벤트 유형을 선택한 다음 저장하고 테스트 이벤트를 생성합니다.
HTTP 작업 POST /cards/invite

Card Invite 생성

새로운 개인 설치 URL 및 하나의 외부 연락처에 대한 전달 삽입 코드를 생성합니다.

필수
external_id — 이름이 아닌 안정적인 CRM/contact ID를 매핑합니다.
Then use
맵 install_url를 사용하십시오.
HTTP 조치 POST /cards/invite/bulk

대량 Card Invite 생성

한 요청에 최대 100개의 초대 링크를 생성합니다. 무제한 연락처 내보내기가 아닌 제어된 마이그레이션 또는 캠페인에 사용하세요.

필수
항목 — 1~100개의 개별 초대 요청 개체로 구성된 JSON 배열입니다.
Check
확인 링크를 보내기 전에 success_count, error_count 및 각 결과를 읽으십시오.
HTTP 작업 GET /cards

Find Cards

선택적 템플릿 및 소스 필터를 사용하여 External ID별로 카드 레코드를 찾습니다.

필수
조회 매개변수 external_id.
옵션
external_source 및 template_id는 한 시스템에 여러 프로그램이 있는 경우 검색 범위를 좁힙니다.
HTTP 조치 GET /cards/{user_card_id}

카드 세부정보 가져오기

이전 단계에서 내부 User Card ID를 반환한 경우 한 카드의 전체 상태를 읽습니다.

필수
{user_card_id}를 신뢰할 수 있는 7stamp 응답에서 반환된 내부 ID로 바꾸십시오.
Avoid
를 피하십시오. 다른 프로필의 ID 카드를 추측하거나 저장하지 마십시오.
HTTP 작업 POST /cards/scan

카드 스캔

구매 금액 또는 명시적 개수에서 스탬프를 추가합니다. User Card ID 또는 External ID를 허용하고 외부 주문 참조를 유지할 수 있습니다.

ID
external_id 및 선택적 external_source를 사용하십시오. 둘 다 제공되면 user_card_id가 승리합니다.
구매
금액 기반 카드의 경우 금액을 사용하고 명시적인 숫자의 경우 stamps_count를 사용합니다. stamps_count가 우선순위를 갖습니다.
추적성
7stamp 이벤트를 다시 일치시킬 수 있도록 유료 주문/receipt에서 external_order_id를 매핑합니다.
HTTP 조치 GET /templates

List Templates

API 키에 사용 가능한 카드 템플릿을 나열합니다. 이를 사용하여 연결을 테스트하거나 템플릿을 동적으로 선택합니다.

첫 번째 테스트
가장 안전한 첫 번째 요청입니다. 본문이 없으며 고객 데이터를 변경하지 않습니다.
나중에 매핑
프로필에 둘 이상의 활성 템플릿이 있는 경우에만 활성 템플릿의 ID를 template_id로 사용합니다.
HTTP 작업 GET /templates/{template_id}/design

Get Template Design

알려진 템플릿에 대한 시각적 디자인 설정을 반환합니다. 이는 다른 시스템이 일관된 카드 선택을 표시해야 할 때 유용합니다.

HTTP 조치 POST /vouchers/issue

바우처 발행

External ID 또는 User Card ID로 식별된 카드 소유자에게 바우처를 발행합니다.

Required
바우처가 필요합니다.short_description. external_id 또는 알려진 user_card_id를 사용하여 카드를 대상으로 합니다.
유효성
validity_value와 함께 validity_type를 사용하거나 고정 만료 날짜에 대한 OpenAPI 참조를 읽으십시오.
HTTP 작업 POST /messages/send

메시지 보내기

구성된 채널 및 동의 규칙에 따라 지갑 카드 푸시 및 /or 이메일을 통해 카드 소유자에게 콘텐츠를 보냅니다.

카드 푸시
card_push_text는 20자로 제한되며 지갑 패스가 설치되어 있어야 합니다.
이메일
제목과 본문을 보냅니다. 기본 HTML는 본문에서 지원됩니다.
Make 모듈 Full 7stamp endpoint URL

HTTP → Make a request

이는 위의 모든 7stamp 경로를 호출하는 Make 모듈입니다. 완전한 URL를 사용하고, 문서화된 방법을 선택하고, Bearer 헤더를 추가하고, 경로에 본체가 필요한 경우에만 JSON를 사용하십시오.

기본 URL
https://api.7loc.com/cards-api
헤더
Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: POST 요청의 경우 application/json입니다.

작성된 대로 정확하게 구축할 수 있는 세 가지 Make 시나리오

아래 이름은 실제 Make 모듈입니다. 첫 번째 시나리오부터 시작하여 일회용 연락처에 대해 실행한 다음 라우터, 필터 또는 생산 일정을 추가합니다.

1. 새 CRM 연락처 → 7stamp 카드 링크 보내기

예상 결과: 고객은 7stamp에서 반환된 install_url를 받습니다. CRM는 해당 URL를 동일한 연락처 기록에 유지할 수 있습니다.

  1. 1 시나리오를 작성하고 CRM의 New/Created 접촉 트리거를 추가하십시오. Kommo의 경우 연락처 생성 트리거를 선택하고 한 번 실행하여 샘플 연락처를 로드합니다.
  2. 2 HTTP → Make a request를 추가합니다. 메소드를 POST로 설정하고 URL를 https://api.7loc.com/cards-api/cards/invite.
  3. 3 로 설정합니다. Authorization: Bearer YOUR_7STAMP_API_KEY 및 Content-Type: application/json를 추가합니다. JSON 본문에서 CRM 연락처 ID를 external_id에 매핑하고 external_source를 kommo와 같은 고정 레이블로 설정합니다.
  4. 4 HTTP 모듈을 한 번 실행하십시오. 출력에 install_url, delivery_insert_code, external_id 및 template_id가 있는지 확인하십시오.
  5. 5 HTTP 뒤에 email/SMS/CRM 업데이트 모듈을 추가하고 HTTP 출력에서 ​​install_url를 매핑합니다. 팀이 나중에 다시 보내야 하는 경우 CRM 연락처에 URL를 저장하세요.

Check: POST /cards/invite는 항상 새로운 초대를 생성합니다. 비즈니스 규칙이 기존 연락처에 대한 다른 초대를 피하는 것이라면 먼저 Find Cards를 사용하십시오.

2. 유료 주문 → 로열티 스탬프 추가

예상 결과: 성공적인 스캔 응답에는 성공, scan_id, stamps_added 및 다음 단계에 대한 스캔 후 카드 상태가 포함됩니다.

  1. 1 POS/ecommerce 유료 주문 트리거에서 시작합니다. Make는 해당 샘플에 안정적인 고객 ID 및 주문/receipt ID가 포함되어 있는지 확인합니다.
  2. 2 POST https://api.7loc.com/cards-api/cards/scan 및 동일한 Bearer 헤더를 사용하여 HTTP → Make a request를 추가합니다.
  3. 3 는 고객의 external_id, 시스템 이름의 external_source, ID 주문의 external_order_id를 매핑합니다. 금액 기반 카드의 경우 금액을 추가하거나 명시적인 스탬프 수의 경우 stamps_count를 추가하세요.
  4. 4 Run once(테스트 주문 포함) 시나리오 일정을 활성화하기 전에 반환된 성공 플래그와 stamps_added를 확인하세요.
  5. 5 선택적으로 HTTP 단계 뒤에 필터를 추가합니다. 성공이 true인 경우에만 계속한 다음 scan_id 또는 stamps_added를 order/CRM 레코드에 다시 씁니다.

Check: 재시도 시 동일한 external_order_id를 사용하면 나중에 웹훅 이벤트에서 순서를 추적할 수 있습니다. 불분명한 실패 후에 우표를 두 번 수여하지 마십시오.

3. 7stamp 이벤트 → CRM 업데이트

예상 결과: Make는 7stamp 이벤트를 즉시 수신하고 external_id 및 external_source를 통해 일치하는 CRM 레코드를 찾을 수 있습니다.

  1. 1 별도의 Make 시나리오를 작성하십시오. Webhooks → Custom webhook를 추가하고 추가를 선택한 후 이름을 7stamp-card-events로 지정하고 생성된 URL를 복사합니다.
  2. 2 7stamp Admin에서 API & Integrations → Webhooks를 여십시오. 해당 URL를 추가하고 작은 이벤트 세트(예: SCAN 및 REWARD_EARNED)를 선택하십시오.
  3. 3 7stamp에서 일회용 테스트 스캔 또는 카드 이벤트를 생성합니다. Make로 돌아가서 Run once를 사용하여 Make가 이벤트 데이터 구조를 결정하도록 하십시오.
  4. 4 external_id를 사용하여 CRM 검색 단계를 추가합니다. SCAN, REWARD_EARNED 및 VOUCHER_ISSUED가 다른 조치를 취할 수 있도록 event_type에 필터 또는 라우터를 추가하십시오.
  5. 5 CRM update/note 조치를 추가하십시오. 선택한 이벤트 유형에 해당 필드가 있는 경우에만 scanned_at, stamps_after, external_order_id 및 issued_vouchers를 매핑하십시오.

Check: 웹훅 URL를 비공개로 유지하세요. 되돌릴 수 없는 메시지, 바우처 또는 CRM 변경 사항을 켜기 전에 실제 이벤트를 테스트하세요.

Make를 열기 전에 7stamp API 키를 가져옵니다.

이는 정확한 7stamp Admin 화면입니다. 키를 한 번 생성하고 Make의 보안 HTTP 연결/keychain에 복사한 다음 즉시 클립보드에서 제거하십시오.

7stamp Admin API Keys 목록 및 Add API Key 제어가 포함된 API 및 통합 화면
7stamp Admin에서 API 및 통합을 연 다음 API Keys를 열고 Add API Key를 선택하십시오.
복사 제어가 표시되는 새로운 7stamp API 키 대화 상자
보안 Make HTTP 연결에만 키를 복사합니다./keychain. 비밀번호처럼 취급하고 노출된 경우 교체합니다.

Prepare the connection before building

를 구축하기 전에 연결을 준비하십시오. 환경당 하나의 API 키를 생성하십시오.

7stamp Admin에서 API & Integrations → API Keys → Add API Key로 이동하십시오. 해당 옵션을 사용할 수 있는 경우 Make의 HTTP API 키 연결/keychain에 값을 저장하십시오. 절대로 텍스트 필드의 키를 매핑하거나, 메모에 넣거나, 브라우저에 표시되는 작업 흐름에서 사용하지 마세요. 키는 하나의 7stamp 작업장에 속합니다/profile.

안정적인 External ID

를 사용합니다. CRM, POS 또는 상거래 플랫폼에서 불변 ID를 매핑합니다. 예를 들어 CRM는 ID에 문의하거나 고객 UUID입니다. 동일한 식별자가 둘 이상의 시스템에 나타날 수 있는 경우 Hubspot, Shopify 또는 Poster와 같은 External Source를 추가하십시오.

어떤 템플릿을 적용할지 결정합니다.

연결된 7stamp 프로필에 활성 카드 템플릿이 하나 있으면 템플릿을 비워 둘 수 있습니다. 여러 템플릿을 사용하여 template_id를 의도적으로 매핑하거나 선택하면 모든 초대와 스캔이 의도한 로열티 프로그램에 도달할 수 있습니다.

정확한 Make HTTP 설정: 하나의 카드 만들기

이를 자동화 단계에 복사하십시오. http 
Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
  Authorization: Bearer YOUR_7STAMP_API_KEY
  Content-Type: application/json
Body type: Raw / JSON

{
  "external_id": "crm_contact_8821",
  "external_source": "hubspot",
  "template_id": 42
}

초대 첫 번째 Make 시나리오 빌드 및 테스트

01

7stamp Admin에서 API & Integrations → API Keys → Add API Key에 키를 만듭니다. 계정 설정에서 허용하는 경우 별도의 테스트 프로필/key를 사용하십시오.

02

Make에서 시나리오를 생성하고 소스 트리거를 추가합니다. 매핑 전 한 번 실행해보시면 실제 샘플 문의나 결제 주문을 보실 수 있습니다.

03

다음 더하기 기호를 클릭하고 HTTP를 검색한 후 Make 요청을 선택하십시오. 이 페이지의 작업 카드에서 메소드, 전체 URL 및 헤더를 설정하십시오.

04

GET https://api.7loc.com/cards-api/templates를 첫 번째 요청으로 사용하십시오. 성공적인 응답은 고객 데이터를 변경하지 않고도 핵심이 작동한다는 것을 증명합니다.

05

POST 루트의 경우 application/json를 선택하고 이 가이드의 몸체 모양을 붙여넣습니다. 안정적인 External ID를 매핑합니다. 프로파일에 활성 템플릿이 여러 개 있는 경우에만 template_id를 추가하세요.

06

일회용 연락처로 실행하고 HTTP 출력을 검사한 후 정확한 응답 필드를 다음 CRM, 이메일 또는 메시징 모듈에 매핑합니다.

언제 Make HTTP를 사용해야 합니까?

이제 7stamp에 HTTP를 사용하십시오. 이는 감소된 폴백이 아니라 문서화된 프로덕션 준비 경로입니다. 7stamp 작업, 새로운 API 경로 또는 사용자 정의 POS/ERP 연결이 필요할 때마다 선택하세요. OpenAPI 참조는 메소드, 전체 경로, 본문 및 응답 스키마에 대한 정보의 소스입니다. 베어러 키와 기본 URL는 동일하게 유지됩니다.

Make에서 7stamp 이벤트를 수신합니다.

이벤트 기반 시나리오의 경우 Webhooks → Custom webhook를 추가하고 웹후크를 생성합니다. URL를 복사하고, 7stamp 프로필에서 API & Integrations → Webhooks를 열고, URL를 붙여넣고, 이벤트 유형을 선택하고, 저장하고, 실제 테스트 이벤트를 보냅니다. 7stamp 프로필은 해당 구독을 소유합니다. 현재 API는 자동 웹훅 subscribe/unsubscribe 엔드포인트를 노출하지 않습니다.

공용 Make 커넥터가 필요하지 않습니다.

이 페이지의 지침은 모든 Make 계정에서 사용할 수 있는 Make 모듈을 사용합니다. HTTP가 아닌 미래의 기본 7stamp 모듈을 원한다면 필요한 워크플로우를 보내주십시오. 그때까지는 HTTP 및 Custom webhook가 문서화된 모든 7stamp 작업을 다룹니다.

기본 커넥터에 대해 문의하십시오.

자주 묻는 질문

Make에서 7stamp를 찾을 수 없습니다. 그래도 자동화할 수 있나요?

예. 현재 Make에는 공개 7stamp 앱이 없습니다. HTTP > Make 요청을 추가하고 전체 7stamp 엔드포인트 URL를 사용하고 Authorization: Bearer 뒤에 7stamp API 키를 보냅니다. HTTP는 문서화된 모든 엔드포인트를 호출할 수 있습니다.

Make 연결을 위한 토큰은 어디서 얻습니까?

7stamp Admin에서 API Integrations, API Keys, Add API Key를 차례로 엽니다. 키의 범위는 키를 생성한 작업장/profile로 지정되므로 가능하면 테스트 시나리오용 테스트 프로필을 사용하세요.

어떤 식별자를 External ID로 매핑해야 합니까?

소스 시스템의 안정적인 식별자(CRM 연락처 ID 또는 고객 UUID)를 사용하는 것이 좋습니다. 표시 이름을 사용하지 마세요. 전화번호나 이메일은 유효하지만 변경될 수 있으므로 일관되게 처리해야 합니다.

7stamp 이벤트를 Make로 가져오려면 어떻게 해야 합니까?

Make에서 Webhooks > Custom webhook를 생성한 다음 생성된 URL를 7stamp 프로필의 Webhook 설정에 붙여넣습니다. 수신 event_type를 처리하려면 배송 후 Make 필터 또는 라우터를 사용하십시오.

관련 페이지

열기 Make Make HTTP 도움말 Make Custom webhook 도움말 7stamp API 참조 웹훅 설정 Zapier 가이드

다음 단계

준비됨 첫 번째 충성도 작업을 자동화하시겠습니까?

API 키를 생성하고, List Templates를 테스트하고, 일회용 연락처로 하나의 초대 또는 스캔 시나리오를 구축합니다. 간단한 흐름이 안정적인 후에만 라우터와 메시징을 추가하세요.

7stamp Admin 열기 API 참조 읽기