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

카카오 비즈니스 채널을 센드온과 연동하여 알림톡 및 친구톡 발송에 활용할 수 있습니다. 이 문서에서는 카카오 채널을 센드온에 연동하는 절차와 방법에 대해 안내합니다.

연동 전 준비사항

카카오 채널 연동을 위해서는 다음 조건이 충족되어야 합니다:

  1. 카카오 비즈니스에 채널을 등록하고 비즈니스 인증을 완료해야 함
  2. 채널 관리자 권한이 있어야 함
  3. 채널이 공개 설정되어 있어야 함
  4. 채널 정보에 고객센터 정보가 포함되어 있어야 함

연동 절차

카카오 채널을 센드온에 연동하는 절차는 다음과 같습니다:

  1. 인증번호 요청
  2. 카카오톡으로 받은 인증번호 확인
  3. 인증번호를 사용하여 채널 등록

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 카카오톡에서는 확인이 불가능하며 모바일 카카오톡에서만 확인할 수 있는 보안 메시지입니다.


파라미터타입설명필수 여부
channelIdstring카카오 채널 ID필수
phoneNumberstring인증에 사용할 전화번호필수

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;
}

파라미터타입설명필수 여부
channelIdstring카카오 채널 ID필수
verificationCodestring카카오톡으로 받은 6자리 인증번호필수
phoneNumberstring인증에 사용한 전화번호필수

연동 응답 형식

인증번호 요청 성공 시 다음과 같은 응답을 받습니다:

{
  "code": 200,
  "message": "성공",
  "data": {
    "requestId": "verification-request-id-12345"
  }
}

채널 등록 성공 시 다음과 같은 응답을 받습니다:

{
  "code": 200,
  "message": "성공",
  "data": {
    "id": "alipeople",
    "channelId": "alipeople",
    "channelName": "(주) 알리는 사람들",
    "status": "ACTIVE"
  }
}

연동 실패 원인 및 해결 방법

실패 원인해결 방법
비즈니스 인증이 완료되지 않은 채널카카오 비즈니스 센터에서 비즈니스 인증 완료
채널 관리자가 아닌 경우채널 관리자에게 권한 요청
채널이 비공개 상태인 경우채널 설정에서 공개 상태로 변경
고객센터 정보가 없는 경우채널 정보에 고객센터 정보 추가
다른 중계사에 등록된 채널센드온 고객센터에 문의

주의사항

  1. 인증번호 유효 시간

    • 인증번호는 발급 후 일정 시간 내에 사용해야 합니다.
    • 시간이 초과된 경우 새로운 인증번호를 요청해야 합니다.
  2. 다른 중계사 등록 여부

    • 하나의 카카오 채널은 일반적으로 하나의 메시지 중계사에만 등록할 수 있습니다.
    • 다른 중계사에 등록된 채널을 센드온에 등록하려면 센드온 고객센터에 문의하세요.
  3. 채널 설정 변경

    • 발신 프로필로 등록된 채널의 설정(공개 여부, 고객센터 정보 등)을 변경하면 메시지 발송에 문제가 발생할 수 있습니다.
  4. 채널 연동 해제

    • 채널 연동 해제 기능은 현재 준비 중입니다.

관련 링크