기업회원 신청 서류 안내
신청자 구분에 따라 재직증명서 또는 위임장을 함께 제출해 주세요.
신청자 구분에 따라 재직증명서 또는 위임장을 함께 제출해 주세요.
A PRACTICAL GUIDE
브랜드메시지로 채널 친구·비친구·전체 동보 발송하는 방법. targeting 값에 따른 경로 차이와 친구톡 API 를 계속 써야 하는 예외까지.
POST /api/v2/brand-messages/send브랜드메시지는 카카오 채널을 통한 마케팅·홍보 메시지 채널입니다. 정보성만 가능한 알림톡과 달리 광고를 보낼 수 있고, 친구톡과 달리 채널 친구가 아닌 사람에게도 보낼 수 있습니다.
v2 전용입니다. v1 에는 이 엔드포인트가 없습니다.
kakaoSenderKey) → 발신번호 사전등록friendTemplateUuidadFlag: "Y" 와 광고 규칙 준수targeting 이 경로를 가른다targeting |
대상 | 발송 방식 | contacts |
|---|---|---|---|
M |
채널 친구 | 단건(BRAND_BASIC) |
필수 |
N |
채널 친구가 아닌 수신자 | 단건(BRAND_BASIC) |
필수 |
I |
지정 대상 | 단건(BRAND_BASIC) |
필수 |
F |
수신 동의한 전체 채널 친구 | 동보(BRAND_GROUP) |
불필요 |
F 는 수신자를 지정하지 않으므로 응답에 발송 건수가 없고 접수 여부만 돌아옵니다. 결과는 캠페인 조회로 확인합니다.
요청에는 친구톡 코드를 그대로 넘깁니다. 서버가 브랜드메시지 코드로 변환합니다.
| 넘기는 값 | 변환 결과 | 내용 |
|---|---|---|
FT |
BT |
텍스트 |
FI |
BI |
이미지 |
FW |
BW |
와이드 이미지 |
FL |
BL |
리스트 |
FC |
BC |
커머스 |
FM |
BM |
복합 |
FP |
BP |
프리미엄 동영상 |
FA |
BA |
캐러셀 |
중요한 예외: FT/FI/FW 를 M/N/I 로 보내면 이 엔드포인트는 NOT_A_BRAND_MESSAGE 를 반환합니다. 자유 본문을 개별 수신자에게 보내는 경로는 여전히 /api/v2/friends/send 입니다. 자세한 내용은 친구톡 종료 대응에 있습니다.
// 단건 발송 — 채널 친구 대상
await sendgo.brandMessage.send({
targeting: 'M',
messageType: 'FL',
friendTemplateUuid: '9cd5460b-6458-4edc-9b11-c26d3013c340',
adFlag: 'Y',
contacts: [{ contact: '01012345678', var1: '29,000원' }],
});
// 단건 발송 — 채널 친구가 아닌 수신자
await sendgo.brandMessage.send({
targeting: 'N',
messageType: 'FM',
friendTemplateUuid: '9cd5460b-6458-4edc-9b11-c26d3013c340',
adFlag: 'Y',
contacts: [{ contact: '01012345678' }],
});
// 동보 발송 — 수신 동의한 전체 채널 친구 (contacts 없음)
await sendgo.brandMessage.broadcast({
messageType: 'FW',
friendTemplateUuid: '9cd5460b-6458-4edc-9b11-c26d3013c340',
adFlag: 'Y',
});
// 캠페인 결과 확인
const list = await sendgo.brandMessage.campaigns({ count: 10 });
const one = await sendgo.brandMessage.campaign(campaignId);
client.brand_message.send(
targeting="M",
message_type="FL",
friend_template_uuid="9cd5460b-6458-4edc-9b11-c26d3013c340",
ad_flag="Y",
contacts=[{"contact": "01012345678", "var1": "29,000원"}],
)
<?php
$sendgo->brandMessage->send([
'targeting' => 'M',
'messageType' => 'FL',
'friendTemplateUuid' => '9cd5460b-6458-4edc-9b11-c26d3013c340',
'adFlag' => 'Y',
'contacts' => [['contact' => '01012345678', 'var1' => '29,000원']],
]);
curl -X POST https://sendgo.io/api/v2/brand-messages/send \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"kakaoSenderKey": "your_kakao_sender_key",
"targeting": "F",
"messageType": "FW",
"friendTemplateUuid": "9cd5460b-6458-4edc-9b11-c26d3013c340",
"adFlag": "Y",
"scheduleType": "DIRECTLY"
}'
브랜드메시지도 replaceSms: "Y" 로 실패 시 문자 대체가 가능합니다. smsSubject 와 smsContent, 그리고 senderKey 를 함께 넘겨야 합니다.
await sendgo.brandMessage.send({
targeting: 'M',
messageType: 'FL',
friendTemplateUuid: '...',
replaceSms: 'Y',
smsSubject: '[여름 특가]',
smsContent: '여름 한정 특가를 확인하세요.',
contacts: [{ contact: '01012345678' }],
});
동보 발송은 접수만 확인되므로 결과를 따로 조회합니다.
# 목록 (기본 최근 90일)
curl "https://sendgo.io/api/v2/brand-messages?count=30" -H "Authorization: Bearer $TOKEN"
# 상세 — 발송 응답의 campaignId 사용
curl "https://sendgo.io/api/v2/brand-messages/$CAMPAIGN_ID" -H "Authorization: Bearer $TOKEN"
이 엔드포인트는 브랜드메시지 캠페인(BRAND_GROUP, BRAND_BASIC)만 반환합니다. 친구톡 캠페인은 /api/v2/friends 를 쓰세요.
일반 발송 승인이 완료된 이메일 서비스입니다. 발신 인증과 앱의 발송 가능 상태를 확인하고 SMTP, HTTP API와 자동화 수신함을 연동하세요.
승인된 템플릿 코드로 카카오 알림톡을 발송하는 코드. Laravel, Node.js, Python, PHP, Java, Go, Ruby, .NET 예제와 필수 파라미터, 실패 원인을 정리했습니다.
샌드고로 SMS(90바이트), LMS(장문), MMS(이미지)를 발송하는 방법. 타입 선택 기준, 바이트 계산, 광고 문자 규칙까지 정리했습니다.
replaceSms 로 카카오 알림톡이 도달하지 못했을 때 자동으로 문자를 보내는 방법. 필수 파라미터와 흔한 실수를 정리했습니다.
contacts 배열로 수신자별 변수를 채워 한 번에 발송하는 방법. 배치 크기, 부분 실패 처리, 큐 사용 패턴까지.
지정한 시각에 카카오 알림톡이나 문자를 발송하는 방법. 예약 시각 형식, 시간대, 야간 광고 제한과의 관계를 정리했습니다.