[Zapier X 아임웹] API 연동으로 아임웹에서 자동 메시지 보내는 방법
이 글에서는 재피어와 에픽의 API 발송 기능을 이용하여 아임웹 쇼핑몰/웹사이트(이하 아임웹 사이트)에서 수집된 고객에게 문자/친구톡/알림톡 메시지를 자동 발송하는 과정을 설명드립니다
Jul 22, 2024
안녕하세요. 에픽입니다.
이 글에서는 재피어와 에픽의 API 발송 기능을 이용하여 아임웹 쇼핑몰/웹사이트(이하 아임웹 사이트)에서 수집된 고객에게 문자/친구톡/알림톡 메시지를 자동 발송하는 과정을 설명드립니다.
재피어(Zapier)는?
- 재피어는 다양한 온라인 서비스간에 자동화된 연동을 도와주는 솔루션입니다. 재피어를 이용하여 ‘구글 스프레드 시트에 새로운 행이 추가되면’ ⇒ ‘에픽으로 문자 발송을 요청해’와 같이 2가지 이상의 서비스를 연동하는 자동화를 설정할 수 있습니다.
아임웹 API는?
- 아임웹 사이트의 고객, 주문 정보를 외부 서비스에서 활용하기 위해 아임웹에서 제공하는 연동 기능입니다. 아임웹이 제공하는 정보에 대한 접근만 제한된 방식으로 가능하기 때문에, 아임웹 관리자 페이지에서 조회할 수 있는 모든 정보를 활용할 수는 없습니다.
[활용 예시]
본 가이드를 활용하여 아래와 같은 케이스에 메시지 발송을 자동화 할 수 있습니다.
- 아임웹 회원 가입 > 가입자에게 환영 메시지 (알림톡, 문자) 발송
- 아임웹 구매 발생 > 구매자에게 안내 메시지 (알림톡, 문자) 발송
- 아임웹 기존 구매자 대상으로 프로모션 메시지 (친구톡, 문자) 발송
사전 준비물
- 에픽 계정
- Zapier 계정
- 아임웹 관리자 계정
아임웹을 연동하는 방법에는 아래의 두가지 방법이 있으며 필요에 맞는 방식을 선택하여 연동할수 있습니다.
- 아임웹 > 재피어 > 에픽API로 연동 : 아임웹 API를 재피어를 통해 주기적으로 호출하고, 필요한 경우 에픽 API로 발송 요청하는 방식입니다. 연동 방식이 비교적 간단하지만, ‘즉시 발송’ 방식만 가능합니다. 고객 액션 후 바로 발송되는 메시지, 또는 주기적으로 반복 발송되는 메시지만 필요한 경우 추천합니다.
- 아임웹 > 재피어 > 빅쿼리(Big Query) > 에픽 DB 연동 : 아임웹 API를 재피어를 통해 주기적으로 호출하고, 수집된 데이터를 빅쿼리에 적재합니다. 에픽을 해당 빅쿼리와 연동하여 메시지를 발송합니다. 에픽의 모든 기능을 사용할 수 있지만, 아임웹 > 재피어 > 빅쿼리로 데이터를 적재시키는 과정이 다소 복잡합니다. 고객 액션 후 지연 발송되는 메시지가 필요한 경우, 고객 세그멘트를 여러 조건을 조합하여 구성하는 것이 필요한 경우 추천합니다.
[1. 아임웹 > 재피어 > 에픽API로 연동]
1. 에픽 자동화 캠페인 생성하기
에픽 콘솔에서 발송하고자 하는 캠페인을 생성하고 설정합니다.
- [홈 대시보드] > [CRM 자동화 캠페인] > [신규 자동화 캠페인 생성하기] 를 선택합니다.
- [자동화 문자], [자동화 알림톡], [자동화 친구톡] 중에 원하는 캠페인 종류를 선택합니다.
- [API 발송]를 발송 시점으로 선택합니다.
- 발송하고자 하는 자동화 메시지를 작성합니다. (* 자세한 설정 방법은 API 발송 가이드를 참고하세요.)
2. 에픽 API 키 확인하기
에픽 API 연동을 위한 계정의 API 키(Key) 정보를 확인합니다.
- [홈 대시보드] > [내 정보] > [API 관리] 를 선택합니다.
- 화면에 표시된 API Key 정보를 확인합니다.
3. 아임웹 API 키 확인하기
- 아임웹(https://imweb.me/)에 로그인합니다.
- 내 사이트(https://imweb.me/mysite)에서 관리 버튼을 눌러 사이트 관리페이지로 이동합니다.
- 환경설정 > 외부 서비스 연동 (API)으로 이동합니다.
- API key 발급받기 버튼을 누릅니다.
- API key와 Secret key 정보를 확인합니다.
3. 재피어에서 새로운 Zap 만들기
- 재피어 웹사이트(https://zapier.com)에 접속하여 로그인합니다.
- 로그인 후, [Create] > [Zaps]를 선택하여 새 Zap을 만듭니다.
4. 재피어 트리거(Trigger) 설정 - Schedule by Zapier
- Trigger 앱 선택: "Schedule by Zapier"를 검색하여 선택합니다.
- Trigger 이벤트 선택: 아임웹 데이터 추출을 위한 주기를 선택합니다.
- 기본 설정으로는 “Every Hour”가 최소 단위이며, 1시간 보다 짧은 주기를 선택하기 위해서는 복수의 재피어를 설정하거나, 추가적인 별도 세팅이 필요합니다.
- 데이터 추출하기 위한 시간을 설정하여 트리거 세팅을 완료합니다.
5. 아임웹에서 엑세스 토큰 받기 - Webhooks by Zapier
- Action 앱 선택: "Webhooks by Zapier"를 검색하여 선택합니다.
- Action 이벤트 선택: "Get를 선택합니다.
- 다음과 같이 Webhooks 설정을 진행합니다:
- Query String Prams
- 아임웹 key와 secret 값을 아래와 같이 입력합니다.
6. 아임웹에서 이벤트 조회하기 - Webhooks by Zapier
- Action 앱 선택: "Webhooks by Zapier"를 검색하여 선택합니다.
- Action 이벤트 선택: "Get를 선택합니다.
- 다음과 같이 Webhooks 설정을 진행합니다.
- URL: 아임웹의 API 리스트 중에 데이터를 수집하고자 하는 URL을 입력합니다.
- Query String Prams : 아임웹 API 문서 기반으로 필요한 파라미터를 입력합니다.
- Headers : 아래와 같이 Header란에 access-token 정보를 입력합니다.
- key : “access-token”
- value = “5. 아임웹에서 엑세스 토큰 받기]에서 조회한 access token”
6. 에픽 API 발송 설정 - Webhooks by Zapier
- Action 앱 선택: "Effic(에픽)" 앱을 선택합니다. (링크 : ‣)
- Action 이벤트 선택: Send Message를 선택합니다.
- 다음과 같이 설정을 진행합니다.
- Effic API Key: [2. 에픽 API 키 확인하기]에서 확인한 키를 입력합니다.
- Title: 발송하고자 하는 캠페인의 제목을 입력합니다.
- ID: 캠페인의 ID를 입력합니다. (Title과 ID 중 하나만 입력하여도 동작합니다. 중복 입력시 title이 우선하여 적용됩니다.)
- Receiver number: 수신번호를 가져온 정보로 입력합니다.
- Variables: 메시지 내에 #{name}과 같은 변수를 사용한경우, 해당 변수에 매칭될 변수 값을 가져온 정보로 입력합니다. (key=변수명, value=
- Block start time/Block end time: 야간 발송 제한을 위해 발송 금지 시작 시간과 종료 시간을 설정합니다.
8. Zap 테스트 및 활성화
- 설정이 완료되면 "Test & Continue" 버튼을 눌러 설정한 Zap이 제대로 동작하는지 테스트합니다.
- 테스트가 성공하면, "Publish" 버튼을 눌러 Zap을 활성화합니다.
[2. 아임웹 > 재피어 > 빅쿼리(Big Query) > 에픽 DB 연동]
- 해당 방법은 아임웹 API를 통해 데이터를 조회하는 방식은 1.과 동일하나, 해당 데이터로 에픽 API를 호출하는 대신 빅쿼리에 저장하는 프로세스입니다.
- Big Query 테이블 세팅 등 다소 복잡한 1회성 사전작업이 필요하여, 해당 방식의 경우 에픽팀과의 협력을 통한 세팅을 추천합니다.
- 재피어 세팅의 예시는 아래와 같습니다.
이 과정을 통해 아임웹 API에서 조회 가능한 데이터를 사용하여 메시지 발송을 자동화할 수 있습니다.
에픽 사용과 관련하여 궁금한 점이 있으면 언제든 문의 남겨 주세요!
Share article
Subscribe to our newsletter