카카오 채널 관리하기

센드온에 등록된 카카오 채널을 조회하고 관리하는 방법을 안내합니다.

채널은 카카오 메시지 발송 시 발신자 정보로 사용되며, 각 채널은 고유한 ID를 가집니다.

채널과 메시지 발송

카카오 메시지 발송 시 사용되는 sendProfileId는 등록된 채널의 ID입니다. 알림톡이나 브랜드메시지 발송 시 다음과 같이 채널 ID를 지정합니다:

await sendon.kakao.sendAlimTalk({
  sendProfileId: 'SEND_PROFILE_ID',  // 채널 ID
  // 다른 필수 파라미터들...
});

채널 목록 조회

센드온에 등록된 모든 카카오 채널 목록을 조회합니다.

async function getSendProfiles() {
  const result = await sendon.kakao.getSendProfiles()

  console.log('채널 목록:', JSON.stringify(result, null, 2))
  return result
}

채널 목록 조회 시 다음과 같은 응답을 받습니다:

{
  "code": 200,
  "message": "성공",
  "data": [
    {
      "id": "SEND_PROFILE_ID",
      "channelId": "SEND_PROFILE_ID",
      "channelName": "센드온",
      "status": "ACTIVE",
      "profileStatus": "ACTIVATED",
      "createdAt": "2024-06-07T04:51:15.661Z",
      "updatedAt": "2024-06-07T04:51:15.661Z"
    }
  ]
}

채널 상세 정보 조회

특정 채널의 상세 정보를 조회합니다.

async function getSendProfileDetails() {
  const sendProfileId = SEND_PROFILE_ID

  const result = await sendon.kakao.getSendProfile(sendProfileId)

  console.log('채널 상세 정보:', JSON.stringify(result, null, 2))
  return result
}

채널 상세 조회 파라미터

파라미터	타입	설명	필수 여부
sendProfileId	string	조회할 채널 ID	필수

채널 상세 조회 시 다음과 같은 응답을 받습니다:

{
  "code": 200,
  "message": "성공",
  "data": {
    "id": "SEND_PROFILE_ID",
    "channelId": "SEND_PROFILE_ID",
    "channelName": "센드온",
    "status": "ACTIVE",
    "profileStatus": "ACTIVATED",
    "createdAt": "2024-06-07T04:51:15.661Z",
    "updatedAt": "2024-06-07T04:51:15.661Z"
  }
}

채널 상태

채널은 다음과 같은 상태값을 가질 수 있습니다:

상태(상태코드)	설명
ACTIVE	정상 사용 중으로 메시지 발송이 가능합니다.
SUSPENDED	카카오 측 제재나 설정 문제로 일시 중단된 상태입니다. 원인을 확인해 복구해야 합니다.
DELETED	채널이 삭제된 상태입니다. 재등록이 필요합니다.

프로필 상태

프로필 상태(상태코드)	설명
ACTIVATED	발신프로필이 활성화되어 발송이 가능합니다.
DEACTIVATED	비활성화된 상태로 카카오 관리자센터에서 조치가 필요합니다.
BLOCKED	차단된 상태입니다. 센드온 고객센터에 문의해 주세요.
DELETING	삭제가 진행 중인 상태입니다.
DELETED	삭제가 완료된 상태입니다.

채널 관리

채널 사용 주의사항

채널 ID 사용
- 메시지 발송 시 sendProfileId 파라미터에 채널 ID를 지정합니다.
- 채널 ID는 채널 목록 조회를 통해 확인할 수 있습니다.
채널 설정 변경 주의
- 채널로 등록된 채널의 설정(공개 여부, 고객센터 정보 등)을 변경하면 메시지 발송에 문제가 발생할 수 있습니다.
비활성화된 프로필
- 비활성화된 프로필로는 메시지를 발송할 수 없습니다.
- 프로필이 비활성화된 경우 상태에 따라 카카오톡 채널 관리자 페이지나 센드온 고객센터에 문의하여 원인을 파악해야 합니다.

채널 연동 해제

채널 연동 해제 기능은 현재 준비 중입니다. 연동 해제가 필요한 경우 센드온 고객센터로 문의하시기 바랍니다.