알림톡 발송 요청 API

이름	타입	필수	기본값	설명
agentId	Long	O	-	에이전트 ID (양수)
cdrId	String	O	-	알림톡 발송 대상 CDR ID
templateId	Long	O	-	사용할 알림톡 템플릿 ID

Request Example

cURL

curl -X POST "https://bnd.happytalk.io/api/openapi/messages/send-alimtalk" \                                                                                                                                                           
    -H "Authorization: Bearer YOUR_API_KEY" \                                                                                                                                                                                           
    -H "Content-Type: application/json" \                                                                                                                                                                                               
    -d '{         
      "agentId": 123,
      "cdrId": "10017698",
      "templateId": 456
    }'
JavaScript
복사

6. Response

Response 정보

•

Status Code: 200 OK

•

Content-Type: application/json

Response Body Example

json

{
      "code": "OK",
      "timestamp": 1735437506000,
      "message": "알림톡 발송이 완료되었습니다",
      "data": {
          "siteId": "921004321466",
          "cdrId": "10017698",
          "agentId": 123,
          "templateId": 456,
          "messageType": "ALIMTALK",
          "phoneNumber": "010****5678",
          "result": "SUCCESS",
          "requestedAt": "2026-01-27T15:30:00Z"
      }
  }
JavaScript
복사

Resonse Field명

이름	타입	필수	기본값	설명
code	String	O	-	응답 코드
timestamp	Long	O	-	응답 일시 (Unix timestamp)
message	String	X	-	응답 메시지
data	Object	O	-	알림톡 발송 결과 데이터

data

이름	타입	필수	기본값	설명
siteId	String	O	-	사이트 ID
cdrId	String	O	-	알림톡 발송 대상 CDR ID
agentId	Long	O	-	에이전트 ID
templateId	Long	O	-	사용된 알림톡 템플릿 ID
messageType	String	O	-	메시지 타입 (ALIMTALK)
phoneNumber	String	O	-	수신자 전화번호 (마스킹 처리)
result	String	O	-	발송 결과 (SUCCESS)
requestedAt	String	O	-	발송 요청 시각 (ISO 8601)

7. 에러 / 예외처리

오류 응답 본문의 “code"와 "message" 속성에서 오류에 대한 더 구체적인 세부 정보를 확인할 수 있습니다.

HTTP 상태명	Error Code	Message	설명
400 Bad Request	BAD_REQUEST	CDR ID 형식이 올바르지 않습니다	CDR ID 형식 오류
400 Bad Request	BAD_REQUEST	휴대폰 번호가 아닙니다	CDR의 발신번호가 휴대폰 번호가 아닌 경우
401 Unauthorized	UNAUTHORIZED	Invalid credentials	API Key 미전송 또는 인증 실패
403 Forbidden	FORBIDDEN	알림톡 프로필이 설정되지 않았습니다	사이트에 알림톡 프로필 미설정
404 Not Found	NOT_FOUND	CDR을 찾을 수 없습니다	존재하지 않는 CDR
404 Not Found	NOT_FOUND	템플릿을 찾을 수 없습니다	존재하지 않는 템플릿
404 Not Found	NOT_FOUND	알림톡 프로파일을 찾을 수 없습니다	알림톡 프로파일이 존재하지 않는 경우
500 Internal Server Error	INTERNAL_SERVER_ERROR	알림톡 발송에 실패했습니다	알림톡 발송 처리 중 오류