DXCMS 카카오 알림톡 플러그인 설치 가이드

플러그인 구조

kakao-alimtalk/
├── manifest.php                          ← 플러그인 메타 정보
├── plugin.php                            ← 메인 로직 + 공개 API 함수
├── drivers/
│   ├── DxAlimtalkDriverInterface.php     ← 드라이버 인터페이스
│   ├── DxAlimtalkAligoDriver.php         ← 알리고 드라이버
│   └── DxAlimtalkCoolsmsDriver.php       ← CoolSMS 드라이버
├── admin/
│   └── settings.php                      ← 관리자 설정 패널 UI
└── 설치가이드.md

설치 방법

1단계 — 플러그인 폴더 복사

kakao-alimtalk/ 폴더 전체를 DXCMS plugins/ 폴더 안에 복사합니다.

{설치경로}/plugins/kakao-alimtalk/

2단계 — 관리자 패널에서 활성화

관리자 패널 → 플러그인 → 카카오 알림톡 → 활성화

3단계 — 카카오 비즈니스 채널 준비

4단계 — 플러그인 설정

관리자 패널 → 플러그인 → 카카오 알림톡 → 설정
→ 딜러사 선택: 알리고 또는 CoolSMS
→ API 키 / Sender Key / 발신번호 입력
→ 설정 저장
→ 테스트 발송으로 확인

코드에서 사용하기

단건 발송

// 주문 완료 알림 예시
dx_alimtalk_send('01012345678', 'ORDER_COMPLETE', array(
    '주문번호' => 'ORD-20260823-001',
    '상품명'   => '청바지',
    '금액'     => '39,000원',
    '배송지'   => '서울시 강남구',
));

결과 처리

$result = dx_alimtalk_send('01012345678', 'ORDER_COMPLETE', $vars);

if ($result['success']) {
    // 발송 성공
} else {
    // 발송 실패: $result['message']
}

대량 발송

dx_alimtalk_send_bulk(array(
    array('to' => '01011112222', 'vars' => array('이름' => '홍길동', '포인트' => '1,000P')),
    array('to' => '01033334444', 'vars' => array('이름' => '김철수', '포인트' => '2,500P')),
), 'POINT_NOTI');

템플릿 변수 치환 헬퍼

$template = '안녕하세요 #{이름}님, #{포인트}가 적립되었습니다.';
$message  = dx_alimtalk_bind($template, array('이름' => '홍길동', '포인트' => '1,000P'));
// 결과: "안녕하세요 홍길동님, 1,000P가 적립되었습니다."

훅 활용

// 발송 전 가로채기 (false 반환 시 발송 취소)
dx_add_hook('dx_alimtalk_before_send', function($to, $templateCode, $vars) {
    if ($templateCode === 'SKIP_THIS') return false;
});

// 발송 후 처리
dx_add_hook('dx_alimtalk_after_send', function($to, $templateCode, $vars, $result) {
    if (!$result['success']) {
        // 실패 시 슬랙 알림 등
    }
});

딜러사별 사전 준비 요약

알리고 (Aligo)

1. https://smartsms.aligo.in 가입
2. 마이페이지 > API Key 발급
3. 카카오알림톡 > 발신프로필 등록 → Sender Key 확인
4. 알림톡 템플릿 등록 및 승인 대기

CoolSMS

1. https://coolsms.co.kr 가입
2. 콘솔 > 개발정보 > API Key 관리 > 키 발급
3. 콘솔 > 카카오채널 > 채널 등록 → pfId 확인
4. 알림톡 템플릿 등록 및 승인 대기

발송 로그 위치

{설치경로}/data/logs/alimtalk_YYYY-MM.log

주의사항

• 알림톡은 카카오 검수를 통과한 템플릿만 발송 가능합니다.
• 광고성 메시지는 친구톡(FT) 으로 별도 신청해야 합니다.
• 발신번호는 딜러사에 사전 등록이 필요합니다.
• 대체문자(SMS) 발송 시 추가 요금이 발생합니다.

라이선스

디자인원엑스 라이선스 참고
https://designonex.com/notice/view/1787577858493247