네이버 톡톡
네이버 톡톡은 네이버 비즈니스 채널을 통해 고객에게 정보성 메시지를 전달하는 메시지 채널입니다. 비즈고에서는 네이버 스마트알림 규격에 맞춰 템플릿 기반 메시지 발송을 지원합니다.
네이버스마트알림 발송
POST/api/comm/v1/send/omni
네이버 톡톡 발송 규격입니다. messageFlow[].navertalk 객체를 사용하며 필요 시 fallback SMS를 함께 설정할 수 있습니다.
Body Parameters
{}JSONdestinations
필수 Object Array수신 정보 배열입니다. 동보발송 최대 200건입니다.
messageFlow
필수 Object Array메시지를 추가하면 순서대로 자동 Fallback 메시지 처리됩니다.
paymentCode
String정산용 부서 코드입니다.
groupKey
String메시지 인사이트 에서 그룹으로 묶어서 통계를 확인하기 위해 설정하는 키입니다.
idempotencyKey
String요청에 대한 멱등함을 구분하는 멱등성 키 필드입니다.
idempotencyTtl
Integer멱등 처리키 유효시간 입니다.
ref
String요청 참조 필드입니다.
Returns
common
Object공통 응답 영역입니다.
data
Object서비스 응답 영역입니다.
요청 예시
1
curl -X POST "/api/comm/v1/send/omni" \2
-H "Authorization: {ApiKey}" \3
-H "Content-Type: application/json" \4
-d '{5
"destinations": [{ "to": "01012345678" }],6
"messageFlow": [{7
"navertalk": {8
"partnerKey": "PARTNER_KEY",9
"templateCode": "NAVER_TEMPLATE_001",10
"productCode": "INFORMATION",11
"text": "네이버 톡톡 메시지 본문입니다.",12
"attachments": {13
"buttons": [{14
"buttonCode": "WEB_LINK",15
"mobileUrl": "https://m.example.com",16
"pcUrl": "https://example.com"17
}]18
}19
}20
}],21
"ref": "naver-talktalk-20260331-001"22
}'응답 예시
1
{2
"common": {3
"authCode": "A000",4
"authResult": "Success",5
"infobankTrId": "Infobank-Tracking-Id"6
},7
"data": {8
"code": "A000",9
"result": "SUCCESS",10
"data": {11
"destinations": [{12
"to": "01012345678",13
"msgKey": "NV20260331-000001",14
"code": "A000",15
"result": "Success"16
}]17
},18
"ref": "naver-talktalk-20260331-001"19
}20
}