카카오 발신 프로필(채널) 연동하기

카카오 비즈니스 채널을 센드온과 연동하여 알림톡 및 친구톡 발송에 활용할 수 있습니다. 이 문서에서는 카카오 채널을 센드온에 연동하는 절차와 방법에 대해 안내합니다.
연동 전 준비사항
카카오 채널 연동을 위해서는 다음 조건이 충족되어야 합니다:
- 카카오 비즈니스에 채널을 등록하고 비즈니스 인증을 완료해야 함
- 채널 관리자 권한이 있어야 함
- 채널이 공개 설정되어 있어야 함
- 채널 정보에 고객센터 정보가 포함되어 있어야 함
연동 절차
카카오 채널을 센드온에 연동하는 절차는 다음과 같습니다:
- 인증번호 요청
- 카카오톡으로 받은 인증번호 확인
- 인증번호를 사용하여 채널 등록
1. 인증번호 요청
카카오 채널 등록을 위한 인증번호를 요청합니다. 인증번호는 채널 관리자의 카카오톡으로 발송됩니다.
async function requestChannelVerification() {
const channelId = YOUR_CHANNEL_ID; // 카카오 채널 ID
const phoneNumber = YOUR_PHONE_NUMBER; // 인증에 사용할 전화번호
const result = await sendon.kakao.requestChannelVerification({
channelId,
phoneNumber,
});
console.log('인증번호 요청 결과:', result);
return result;
}
참고: 인증번호는 카카오톡으로 전송되는 6자리 숫자로, PC 카카오톡에서는 확인이 불가능하며 모바일 카카오톡에서만 확인할 수 있는 보안 메시지입니다.
파라미터 | 타입 | 설명 | 필수 여부 |
---|---|---|---|
channelId | string | 카카오 채널 ID | 필수 |
phoneNumber | string | 인증에 사용할 전화번호 | 필수 |
2. 인증번호를 사용한 채널 등록
카카오톡으로 받은 인증번호를 사용하여 채널을 센드온에 등록합니다.
async function registerChannel() {
const channelId = YOUR_CHANNEL_ID; // 카카오 채널 ID
const phoneNumber = YOUR_PHONE_NUMBER; // 인증에 사용한 전화번호
const verificationCode = VERIFICATION_CODE; // 카카오톡으로 받은 6자리 인증번호
const result = await sendon.kakao.registerChannel({
channelId,
verificationCode,
phoneNumber,
});
console.log('채널 등록 결과:', result);
return result;
}
파라미터 | 타입 | 설명 | 필수 여부 |
---|---|---|---|
channelId | string | 카카오 채널 ID | 필수 |
verificationCode | string | 카카오톡으로 받은 6자리 인증번호 | 필수 |
phoneNumber | string | 인증에 사용한 전화번호 | 필수 |
연동 응답 형식
인증번호 요청 성공 시 다음과 같은 응답을 받습니다:
{
"code": 200,
"message": "성공",
"data": {
"requestId": "verification-request-id-12345"
}
}
채널 등록 성공 시 다음과 같은 응답을 받습니다:
{
"code": 200,
"message": "성공",
"data": {
"id": "alipeople",
"channelId": "alipeople",
"channelName": "(주) 알리는 사람들",
"status": "ACTIVE"
}
}
연동 실패 원인 및 해결 방법
실패 원인 | 해결 방법 |
---|---|
비즈니스 인증이 완료되지 않은 채널 | 카카오 비즈니스 센터에서 비즈니스 인증 완료 |
채널 관리자가 아닌 경우 | 채널 관리자에게 권한 요청 |
채널이 비공개 상태인 경우 | 채널 설정에서 공개 상태로 변경 |
고객센터 정보가 없는 경우 | 채널 정보에 고객센터 정보 추가 |
다른 중계사에 등록된 채널 | 센드온 고객센터에 문의 |
주의사항
-
인증번호 유효 시간
- 인증번호는 발급 후 일정 시간 내에 사용해야 합니다.
- 시간이 초과된 경우 새로운 인증번호를 요청해야 합니다.
-
다른 중계사 등록 여부
- 하나의 카카오 채널은 일반적으로 하나의 메시지 중계사에만 등록할 수 있습니다.
- 다른 중계사에 등록된 채널을 센드온에 등록하려면 센드온 고객센터에 문의하세요.
-
채널 설정 변경
- 발신 프로필로 등록된 채널의 설정(공개 여부, 고객센터 정보 등)을 변경하면 메시지 발송에 문제가 발생할 수 있습니다.
-
채널 연동 해제
- 채널 연동 해제 기능은 현재 준비 중입니다.
관련 링크
Updated 17 days ago