Main API
알리고 API
카카오톡 알림톡 발송 API
알리고 API
알리고를 통한 카카오톡 알림톡 발송 API입니다.
Base URL: /ai/aligo
인증 정보
| 항목 | 값 |
|---|---|
| 인증 필요 | 예 |
| 인증 방식 | JWT Bearer Token |
엔드포인트 목록
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
POST | /ai/aligo/send | 알림톡 발송 | 필요 |
API 상세
알림톡 발송
캠페인 진행 단계별 카카오톡 알림톡을 발송합니다.
HTTP 요청
POST /ai/aligo/send
Authorization: Bearer {access_token}
Content-Type: application/json
Idempotency-Key: {unique-key}요청 헤더
| 헤더 | 필수 | 설명 |
|---|---|---|
Authorization | 예 | JWT 토큰 |
Idempotency-Key | 아니오 | 중복 발송 방지용 고유 키 |
Request Body
{
"templateId": "CREATOR_EXCLUSION_3DAYS_BEFORE",
"collabNo": 123,
"progressItemIds": [1, 2, 3]
}Request Body 스키마 (AligoSendRes)
| 필드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
templateId | string | 예 | 알림톡 템플릿 ID |
collabNo | int | 예 | 캠페인 번호 |
progressItemIds | int[] | 예 | ProgressTable ID 목록 |
응답
성공 응답 (200 OK)
"발송 완료"알림톡 템플릿
| 템플릿 ID | 설명 | 발송 시점 |
|---|---|---|
CREATOR_EXCLUSION_3DAYS_BEFORE | 크리에이터 제외 3일 전 | 제외 예정 3일 전 |
CAMPAIGN_APPLICATION_APPROVED | 캠페인 신청 승인 | 신청 승인 시 |
CONTENT_REVIEW_REQUEST | 콘텐츠 리뷰 요청 | 리뷰 요청 시 |
PAYMENT_COMPLETE | 결제 완료 | 결제 완료 시 |
Idempotency Key
Idempotency-Key 헤더를 사용하면 동일한 요청이 중복 처리되는 것을 방지할 수 있습니다.
같은 Idempotency-Key로 여러 번 요청하면 첫 번째 요청만 처리되고 이후 요청은 첫 번째 요청의 결과를 반환합니다.
사용 예시
curl -X POST https://api.glowb.io/ai/aligo/send \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: unique-key-123" \
-d '{
"templateId": "CAMPAIGN_APPLICATION_APPROVED",
"collabNo": 123,
"progressItemIds": [1, 2, 3]
}'