# 카카오 채널 연동하기


<Image align="center" src="https://files.readme.io/7702a74b607cdabf937524739bb242bd052e1ca1241b14b1c73b1ffd4fe8d0fd-link.png" />

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

## 연동 전 준비사항

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

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

## 연동 절차

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

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

### 1. 인증번호 요청

카카오 채널 등록을 위한 인증번호를 요청합니다. 인증번호는 채널 관리자의 카카오톡으로 발송됩니다.

```typescript
async function requestChannelAuthToken() {
  const channelId = YOUR_CHANNEL_ID; // @ 없이 입력해도 됩니다.
  const phoneNumber = YOUR_PHONE_NUMBER; // 인증 알림톡을 받을 번호

  const result = await sendon.kakao.requestAuthToken({
    channelId,
    phoneNumber,
  });

  console.log("인증번호 요청 결과:", JSON.stringify(result, null, 2));
  return result;
}
```

> **참고**: 인증번호는 카카오톡으로 전송되는 6자리 숫자로, PC 카카오톡에서는 확인이 불가능하며 모바일 카카오톡에서만 확인할 수 있는 보안 메시지입니다.

<br />

| 파라미터    | 타입   | 설명                                | 필수 여부 |
| ----------- | ------ | ----------------------------------- | --------- |
| channelId   | string | 카카오 채널 ID (\"alipeople\" 형식) | 필수      |
| phoneNumber | string | 인증번호를 수신할 전화번호 (숫자만) | 필수      |

<br />

### 2. 인증번호를 사용한 채널 등록

카카오톡으로 받은 인증번호를 사용하여 채널을 센드온에 등록합니다.

```typescript
async function registerChannel() {
  const channelId = YOUR_CHANNEL_ID;
  const phoneNumber = YOUR_PHONE_NUMBER;
  const verificationCode = VERIFICATION_CODE; // 카카오톡으로 받은 6자리 숫자

  const result = await sendon.kakao.registerChannel({
    channelId,
    phoneNumber,
    verificationCode,
    // categoryCode: '01800030001', // 필요한 경우 카테고리 지정
    // id: 'custom-tracking-id',    // 등록 프로세스 추적용 선택값
  });

  console.log("채널 등록 결과:", JSON.stringify(result, null, 2));
  return result;
}
```

<br />

| 파라미터         | 타입   | 설명                                                  | 필수 여부 |
| ---------------- | ------ | ----------------------------------------------------- | --------- |
| channelId        | string | 카카오 채널 ID                                        | 필수      |
| verificationCode | string | 카카오톡으로 수신한 6자리 인증번호                    | 필수      |
| phoneNumber      | string | 인증에 사용한 전화번호                                | 필수      |
| categoryCode     | string | 카카오 비즈니스 카테고리 코드 (미입력 시 기본값 적용) | 선택      |
| id               | string | 등록 프로세스 추적을 위한 임의 ID (로그/추적에 활용)  | 선택      |

<br />

## 연동 응답 형식

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

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

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

```json
{
  "code": 200,
  "message": "성공",
  "data": {
    "id": "SEND_PROFILE_ID",
    "channelId": "CHANNEL_ID",
    "channelName": "센드온",
    "status": "ACTIVE"
  }
}
```

## 연동 실패 원인 및 해결 방법

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

## 주의사항

1. **인증번호 유효 시간**

   - 인증번호는 발급 후 일정 시간 내에 사용해야 합니다.
   - 시간이 초과된 경우 새로운 인증번호를 요청해야 합니다.

2. **다른 중계사 등록 여부**

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

3. **채널 설정 변경**

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

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

## 관련 링크

- [카카오 비즈니스 채널 가이드](https://business.kakao.com/info/bizplusfriend/)
- [카카오 알림톡 발송하기](../메시지 발송하기/kakao-send-at)
- [카카오 브랜드메시지 발송하기](../메시지 발송하기/kakao-send-brand-message)
- [카카오 채널 관리하기](./카카오-채널-관리하기)