Naver TalkTalk

Naver TalkTalk is a message channel that delivers informational messages to customers through a Naver business channel. Bizgo supports template-based message sending in line with the Naver Smart Notification specification.

Send a Naver Smart Notification

POST/api/comm/v1/send/omni

Try sending a message Try it in the Sandbox

The Naver TalkTalk send specification. It uses the messageFlow[].navertalk object.

Body Parameters

{}JSON

destinations

RequiredObject Array

The array of recipient information. Up to 200 per broadcast send.

RequiredString

The recipient number.

replaceWords

Object

Variable substitution variables (JSON).

ref

String

A per-message reference field.

messageFlow

RequiredObject Array

When you add messages, they are handled in order as automatic failover messages.

navertalk

RequiredObject

The Naver TalkTalk message object.

partnerKey

RequiredString

The Naver TalkTalk partner key.

templateCode

RequiredString

The Naver TalkTalk template code.

productCode

RequiredString

The product code in the template.

userName

String

The real name of the phone number owner.

text

String

The template body.

templateParams

Object

The template substitution variables.

attachments

Object

The attachment information object.

imageHashId

String

The hashId of the attached image.

buttons

Object Array

The list of buttons.

buttonCode

RequiredString

The button code.

gift

Object

The coupon information object.

name

String

The coupon name.

groupKey

String

The Naver TalkTalk send group.

paymentCode

String

The department code used for settlement.

groupKey

String

A key you set to group messages and review their statistics in Message Insight.

idempotencyKey

String

The idempotency key field that identifies the request for idempotency.

idempotencyTtl

Integer

The validity period of the idempotency key.

ref

String

A per-request reference field.

Returns

common

Object

The common response section.

authCode

String

The authentication result code.

authResult

String

The authentication result message.

data

Object

The service response section.

data

Object

The actual message response data.

destinations

Object Array

The array of per-recipient results.

code

String

The per-recipient result code.

ref

String

The reference value passed with the request.

Request example

curl -X POST "/api/comm/v1/send/omni" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "destinations": [{ "to": "01012345678" }],
    "messageFlow": [{
      "navertalk": {
        "partnerKey": "PARTNER_KEY",
        "templateCode": "NAVER_TEMPLATE_001",
        "productCode": "INFORMATION",
        "text": "네이버 톡톡 메시지 본문입니다.",
        "attachments": {
          "buttons": [{
            "buttonCode": "WEB_LINK",
            "mobileUrl": "https://m.example.com",
            "pcUrl": "https://example.com"
          }]
        }
      }
    }],
    "ref": "naver-talktalk-20260331-001"
  }'

Response example

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "SUCCESS",
    "data": {
      "destinations": [{
        "to": "01012345678",
        "msgKey": "20260424104234546POM101182450000",
        "code": "A000",
        "result": "Success"
      }]
    },
    "ref": "naver-talktalk-20260331-001"
  }
}