문자(SMS) 발송 API (템플릿 기반)

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

Request Example

cURL

curl -X POST "https://bnd.happytalk.io/api/openapi/messages/send-template" \
 -H "accept: application/json"\
 -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": 789,
          "messageType": "SMS",
          "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	-	메시지 타입 (SMS, LMS)
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	문자 발송에 실패했습니다	문자 발송 처리 중 오류