네이버톡톡 서비스
네이버톡톡 서비스를 이용하기 위해서는 사전에 네이버 파트너 센터를 통해 채널을 생성해야 하며, 메시지 템플릿을 등록해야 합니다.
네이버톡톡 서비스 타입
필요한 서비스에 따라 타입을 선택할 수 있습니다. 두 타입 모두 수신자가 받는 메시지는 동일합니다.
표네이버톡톡 서비스 타입타입 | 구분 | 설명 |
---|---|---|
NT_FM | 메시지 발송 | 치환 대상 템플릿 변수를 포함하여 전체 본문을 첨부하는 방식 |
NT_TM | 메시지 발송 | 전체 본문을 첨부하지 않고 치환 대상 템플릿 변수만 첨부하는 방식 |
안내
현재 네이버톡톡 발송에 필요한 템플릿을 대행 등록하고 있습니다. 담당자에게 채널 정보와 템플릿 등록에 필요한 데이터를 함께 문의하여 관련 절차를 진행하시기 바랍니다.
네이버톡톡 발송하기
네이버톡톡 서비스로 메시지를 발송할 수 있는 코드 예제를 제공합니다.
안내
각 테이블에 입력하는 데이터는 테이블 명세 문서를 참고하시기 바랍니다.
네이버톡톡(NT_FM) 발송
네이버톡톡(NT_FM) 발송은 치환 대상 템플릿 변수를 포함하여 전체 본문을 첨부하는 서비스입니다.
코드예제네이버톡톡(NT_FM) 발송 Sample Code
INSERT INTO NAVER_MESSAGE (
MSG_SEQNO,
MESSAGE_TYPE,
TEMPLATE_CODE,
MESSAGE,
USER_NAME,
SENDER_KEY,
PHONE_NUMBER,
ATTACHMENTS,
FALLBACK_YN,
FALLBACK_MESSAGE,
FALLBACK_CALLBACK,
FALLBACK_SUBJECT,
FALLBACK_TYPE
) VALUES (
'2022111800006', # 메시지 KEY :: 미정의 시 자동 채번
'NT_FM', # 메시지 타입
'NT-20221117174151', # 템플릿 코드
'홍길동 고객님 안녕하세요. 카카오 i 커넥트 비즈메시지를 이용해주셔서 감사합니다. 01000000000로 상담 전화드리도록 하겠습니다.', # 치환할 변수 (JSON) 만 첨부
'홍길동', # 수신자 이름
'XXXXXXXXXXXXXX', # 발송 채널 키 (계약 후 발급)
'821000000000', # 수신자 번호 (국가번호 포함 형식 필수)
'', # ATTACHMENT 첨부 (템플릿 형식에 맞춰 첨부)
0, # 대체 발송 진행 여부
'대체 발송 본문', # 대체 발송 본문
'0000-0000', # 발신 번호
'대체 발송 제목', # 대체 발송 제목
'SM' # 대체 발송 타입 (SM, LM)
);
네이버톡톡(NT_TM) 발송
네이버톡톡(NT_TM) 발송은 전체 본문을 첨부하지 않고 치환 대상 템플릿 변수만 첨부하는 서비스입니다.
코드예제네이버톡톡(NT_TM) 발송 Sample Code
INSERT INTO NAVER_MESSAGE (
MSG_SEQNO,
MESSAGE_TYPE,
TEMPLATE_CODE,
TEMPLATE_PARAMS,
USER_NAME,
SENDER_KEY,
PHONE_NUMBER,
ATTACHMENTS,
FALLBACK_YN,
FALLBACK_MESSAGE,
FALLBACK_CALLBACK,
FALLBACK_SUBJECT,
FALLBACK_TYPE
) VALUES (
'202209110000000', # 메시지 KEY :: 미정의 시 자동 채번
'NT_TM', # 메시지 타입
'NT-XXXXXXXXX', # 템플릿 코드
'{"이름": "홍길동", "휴대폰번호": "01000000000"}', # 치환할 변수 (JSON) 만 첨부
'홍길동', # 수신자 이름
'XXXXXXXXXXXXXXX', # 발송 채널 키 (계약 후 발급)
'821000000000', # 수신자 번호 (국가번호 포함 형식 필수)
'', # ATTACHMENT 첨부 (템플릿 형식에 맞춰 첨부)
0, # 대체 발송 진행 여부
'대체 발송 본문', # 대체 발송 본문
'0000-0000', # 발신 번호
'대체 발송 제목', # 대체 발송 제목
'SM' # 대체 발송 타입 (SM, LM)
);
네이버톡톡 결과 코드
네이버톡톡 발송과 관련한 결과 코드는 다음과 같습니다.
표네이버톡톡 결과 코드구분 | 코드 | 코드 설명 |
---|---|---|
결과코드 (네이버) | 0000 | 메시지가 유저에게 앱과 웹으로 성공적으로 전송되었습니다. |
0001 | 메시지가 유저에게 웹으로 전송되었으나 앱 전송에는 실패하였습니다. | |
1001 | AgentKey 또는 PartnerKey가 누락되었습니다. | |
1002 | 보내기 API의 요청 Body에 문제가 있습니다. | |
1003 | 전화번호나 액세스 토큰 중 적어도 하나의 파라미터가 필요합니다. | |
1004 | 전화번호 패턴이 잘못되었습니다. | |
1005 | 파트너키나 발송 그룹키가 반드시 있어야 합니다. | |
2001 | 템플릿에 필요한 파라미터가 부족합니다. | |
2002 | 템플릿 아이디가 존재하지 않습니다. | |
2003 | 템플릿에 필요한 파라미터가 일치하지 않습니다. | |
2004 | 템플릿에 필요한 버튼 개수와 요청한 버튼 개수가 일치하지 않습니다. | |
2005 | 템플릿에 필요한 파라미터가 일치하지 않습니다. 버튼코드를 확인하시기 바랍니다. | |
2006 | 등록된 템플릿과 일치하지 않는 메시지(message) 파라미터입니다. | |
2007 | 승인되지 않은 템플릿은 발송할 수 없습니다. 템플릿 승인 상태를 확인하세요. | |
2008 | 등록된 템플릿과 메시지 파라미터를 비교하던 중 오류가 발생하였습니다. 2006 응답코드와 거의 동일한 상황이나, 특수문자에 의해 불일치가 있는 경우입니다. |
|
2009 | 관리자에 의해 차단된 템플릿입니다. 자세한 내용은 문의해주세요. | |
2010 | 템플릿에 사용하는 샘플 이미지가 등록되지 않았습니다. 샘플 이미지를 등록해주세요. | |
2011 | 이미지 해시 아이디에 해당하는 파트너키나 템플릿 그룹키를 사용해야 합니다. | |
2101 | 템플릿에 저장된 템플릿 그룹 아이디와 일치하지 않는 템플릿 요청입니다. 템플릿 설정을 확인해주세요. | |
2102 | 유효하지 않은 템플릿 그룹키 입니다. 그룹키를 확인해주세요. | |
2103 | 템플릿 그룹의 파트너 목록에 존재하지 않는 요청입니다. | |
2104 | 이미지 해시 아이디에 해당하는 템플릿 그룹키를 확인해주세요. | |
3001 | 에이전트 키에 해당하는 파트너가 맵핑되어 있지 않습니다. | |
3002 | 전화번호에 해당하는 유저가 존재하지 않습니다. | |
3003 | 맵핑된 파트너가 존재하지 않습니다. | |
3004 | 이미 존재하는 메시지 키입니다. | |
3005 | 전화번호에 해당하는 서로 다른 유저가 존재합니다. | |
3006 | 발송 파트너 계정 상태가 비정상 상태입니다. | |
4001 | 유저가 정보성 알림을 받을 수 있는 상태가 아닙니다. | |
4002 | 유저가 스마트알림 수신을 차단하였습니다. | |
4003 | 유저가 파트너 계정을 차단하였습니다. | |
9051 | 메시지 시스템의 오류로 정보성 알림 송신이 불가합니다. | |
9999 | 알 수 없는 이유로 메시지가 전송되지 않았습니다. | |
결과코드 (Agent Common) |
AGT_110 | 전문 생성 오류 |
AGT_111 | 암호화키 생성 오류 | |
AGT_112 | 압축 오류 | |
AGT_113 | 파일 암호화 오류 | |
AGT_120 | TCP SOCKET FAIL | |
AGT_130 | 전문 발송 요청 실패(Fail) | |
AGT_140 | 이미지 파일 없음 | |
AGT_150 | 잘못된 SEND_TYPE | |
AGT_160 | 허용되지 않는 메시지 타입 - ex. LMS 발송을 계약하지 않았으나 MSG_TYPE이 KM 혹은 XM인 경우 |
|
AGT_170 | 블랙리스트 대상자 |