📢 그루비 신규 기능 업데이트: API 트리거 발송
그루비가 API 트리거 발송 기능을 새롭게 선보입니다! 이제 고객사 내부 서버에서 특정 이벤트 발생 시 API 요청으로 적절한 시점에 고객에게 맞춤형 메시지를 자동 발송할 수 있습니다. 🎯
✅ API 트리거 발송이란?
API 트리거 발송은 고객사의 서버에서 특정 이벤트가 발생했을 때 API 요청을 통해 그루비가 메시지를 발송하는 기능입니다. 이를 통해 그루비에서 알 수 없는 내부 정보가 변경된 시점에도 원하는 메시지를 적시에 고객에게 전달할 수 있습니다.
특징
- 그루비 어드민에서 메시지 설정
- API 요청 시점에 요청한 데이터를 메시지에 적용하여 발송 (개인화 메시지 등)
- 발송 결과는 그루비 어드민에서 실시간 확인 가능
📌 활용 예시
- 쿠폰 유효기간 임박 알림
- 품절 상품 재입고 알림
- 배송 상태 알림 메시지
🔧 API 트리거 캠페인 준비하기
📍 고객사 담당님의 역할
1️⃣ API 트리거 캠페인 시나리오 구성
- 메시지 요청 시점, 요청 대상, 메시지 개인화 데이터를 정의하고 고객사 내부 개발자와 협의합니다.
- 개인화 메시지를 위한 변수명(key)과 개인화 데이터(value)를 사전에 약속합니다. (최대 10개까지 설정 가능)
| 예시: 배송 완료 상태 알림을 위한 데이터 정의 campaignKey : {그루비 어드민에서 생성한 캠페인 키를 보내주세요.} memberid : {배송이 완료 상태가 된 멤버를 보내주세요.} productName : {배송 완료 상품명을 보내주세요.} deliveryTime : {배송 완료 일시를 보내주세요} |
2️⃣ 그루비 어드민에서 캠페인 생성 및 진행 상태 설정
- 푸시 알림 캠페인 > API 트리거 발송을 선택하여 푸시 알림 캠페인을 만듭니다.
- 캠페인을 만든 후 캠페인 리스트에서 캠페인을 진행 상태로 변경한 후 개발자에게 발송을 요청합니다.
- 캠페인 리스트에서 코드 샘플을 복사하여 참고용으로 개발자에게 전달할 수 있습니다.
3️⃣ 발송 후 캠페인 리포트 확인
- 발송 결과는 어드민에서 실시간으로 확인할 수 있습니다.
📍 고객사 개발자의 역할
| 1️⃣ API 사용을 위해 API Key 권한을 설정합니다. | – API를 사용하기 위해서는 요구되는 권한이 API Key에 설정되어 있어야 합니다. |
| 2️⃣ API 요청 주소를 확인해 주세요. | – API 요청 주소https://api.groobee.io/messages/push/trigger |
| 3️⃣ 발송 요청 | – 그루비 어드민 사용자에게 전달받은 캠페인 키와 함께 데이터를 설정한 후 발송을 요청합니다. – 1회 요청 시 최대 100건까지 호출할 수 있으며, 테스트 발송 후 실제 발송을 권장합니다. |
- 도움말: API 트리거 발송 캠페인 만들기
- 개발가 가이드 문서: 푸시 알림 캠페인 API 트리거 발송
❓ FAQ (자주 묻는 질문)
Q1. 푸시 메시지 제목과 내용을 API로 직접 전달하는 방식이 더 간단하지 않을까요?
A1. 그루비는 개인화 데이터만 API로 전달하고, 메시지 작성은 그루비 어드민 사용자(마케터)가 직접 관리할 수 있는 구조를 제안합니다. 이 방식으로 개발자의 도움 없이 고정 문구, 이모티콘, 수신 거부 표기 등을 자유롭게 수정할 수 있어 더 유연하게 메시지를 운영할 수 있습니다.
Q2. 그루비 어드민에서 메시지 설정은 어떻게 하나요?
A2. 푸시 알림 캠페인 > API 트리거 발송에서 캠페인명을 설정하고, 개인화 변수와 메시지 내용을 입력한 후 진행 상태로 전환하면 됩니다. 캠페인 저장 후 캠페인 키와 발송 대상 및 개인화 변수를 개발자와 공유하시면 됩니다!
🍪 아 맞다! 그루비 애자일팀 중의 하나인 Pursuit에서 사용성 개선을 위해 오프사이트 캠페인 ‘예상 타겟 수’ 측정 속도를 무려 70% 이상 더 빠르게 수정하여 배포했습니다! 지금 확인해 보세요!
