Kakao i Connect Message::BizMessage(KOR)::Agent 설치 방식::네이버톡톡 발송

페이지 이동경로

네이버톡톡 서비스

네이버톡톡 서비스를 이용하기 위해서는 사전에 네이버 파트너 센터를 통해 채널을 생성해야 하며, 메시지 템플릿을 등록해야 합니다.

네이버톡톡 서비스 타입

필요한 서비스에 따라 타입을 선택할 수 있습니다. 두 타입 모두 수신자가 받는 메시지는 동일합니다.

네이버톡톡 서비스 타입
타입 구분 설명
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 블랙리스트 대상자
이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 contact.dkt@kakaocorp.com 으로 제보해주세요.