Main API알리고 API
POST /ai/aligo/send
알림톡 발송
알림톡 발송
캠페인 진행 단계별 카카오톡 알림톡을 발송합니다.
| 항목 | 값 |
|---|---|
| 메서드 | POST |
| 경로 | /ai/aligo/send |
| 인증 | 필요 |
| Content-Type | application/json |
요청
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)
"발송 완료"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]
}'