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

센드온에 등록된 카카오 발신 프로필을 조회하고 관리하는 방법을 안내합니다.

발신 프로필은 카카오 메시지 발송 시 발신자 정보로 사용되며, 각 발신 프로필은 고유한 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;
}

발신 프로필 상세 조회 파라미터

파라미터타입설명필수 여부
sendProfileIdstring조회할 발신 프로필 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"
  }
}

발신 프로필 상태

발신 프로필은 다음과 같은 상태값을 가질 수 있습니다:

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

발신 프로필 관리

발신 프로필 사용 주의사항

  1. 발신 프로필 ID 사용

    • 메시지 발송 시 sendProfileId 파라미터에 발신 프로필 ID를 지정합니다.
    • 발신 프로필 ID는 발신 프로필 목록 조회를 통해 확인할 수 있습니다.
  2. 채널 설정 변경 주의

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

    • 비활성화된 프로필로는 메시지를 발송할 수 없습니다.
    • 프로필이 비활성화된 경우 상태에 따라 카카오톡 채널 관리자 페이지나 센드온 고객센터에 문의하여 원인을 파악해야 합니다.

발신 프로필 연동 해제

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

관련 링크