카카오 발신 프로필(채널) 관리하기

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

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

채널과 메시지 발송

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

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

채널 목록 조회

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

async function getSendProfiles() {
  const result = await sendon.kakao.getSendProfiles();
  
  console.log('채널 목록:', result);
  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; // 채널 ID
  
  const result = await sendon.kakao.getSendProfile(sendProfileId);
  
  console.log('채널 상세 정보:', result);
  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"
  }
}

채널 상태

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

상태	설명
활성	활성 상태로 정상적으로 메시지 발송이 가능합니다.
비활성	비활성 상태로 카카오톡 채널 관리자 페이지에서 확인이 필요합니다.
휴면	휴면 상태로 센드온 담당자를 통해 확인이 필요합니다.
차단	차단 상태로 센드온 담당자를 통해 확인이 필요합니다.
삭제	삭제 상태로 카카오톡 채널 관리자 페이지에서 확인이 필요합니다.
삭제 중	삭제 진행 중인 상태로 카카오톡 채널 관리자 페이지에서 확인이 필요합니다.

채널 관리

채널 사용 주의사항

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

채널 연동 해제

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