알림톡 발송

캠페인 진행 단계별 카카오톡 알림톡을 발송합니다.

항목	값
메서드	`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": "UL_8527",
  "collabNo": "1500",
  "applicationIds": [7891, 7892],
  "variables": {
    "제출물명": "스크립트(대본)",
    "디플러스날짜": "D+3",
    "날짜수": "3"
  }
}

Request Body 스키마 (AligoSendRes)

필드명	타입	필수	설명
`templateId`	`string`	예	알림톡 템플릿 ID (예: `UL_8849`)
`collabNo`	`string`	예	캠페인 번호
`applicationIds`	`long[]`	조건부	신청(CampaignApplication) ID 목록. 크리에이터 템플릿에서 값이 있으면 이 경로가 우선하며, 수신 번호는 크리에이터 프로필(`TB_INFLUENCE.tel`)을 쓴다. `collabNo` 캠페인에 속하지 않는 ID는 제외된다
`progressItemIds`	`long[]`	조건부	ProgressTable ID 목록 (구 경로). `applicationIds`가 없을 때만 사용. 진행표 행의 `creator_tel`로 발송한다
`variables`	`object`	아니오	템플릿 변수 치환 맵. 키는 변수명(예: `제출물명`), 값은 치환 문자열. 없으면 기본 치환(캠페인명, 기업명)만 적용

크리에이터 템플릿은 applicationIds 사용을 권장합니다. 진행표(progress_table_items)는 creator_tel이 비어 있는 행이 많아 progressItemIds로는 수신자에게 도달하지 못할 수 있습니다.

사용 가능한 템플릿 변수

variables로 전달 가능한 변수 목록 (템플릿별로 사용하는 변수가 다름):

변수명	설명	사용 템플릿 예시
`제출물명`	제출물 종류 (예: "스크립트(대본)", "영상초안(영상/캡션/해시태그)")	UL_8515, UL_8526, UL_8527, UL_6988, UL_6912, UL_6931
`디플러스날짜`	D+N 표기 (예: "D+3")	UL_8527
`날짜수`	마감 초과 일수 (예: "3")	UL_8527
`계정종류`	SNS 계정 유형 (예: "인스타그램")	UL_8760
`날짜`	포스팅 일정 (예: "2026-10-10")	UL_6912, UL_6931
`포스팅 누락 항목 - 상세사유`	누락 항목 상세	UL_7220

캠페인명은 서버에서 캠페인 조회 후 자동 치환되므로 variables에 포함하지 않아도 됩니다.

크리에이터 템플릿 목록 (2609ver.)

템플릿 ID	이름	주요 변수
`UL_8849`	선정 후 계약서 작성 안내	-
`UL_8760`	협업단가 전송	계정종류
`UL_8527`	리마인드 D+N	제출물명, 디플러스날짜, 날짜수
`UL_8526`	리마인드 D-Day	제출물명
`UL_8515`	리마인드 D-1	제출물명
`UL_8488`	계약 미서명 리마인드	-
`UL_7220`	포스팅 누락 항목 재요청	포스팅 누락 항목 - 상세사유
`UL_6988`	최종제출물 재요청	제출물명
`UL_6952`	영상 수정본 제출 요청	-
`UL_6931`	포스팅 및 최종제출물 제출 (피드백 있음)	날짜, 제출물명
`UL_6912`	포스팅 및 최종제출물 제출	날짜, 제출물명
`UL_6532`	스크립트 수정본 제출 요청	-
`UL_6057`	영상 제작 요청 (피드백 있음)	-
`UL_6054`	영상 제작 요청 (피드백 없음)	-
`UL_6051`	AI 검수 완료	-
`UL_6034`	제품 배송 시작 (검수 1회)	-
`UL_6029`	제품 배송 시작 (검수 2회)	-
`UL_5994`	계약서 완료 (배송형/검수 1회)	-
`UL_5979`	계약서 완료 (비배송형/검수 1회)	-
`UL_5971`	계약서 완료 (배송형/검수 2회)	-
`UL_5943`	계약서 완료 (비배송형/검수 2회)	-
`UL_5868`	단가 재전송	-
`UL_5853`	협업단가 전송 (선착순)	-

광고주 템플릿 (기존 유지)

템플릿 ID	이름
`UC_7882`	게시물 업로드 허용 요청 알림
`UC_7879`	게시물 최종 검수 및 업로드 허용 요청
`UC_7878`	크리에이터 리스트 제외 인원 선택 요청
`UC_7877`	영상 대본 및 캡션 검수 요청

응답

성공 응답 (200 OK)

"success"

비-KR 캠페인 스킵 (200 OK)

"skipped"

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": "UL_6034",
    "collabNo": "1500",
    "progressItemIds": [1, 2, 3]
  }'

변수가 필요한 템플릿:

curl -X POST https://api.glowb.io/ai/aligo/send \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "UL_8527",
    "collabNo": "1500",
    "applicationIds": [7891],
    "variables": {
      "제출물명": "스크립트(대본)",
      "디플러스날짜": "D+3",
      "날짜수": "3"
    }
  }'

POST /ai/aligo/send