Solapi 그룹 / 메시지 조회 시 사용 된 Template 정보

[kimmoonil]

사용 중인 프로그래밍 언어 및 버전

Nodejs

SDK 버전

No response

운영 환경

개발 환경 (로컬)

질문/문제 설명

• https://developers.solapi.com/references/messages/groups/getMessageGroupInfo
• https://developers.solapi.com/references/messages/getMessageList

1. 문서 확인을 해보면, 메시지 / 그룹 정보내에서 어떠한 템플릿을 사용했는지에 대해서는 알수가 없는 것 같은데,
   보낸 메시지가 어떤 템플릿을 사용해서 메시지가 발송되었는지 알 수 있는 방법이 없을까요?

2. 또한 Solapi 에서 커머스자동화를 연계해서 발송 되는 내역들도 아웃고잉 웹훅으로 이벤트를 전송해주게 될까요?

현재 필요한 내용은, Template 을 사용해서 메시지를 발송 시 어떤 템플릿을 사용해서 발송되었다 라는 정보를 조회하고 싶은 것이 목적이고 현재 문서 내에서 있는 Response로는 해당 데이터가 있는지 여부를 확인할 수 없습니다. ㅠㅠ.

코드 예시

No response

시도한 해결 방법

No response

기대하는 결과

• 메시지 혹은 그룹 조회 시 사용 된 사용 된 템플릿 ID를 알 수 있는 방법

확인사항

• 관련 문서를 확인했습니다
• 이전 토론/이슈에서 유사한 질문이 없는지 확인했습니다
• 문의 전 읽어야 하는 사항(문의 전 꼭 읽어봐주세요! #7)을 확인했습니다

[Palbahngmiyine]

안녕하세요, 솔라피 기술지원팀입니다.
문의주신 사항에 순차적으로 답변드리겠습니다.

1. 메시지 / 그룹 정보조회 API 내 카카오 알림톡 템플릿 확인 방법

그룹 조회 API로는 알림톡 템플릿을 확인하실 수 없고, 메시지 조회 시 리턴되는 kakaoOptions 내 templateId를 추출하셔서 카카오 알림톡 템플릿 조회 API를 호출하시면 확인하실 수 있습니다.

2. 커머스 자동화

말씀하신 취지를 잘 이해하지 못했습니다. 단순히 커머스 자동화를 통해 발송하는 메시지들도 웹훅으로 데이터를 받고 싶으신 게 맞으시다면 말씀하신 것 처럼 아웃고잉 웹훅에서 등록하신 웹훅 서버로 리포트를 보내드리고 있습니다.

참고 부탁드리겠습니다.
감사합니다.

[kimmoonil]

단 건 메시지 조회 API 가 있는 것인가요? Response sample 에는 kakaoOptions 가 안보이는 것 같은데 @Palbahngmiyine

Name | Type | Required | Allowed Operator [?] | Description
-- | -- | -- | -- | --
criteria | string |   | eq | 검색 조건에 사용되는 필드명criteria 의 값은 'key1,key2,key3' 과 같이 ,(콤마) 로 구분되며 cond, value 와 함께 사용됩니다.- messageId - 메시지 아이디 입니다.- groupId - 그룹 아이디 입니다.- to - 수신 번호 입니다.- from - 발신 번호 입니다.- type - 문자 메시지의 타입 입니다. (SMS, LMS, MMS, ATA, CTA, CTI)- dateCreated - 그룹 생성일 입니다.- dateUpdated - 그룹 정보를 변경한 마지막 시각 입니다.- replacement - 대체 발송 여부 입니다. (true, false)- statusCode - 문자 메시지의 상태 코드 입니다.
cond | string |   | eq | 검색 조건에 사용되는 연산자criteria 와 같이 'cond1,cond2' 와 같이 ,(콤마)로 구분되며, criteria,value 와 함께 사용됩니다.- eq - 같음 (=)- ne - 같지 않음 (!=)- gt - 보다 큼 (>)- gte - 보다 크거나 같음 (>=)- lt - 보다 작음 (<)- lte - 보다 작거나 같음 (<=)
value | string |   | eq | 검색 값criteria , cond 값에 대응하는 value 입니다.criteria='messageId,statusCode'cond='eq,eq'일 경우 groupId 에 대응하는 value 값을 찾고 status 에 대응하는 값을 찾는 조건 입니다.e.g - value='메시지아이디,2000'
startKey | string |   | eq | 현재 목록을 불러올 기준이 되는 키
limit | number |   | eq | 한 페이지에 불러옥 목록 개수
dateType | string |   | eq | 설명 없음
startDate | string |   | eq | 검색 날짜 시작 범위
endDate | string |   | eq | 검색 날짜 끝 범위
messageId | string |   | eq | 메시지 아이디
messageIds | array |   | eq, in | 메시지 아이디 목록
groupId | string |   | eq | 메시지 그룹 아이디
to | string |   | eq | 수신번호
from | string |   | eq | 발신번호
type | string |   | eq, in | 메시지 타입SMS: 단문 문자LMS: 장문 문자MMS: 사진 문자ATA: 알림톡CTA: 친구톡CTI: 친구톡 + 이미지NSA: 네이버 스마트 알림RCS_SMS: RCS 단문 문자RCS_LMS: RCS 장문 문자RCS_MMS: RCS 사진 문자RCS_TPL: RCS 템플릿 문자RCS_ITPL: RCS 이미지 템플릿 문자RCS_LTPL: RCS LMS 템플릿 문자FAX: 팩스VOICE: 보이스콜BMS_TEXT: 브랜드 메시지 텍스트형BMS_IMAGE: 브랜드 메시지 이미지형BMS_WIDE: 브랜드 메시지 와이드형BMS_WIDE_ITEM_LIST: 브랜드 메시지 와이드 아이템 리스트형BMS_CAROUSEL_FEED: 브랜드 메시지 캐러셀 피드형BMS_PREMIUM_VIDEO: 브랜드 메시지 프리미엄 비디오형BMS_COMMERCE: 브랜드 메시지 커머스형BMS_CAROUSEL_COMMERCE: 브랜드 메시지 캐러셀 커머스형
statusCode | string |   | eq, in, ne | 상태 코드 참고
dateCreated | date |   | eq | 최초 생성 날짜
dateUpdated | date |   | eq | 최근 수정 날짜

Name	Type	Required	Allowed Operator [[?]](https://developers.solapi.com/references/#operator)	Description
criteria	string		eq	검색 조건에 사용되는 필드명
criteria 의 값은 'key1,key2,key3' 과 같이 ,(콤마) 로 구분되며 cond, value 와 함께 사용됩니다.
- messageId - 메시지 아이디 입니다.
- groupId - 그룹 아이디 입니다.
- to - 수신 번호 입니다.
- from - 발신 번호 입니다.
- type - 문자 메시지의 타입 입니다. (SMS, LMS, MMS, ATA, CTA, CTI)
- dateCreated - 그룹 생성일 입니다.
- dateUpdated - 그룹 정보를 변경한 마지막 시각 입니다.
- replacement - 대체 발송 여부 입니다. (true, false)
- statusCode - 문자 메시지의 상태 코드 입니다.
cond	string		eq	검색 조건에 사용되는 연산자
criteria 와 같이 'cond1,cond2' 와 같이 ,(콤마)로 구분되며, criteria,value 와 함께 사용됩니다.
- eq - 같음 (=)
- ne - 같지 않음 (!=)
- gt - 보다 큼 (>)
- gte - 보다 크거나 같음 (>=)
- lt - 보다 작음 (<)
- lte - 보다 작거나 같음 (<=)
value	string		eq	검색 값
criteria , cond 값에 대응하는 value 입니다.
criteria='messageId,statusCode'
cond='eq,eq'
일 경우 groupId 에 대응하는 value 값을 찾고 status 에 대응하는 값을 찾는 조건 입니다.
e.g - value='메시지아이디,2000'
startKey	string		eq	현재 목록을 불러올 기준이 되는 키
limit	number		eq	한 페이지에 불러옥 목록 개수
dateType	string		eq	설명 없음
startDate	string		eq	검색 날짜 시작 범위
endDate	string		eq	검색 날짜 끝 범위
messageId	string		eq	메시지 아이디
messageIds	array		eq, in	메시지 아이디 목록
groupId	string		eq	메시지 그룹 아이디
to	string		eq	수신번호
from	string		eq	발신번호
type	string		eq, in	메시지 타입
SMS: 단문 문자
LMS: 장문 문자
MMS: 사진 문자
ATA: 알림톡
CTA: 친구톡
CTI: 친구톡 + 이미지
NSA: 네이버 스마트 알림
RCS_SMS: RCS 단문 문자
RCS_LMS: RCS 장문 문자
RCS_MMS: RCS 사진 문자
RCS_TPL: RCS 템플릿 문자
RCS_ITPL: RCS 이미지 템플릿 문자
RCS_LTPL: RCS LMS 템플릿 문자
FAX: 팩스
VOICE: 보이스콜
BMS_TEXT: 브랜드 메시지 텍스트형
BMS_IMAGE: 브랜드 메시지 이미지형
BMS_WIDE: 브랜드 메시지 와이드형
BMS_WIDE_ITEM_LIST: 브랜드 메시지 와이드 아이템 리스트형
BMS_CAROUSEL_FEED: 브랜드 메시지 캐러셀 피드형
BMS_PREMIUM_VIDEO: 브랜드 메시지 프리미엄 비디오형
BMS_COMMERCE: 브랜드 메시지 커머스형
BMS_CAROUSEL_COMMERCE: 브랜드 메시지 캐러셀 커머스형
statusCode	string		eq, in, ne	상태 코드 [참고](https://developers.solapi.com/references/message-status-codes)
dateCreated	date		eq	최초 생성 날짜
dateUpdated	date		eq	최근 수정 날짜

[kimmoonil]

안녕하세요, 솔라피 기술지원팀입니다. 문의주신 사항에 순차적으로 답변드리겠습니다.

1. 메시지 / 그룹 정보조회 API 내 카카오 알림톡 템플릿 확인 방법

그룹 조회 API로는 알림톡 템플릿을 확인하실 수 없고, 메시지 조회 시 리턴되는 kakaoOptions 내 templateId를 추출하셔서 카카오 알림톡 템플릿 조회 API를 호출하시면 확인하실 수 있습니다.

2. 커머스 자동화

말씀하신 취지를 잘 이해하지 못했습니다. 단순히 커머스 자동화를 통해 발송하는 메시지들도 웹훅으로 데이터를 받고 싶으신 게 맞으시다면 말씀하신 것 처럼 아웃고잉 웹훅에서 등록하신 웹훅 서버로 리포트를 보내드리고 있습니다.

참고 부탁드리겠습니다. 감사합니다.

2번 내용은 자동화로 오는 웹훅 데이터는 저희에게 불필요한 정보라 따로 안받을 수 있는 방법은 없는거겠죠?

[Palbahngmiyine]

첫번째로 보내주신 자료는 request 파라미터 일람표입니다, 해당 문서 상 response 데이터가 보이진 않는 것으로 보여 관련한 내용은 내부에 건의하여 개선될 수 있도록 하겠습니다. 해결을 위해 임시로나마 API를 직접 호출해보셔서 해당 데이터셋을 테스트 해보시길 권해드리겠습니다.

두번째로 문의하신 사항의 경우 따로 필터링 기능은 제공되지 않는 점 양해 부탁드립니다.