코드 없는 자동화 가이드

7stamp를 Zapier에 연결 - 단계별

구현 가이드

워크플로가 명확한 순서인 경우 Zapier를 사용합니다. 연락처 또는 주문이 나타나고 7stamp가 작업을 수행한 다음 다른 비즈니스 도구가 업데이트됩니다. 현재 보안 경로는 나가는 7stamp API 호출의 경우 Zapier에 의한 API이고 들어오는 7stamp 이벤트의 경우 Webhooks by Zapier → Catch Hook입니다.

Zapier 마켓플레이스에는 공개 7stamp 앱이 없습니다. 가능한 경우 API by Zapier → API Request를 사용하세요. 정적 API 키를 Zap 단계에서 노출하는 대신 앱 연결에 저장합니다. 수신 Catch Hook 이벤트에만 Webhooks by Zapier를 사용하십시오. 7stamp Bearer 키를 보이는 Webhooks 작업 필드에 넣지 마십시오.

Open Zapier Open API 참조

선형적이고 테스트 가능한 Zap으로 시작

첫 번째 Zap을 작게 유지하세요. 안정적인 접촉-카드 또는 유료 주문-우표 흐름은 광범위한 양방향 CRM 동기화보다 더 나은 출발점입니다.

CRM 연락처에서 초대 만들기

신규 또는 적격 연락처에서 트리거하고 해당 CRM ID를 External ID에 매핑하고 카드 초대를 만든 다음 반환된 설치 URL를 이메일 또는 SMS 단계에 전달합니다.

체크아웃 후 스탬프 추가

지불 주문 또는 마감 영수증에서 트리거하고 고객 신원을 매핑하고 ID를 주문한 다음 주문 금액 또는 명시적인 스탬프 수와 함께 Scan Card를 사용합니다.

일회성 복구 바우처 발행

CRM 규칙, 지원 이벤트 또는 세그먼트 내보내기를 사용하여 고객을 식별하고 카드에 바우처를 발행하며 올바른 채널에서 후속 메시지를 보냅니다.

카드 이벤트를 CRM에 다시 기록합니다.

Webhooks by Zapier > Catch Hook를 사용하여 7stamp 카드 이벤트를 수신합니다. 반환된 External ID를 CRM 레코드와 일치시키고 관련 메모, 태그 또는 작업을 추가합니다.

7stamp 작업을 읽어 Zapier

를 통해 7stamp API에서 호출합니다. 트리거 뒤에 API by Zapier → API Request를 추가합니다. 하나의 7stamp API 키 연결을 만든 다음 아래에서 정확한 방법과 전체 URL를 선택하세요. 각 작업은 다음 Zap 단계에 매핑할 수 있는 필드를 반환합니다.

API 생성 POST /cards/invite

Create Card Invite

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

Required
external_id.
다음 단계
install_url를 이메일, SMS 또는 CRM 필드에 매핑합니다.
API by Zapier 작업 POST /cards/invite/bulk

대량 Card Invite 생성

제어된 JSON 배치에서 최대 100개의 초대 링크를 생성합니다.

1~100개의 초대 개체가 포함된 필수
항목 배열입니다.
Check
확인 배송 전에 success_count, error_count 및 모든 결과를 읽어보세요.
API by Zapier 작업 POST /cards/scan

Scan Card

금액, 스탬프 수, 주문 ID 및 선택적 영수증 데이터와 함께 User Card ID 또는 External ID별로 스탬프를 추가합니다.

ID
external_id 및 선택적 external_source; 둘 다 존재하는 경우 user_card_id가 승리합니다.
스탬프 규칙
stamps_count는 금액보다 우선순위를 갖습니다.
API by Zapier 조치 POST /vouchers/issue

Issue Voucher

카드 소유자에게 직접 바우처를 발행합니다.

필수
바우처.short_description 및 대상 external_id 또는 알려진 user_card_id.
결과
unique_code, 상태 또는 expires_at를 CRM 참고 또는 메시지에 매핑합니다.
API by Zapier 작업 POST /messages/send

Send Message

지갑 카드 푸시 및 /or 이메일 콘텐츠를 카드 소유자에게 보냅니다.

카드 푸시
card_push_text는 20자로 제한됩니다.
이메일
제목과 본문; 결과는 배달이 대기열에 있는지 여부를 보고합니다.
API by Zapier 작업 GET /cards

Find Cards

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

쿼리 매개변수로
external_id가 필요합니다.
먼저
사용 규칙이 중복 초대를 방지하는 경우 초대를 만들기 전에 사용합니다.
API by Zapier 조치 GET /cards/{user_card_id}

카드 세부사항 가져오기

7stamp 내부 ID로 카드 상태를 읽습니다.

필수
{user_card_id}를 7stamp에서 반환된 ID로 바꾸십시오.
유용한 출력
stamps_count, 지갑 상태 및 active_vouchers_count.
API by Zapier 조치 GET /templates

List Templates

연결된 프로파일에 사용 가능한 템플릿을 나열하고 API 연결을 확인합니다.

첫 번째 테스트
쓰기 작업 전에 호출하세요. 고객 데이터는 변경되지 않습니다.
나중에 사용
여러 템플릿이 존재하는 경우 활성 ID는 template_id가 됩니다.
API by Zapier 조치 GET /templates/{template_id}/design

Get Template Design

알려진 템플릿 ID에 대한 템플릿의 디자인 설정을 검색합니다.

Zapier 트리거 Webhooks by Zapier → Catch Hook

카드 이벤트 수신

Catch Hook는 Zapier에 고유한 HTTPS URL를 제공합니다. 7stamp Admin의 웹훅 설정에 붙여넣고 실제 카드 이벤트로 테스트해보세요.

Zapier
구문 분석된 이벤트 데이터에 대해 Catch Hook를 사용하십시오. 원시 요청 헤더도 필요한 경우에만 Catch Raw Hook를 사용하십시오./body.
일치
이벤트에서 external_id 및 선택적 external_source를 사용하여 CRM 연락처를 찾으십시오.

단계별로 구축할 수 있는 세 가지 Zapier 워크플로

각 시나리오는 현재 사용 가능한 실제 Zapier 모듈을 사용합니다. 먼저 하나의 작은 경로를 구축하고 Zap을 켜기 전에 일회용 접점으로 테스트하십시오.

1. 적격한 CRM 연락 → 카드 발급

예상 결과: 다음 Zap 단계에서는 install_url를 수신하여 이를 고객에게 보내거나 CRM 레코드에 다시 쓸 수 있습니다.

  1. 1 Zap을 생성하고 연락처가 로열티 대상임을 의미하는 CRM 이벤트를 선택합니다. 트리거를 테스트하고 연락처의 불변 ID가 있는지 확인하세요.
  2. 2 API by Zapier → API Request를 추가합니다. 7stamp API 키 연결을 생성하거나 선택하고 POST를 선택한 다음 URL를 https://api.7loc.com/cards-api/cards/invite.로 설정합니다.
  3. 3 본문을 JSON로 설정합니다. CRM ID를 external_id에 매핑하고 kommo와 같은 고정 external_source를 설정하고 둘 이상의 7stamp 템플릿이 활성화된 경우에만 template_id를 추가합니다.
  4. 4 작업을 테스트합니다. 응답에 동일한 external_id에 대한 install_url 및 delivery_insert_code가 포함되어 있는지 확인하십시오.
  5. 5 CRM 업데이트, 이메일 또는 SMS 조치를 추가하십시오. API 응답에서 install_url를 매핑합니다. 테스트 URL를 하드 코딩하거나 복사하지 마십시오.

Check: Create Card Invite는 항상 새로운 초대를 반환합니다. 정책이 연락처당 하나의 초대인 경우 Find Cards 요청 또는 Zapier 필터를 먼저 추가하십시오.

2. 유료 주문 → 수상 스탬프

예상 결과: 주문은 추적 가능한 7stamp 스캔을 생성하고 Zap은 소스 시스템에 stamps_added 또는 scan_id를 기록할 수 있습니다.

  1. 1 유료 주문/Closed 영수증 트리거를 사용하여 테스트합니다. 계속하기 전에 고객 ID 및 고유 주문 ID가 모두 존재하는지 확인하십시오.
  2. 2 POST https://api.7loc.com/cards-api/cards/scan와 함께 API by Zapier → API Request를 추가하고 동일한 7stamp 연결을 선택하십시오.
  3. 3 external_id, external_source, external_order_id와 함께 JSON를 보내고 금액 기반 템플릿의 경우 금액을 보내거나 명시적 우표 보상의 경우 stamps_count를 보내세요.
  4. 4 일회용 주문으로 테스트해 보세요. 응답에서 성공, scan_id 및 stamps_added를 검사하십시오.
  5. 5 성공적인 응답 후에만 계속되는 필터를 추가한 다음 확인된 결과로 order/CRM를 업데이트합니다.

Check: Zap이 재생되는 경우 다른 스캔을 보내기 전에 원래 순서를 확인하세요. 나중에 이벤트를 조정할 수 있도록 external_order_id를 안정적으로 유지하십시오.

3. 7stamp 이벤트 → CRM 메모 또는 작업 만들기

예상 결과: Zapier는 구문 분석된 7stamp 이벤트를 수신하고 external_id로 고객을 찾아 적절한 후속 조치를 생성합니다.

  1. 1 Webhooks by Zapier를 트리거로 사용하여 새 Zap을 생성합니다. Catch Hook를 선택하고 계속하여 테스트 단계에 표시된 고유 URL를 복사하십시오.
  2. 2 7stamp Admin에서 API & Integrations → Webhooks를 열고 Catch Hook URL를 추가한 후 필요한 이벤트 유형만 선택하고 저장합니다.
  3. 3 실제 테스트 스캔 또는 카드 이벤트를 발생시킵니다. Zapier로 돌아가서 Test trigger를 클릭하고 event_type, external_id 및 external_source가 샘플 필드로 도착하는지 확인하십시오.
  4. 4 external_id를 사용하여 CRM 연락처 찾기 조치를 추가합니다. event_type에 대한 필터 또는 경로 규칙을 추가합니다(예: SCAN를 REWARD_EARNED에서 분리).
  5. 5 CRM note/task를 생성하고 scanned_at, stamps_after, external_order_id 또는 issued_vouchers와 같이 해당 이벤트에 대해 존재하는 필드만 매핑합니다.

Check: A Catch Hook URL는 비밀입니다. Zap이 다른 소유자에게 양도된 경우 이를 사용하기 전에 7stamp Admin에서 URL를 업데이트하십시오.

Zap

These are the 7stamp-side steps. Do this once, then use the key only inside the API by Zapier connection—not in a Webhooks by Zapier action field or a note.

7stamp Admin Add API Key 작업이 포함된 API 및 통합 화면
API 및 통합을 열고 API Keys를 선택한 다음 계정 설정에서 허용하는 Zap에 대한 별도의 키를 만듭니다.
새로 생성된 7stamp API 키 복사 준비 완료
일반 텍스트 Webhooks 단계나 공유 문서가 아닌 Zapier 연결을 통해 보안 API에 키를 복사합니다.

데이터 불일치를 방지하는 연결 규칙

Zapier 연결을 통해 API에 API 키를 유지합니다.

7stamp Admin에서 API & Integrations → API Keys → Add API Key를 선택합니다. Zapier에 의한 API에서 Bearer 뒤에 해당 키가 포함된 정적 Authorization 헤더를 사용하여 API 키 연결을 만듭니다. Zapier의 API는 눈에 보이는 Zap 단계 대신 연결에서 자격 증명을 유지합니다. 연결에 대한 액세스를 제한하고 키가 노출된 경우 키를 회전하세요.

맵 External ID 및 External Source는 일관되게

External ID는 안정적인 고객 식별자입니다. External Source는 허브스팟, bitrix24, shopify 또는 포스터와 같이 출처를 표시합니다. 생성, 찾기, 스캔, 바우처 및 웹훅 흐름에 동일한 쌍을 사용합니다.

어떤 카드 식별자가 승리하는지 확인하세요.

카드 대상 작업에서는 User Card ID 또는 External ID를 허용합니다. 둘 다 존재하는 경우 User Card ID가 우선순위를 갖습니다. 신뢰할 수 있는 7stamp 단계에서 반환된 후에만 내부 ID를 사용하십시오. 그렇지 않으면 소스 시스템 External ID를 선호합니다.

Zapier 요청에 의한 정확한 API: 스탬프 1개 부여

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

{
  "external_id": "crm_contact_8821",
  "external_source": "hubspot",
  "stamps_count": 1,
  "external_order_id": "order_2048"
}

첫 번째 Zap 구축

01

관리에서 7stamp API 키 생성: API & Integrations → API Keys → Add API Key. 가능한 경우 별도의 테스트 키/profile를 사용하십시오.

02

Zapier에서 Zap을 생성하고 소스 트리거를 테스트합니다. 실제 샘플을 사용하여 연락처 ID, 고객 ID, 주문 ID 및 금액을 매핑에 사용할 수 있습니다.

03

API by Zapier → API Request를 추가합니다. Webhooks by Zapier 작업 필드에 비밀을 입력하는 대신 정적 Bearer Authorization 헤더에 대한 7stamp 연결을 만듭니다.

04

먼저 GET https://api.7loc.com/cards-api/templates를 호출하십시오. 이를 통해 핵심 작업이 확인되고 고객 데이터를 수정하지 않고도 사용할 수 있는 활성 템플릿 ID가 표시됩니다.

05

POST /cards/invite 또는 POST /cards/scan를 선택하고 JSON를 본문 유형으로 설정한 다음 안정적인 External ID와 트리거의 관련 템플릿/order 필드를 매핑합니다.

06

일회용 연락처로 작업을 실행하고 정확한 응답 필드를 검사한 후 Zap을 게시하기 전에 해당 필드를 다음 CRM, 이메일 또는 메시징 단계에 매핑합니다.

문서화된 경로에 대해서만 범용 요청을 사용하십시오.

Bearer API 키가 있는 7stamp 요청에 대해 Zapier의 API를 사용하십시오. 앱 연결에서 정적 헤더 키를 유지합니다. 7stamp 비밀의 기본 위치가 아닌 Catch Hook 이벤트 전달을 위해 Webhooks by Zapier를 사용하십시오. https://api.7loc.com/cards-api,에서 기본 URL를 유지하고 정확한 스키마에 대해 공개 OpenAPI 참조를 사용하고 인증되지 않은 URL에 자격 증명이나 고객 데이터를 보내지 마십시오.

Catch Hook를 통해 7stamp 이벤트를 수신합니다.

Webhooks by Zapier → Catch Hook를 생성하고 테스트 설정에 표시된 고유한 URL를 복사하여 7stamp 프로필의 웹후크 설정에 붙여넣고 이벤트 유형을 선택한 다음 실제 테스트 스캔 또는 카드 이벤트를 보냅니다. 이벤트 페이로드의 External ID 및 External Source를 사용하여 올바른 CRM 연락처를 찾으십시오. 구문 분석되지 않은 본문과 요청 헤더가 특별히 필요한 경우에만 Catch Raw Hook를 선택하십시오.

이제 보안 Zapier 경로를 사용하십시오.

Zapier 및 Catch Hook에 의한 API는 모든 공개 7stamp API 작업 및 카드 이벤트에 충분합니다. 향후 기본 7stamp Zapier 앱이 필요한 경우 팀에서 가장 많이 사용하는 정확한 action/trigger를 보내주세요.

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

자주 묻는 질문

Zapier에서 7stamp 앱을 어디에서 찾을 수 있습니까?

현재 공개 7stamp 마켓플레이스 앱이 없습니다. 7stamp API 호출에는 API by Zapier → API Request를 사용하고 수신 7stamp 이벤트에는 Webhooks by Zapier → Catch Hook를 사용하십시오.

Zapier 토큰은 어디서 생성합니까?

API & Integrations → API Keys → Add API Key 아래의 관리에서 7stamp API 키를 생성합니다. 표시되는 Webhooks by Zapier 작업 필드가 아닌 Zapier 연결을 통해 API에 정적 Bearer Authorization 헤더로 저장합니다.

Zapier는 어떻게 스탬프나 바우처 이벤트를 받을 수 있나요?

Webhooks by Zapier에서 Catch Hook를 생성하고, 생성된 URL를 7stamp 프로필의 웹훅 설정에 붙여넣고, 이벤트를 선택하고, CRM 업데이트를 활성화하기 전에 테스트 이벤트를 보냅니다.

Zapier 또는 Make를 선택해야 합니까?

대부분 선형적인 트리거-작업 작업흐름을 위해서는 Zapier를 선택하십시오. 라우터, 복잡한 변환 또는 긴 다중 분기 시나리오가 필요한 경우 Make를 선택하십시오. 둘 다 동일한 7stamp API 키와 엔드포인트를 사용합니다.

관련 페이지

Zapier 열기 API by Zapier 도움말 Zapier Catch Hook 도움말 7stamp API 참조 웹훅 설정 Make 가이드

다음 단계

빌드 먼저 테스트 연락처

로 Zap을 수행합니다. API 키를 생성하고 Zapier를 통해 API를 통해 GET /templates를 테스트한 다음 하나의 연락처-카드 또는 주문-스탬프 작업을 구축합니다. 아웃바운드 플로우의 테스트 결과가 입증되면 Catch Hook를 추가하십시오.

7stamp Admin 를 엽니다. API 참조