네이버 톡톡 (광고성)

네이버 기반의 광고성 메시지 발송 API

사전에 톡톡 파트너센터(https//partner.talk.naver.com)에 파트너 가입이 필요하며, 파트너 키를 준비해야 합니다.

API PLEX 고객센터로 연락하여 템플릿을 사전에 등록 하여야 합니다.

수신 받는 유저가 네이버 앱을 설치한 상태에서만 수신가능 합니다.

캐릭터 인코딩은 UTF-8 을 기본으로 합니다.

Path variable

Path variable(각 URI 내 중괄호({}) 로 묶인 경로 변수)는 아래 내용을 참고하여 호출 시 누락되지 않도록 해주세요.

code

설명

partner_key

파트너 키

네이버톡(광고성) 발송 API

POST https://4vh6qtie3c.apigw.ntruss.com/naver-talk/v1/send/{partner_key}

Headers

Name

Type

Description

Authorization*

string

사용자ID;secret_key

Content-Type*

string

application/json;charset=utf-8

Request Body

Name

Type

Description

message*

string

메시지 본문

등록된 템플릿 문구와 치환 문자를 포함한 메시지 전체 문구를 세팅

templateCode*

string

사전에 등록한 템플릿 코드

phoneNumber*

string

네이버 아이디 생성 시 기입한 유저의 핸드폰 번호

messageKey*

string

메시지 고유 키 (unique 필수)

Request Body 예시

{
    "message" : "String",
    "messageKey" : "String",
    "phoneNumber" : "String",
    "templateCode" : "String"
 }

Response body

키

타입

필수

설명

success

bool

성공 여부

resultCode

string

결과 코드

resultMessage

string

결과 메시지

transmissionId

string

발송건 별로 부여되는 유니크 아이디 발송 결과를 조회 시 사용

성공

{
    "success": true,
    "resultCode": "0000",
    "resultMessage": "메세지가 유저에게 앱과 웹으로 성공적으로 전송되었습니다.",
    "transmissionId": 4285012221
}

잘못된 요청 또는 에러

{
    "code": "G210",
    "desc": "요청 JSON 변환중 오류가 발생했습니다."
}

잘못된 list 내부 요청

{
    "results": [
        {
            "code": "C341",
            "msg_key": "2022060900001",
            "desc": "MsgLengthOver"
        },
        {
            "code": "C341",
            "msg_key": "2022060900002",
            "desc": "MsgLengthOver"
        }
    ]
}

Result Code 상세

code

설명

0000

메세지가 유저에게 성공적으로 전송되었습니다.

1000

유저의 네이버 아이디 상태에 문제가 있습니다.

1011

권한 없는 유저에게 발송 시도하였습니다.

2000

템플릿에 필요한 파라미터가 일치하지 않습니다.

2001

템플릿에 필요한 파라미터가 부족합니다.

2002

템플릿 아이디가 존재하지 않습니다.

2003

메세지 포맷 오류입니다.

2004

수신자 전화번호 오류입니다.

9051

서버 내부 오류가 발생하였습니다.

9000

알 수 없는 이유로 메세지가 전송되지 않았습니다.

GATEWAY 오류코드

CODE

설명

G110

서비스 ID가 잘못되었습니다.

G120

유효한 사용자가 존재하지 않습니다.

G130

서비스 KEY가 잘못되었습니다.

G140

유효한 발신번호가 아닙니다.

G150

여신이 부족합니다.

G160

1회 발송 최대 수를 초과했습니다.

G180

필수항목이 누락되었습니다. 항목명: %s

G200

project-key 정보가 잘못되었습니다.

G210

요청 JSON 변환중 오류가 발생했습니다.

G410

원천서비스 서비스 오류 발생

G420

사용자 callback api 호출 오류입니다.

G900

Gateway 시스템 오류가 발생했습니다.

G910

사용자 인증에 실패했습니다.

Last updated 1 year ago

Was this helpful?

네이버 톡톡 (광고성)

네이버 기반의 광고성 메시지 발송 API

사전에 톡톡 파트너센터(https//partner.talk.naver.com)에 파트너 가입이 필요하며, 파트너 키를 준비해야 합니다.

API PLEX 고객센터로 연락하여 템플릿을 사전에 등록 하여야 합니다.

수신 받는 유저가 네이버 앱을 설치한 상태에서만 수신가능 합니다.

캐릭터 인코딩은 UTF-8 을 기본으로 합니다.

Path variable

Path variable(각 URI 내 중괄호({}) 로 묶인 경로 변수)는 아래 내용을 참고하여 호출 시 누락되지 않도록 해주세요.

code

설명

partner_key

파트너 키

네이버톡(광고성) 발송 API

POST https://4vh6qtie3c.apigw.ntruss.com/naver-talk/v1/send/{partner_key}

Headers

Name

Type

Description

Authorization*

string

사용자ID;secret_key

Content-Type*

string

application/json;charset=utf-8

Request Body

Name

Type

Description

message*

string

메시지 본문

등록된 템플릿 문구와 치환 문자를 포함한 메시지 전체 문구를 세팅

templateCode*

string

사전에 등록한 템플릿 코드

phoneNumber*

string

네이버 아이디 생성 시 기입한 유저의 핸드폰 번호

messageKey*

string

메시지 고유 키 (unique 필수)

Request Body 예시

{
    "message" : "String",
    "messageKey" : "String",
    "phoneNumber" : "String",
    "templateCode" : "String"
 }

Response body

키

타입

필수

설명

success

bool

성공 여부

resultCode

string

결과 코드

resultMessage

string

결과 메시지

transmissionId

string

발송건 별로 부여되는 유니크 아이디 발송 결과를 조회 시 사용

성공

{
    "success": true,
    "resultCode": "0000",
    "resultMessage": "메세지가 유저에게 앱과 웹으로 성공적으로 전송되었습니다.",
    "transmissionId": 4285012221
}

잘못된 요청 또는 에러

{
    "code": "G210",
    "desc": "요청 JSON 변환중 오류가 발생했습니다."
}

잘못된 list 내부 요청

{
    "results": [
        {
            "code": "C341",
            "msg_key": "2022060900001",
            "desc": "MsgLengthOver"
        },
        {
            "code": "C341",
            "msg_key": "2022060900002",
            "desc": "MsgLengthOver"
        }
    ]
}

Result Code 상세

code

설명

0000

메세지가 유저에게 성공적으로 전송되었습니다.

1000

유저의 네이버 아이디 상태에 문제가 있습니다.

1011

권한 없는 유저에게 발송 시도하였습니다.

2000

템플릿에 필요한 파라미터가 일치하지 않습니다.

2001

템플릿에 필요한 파라미터가 부족합니다.

2002

템플릿 아이디가 존재하지 않습니다.

2003

메세지 포맷 오류입니다.

2004

수신자 전화번호 오류입니다.

9051

서버 내부 오류가 발생하였습니다.

9000

알 수 없는 이유로 메세지가 전송되지 않았습니다.

GATEWAY 오류코드

CODE

설명

G110

서비스 ID가 잘못되었습니다.

G120

유효한 사용자가 존재하지 않습니다.

G130

서비스 KEY가 잘못되었습니다.

G140

유효한 발신번호가 아닙니다.

G150

여신이 부족합니다.

G160

1회 발송 최대 수를 초과했습니다.

G180

필수항목이 누락되었습니다. 항목명: %s

G200

project-key 정보가 잘못되었습니다.

G210

요청 JSON 변환중 오류가 발생했습니다.

G410

원천서비스 서비스 오류 발생

G420

사용자 callback api 호출 오류입니다.

G900

Gateway 시스템 오류가 발생했습니다.

G910

사용자 인증에 실패했습니다.

Last updated 1 year ago

Was this helpful?