설치 매뉴얼
카카오 알림톡 대행사 선정
카카오 알림톡을 통해 메시지를 보내기 위해선 알림톡 서비스를 제공하는 대행사와 계약이 필요합니다. 현재 Logpresso Sonar 에서 지원하는 알림톡 대행사는 다음과 같습니다.
상기 대행사와 계약을 진행한 뒤 알림톡 사용에 필요한 정보를 발급 받고 통신을 위한 방화벽 정책 허용 과정을 진행합니다.
접속 프로파일 설정
알림톡 사용을 위해선 다음 정보 입력이 필요합니다.
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 이름 | kakaotalk |
| 필수 | 식별자 | kakaotalk |
| 필수 | 유형 | 카카오톡(대행사명) |
| 필수 | 앤드포인트 | 제공받은 도메인 정보 |
| 필수 | 클라이언트 ID | 계약 시 발급 받은 클라이언트 ID |
| 필수 | 클라이언트 시크릿 | 계약 시 발급 받은 클라이언트 시크릿 |
| 필수 | MNG 클라이언트 ID | 계약 시 발급 받은 MNG 클라이언트 ID |
| 필수 | MNG 클라이언트 시크릿 | 계약 시 발급 받은 MNG 클라이언트 시크릿 |
| 필수 | 발신프로필 키 | 계약 시 발급 받은 발신프로필 키 |
| 필수 | 발신번호 | 고객센터 번호 권장 |
| 선택 | HTTP 프록시 | IP:포트 |
| 선택 | 접속 타임아웃 | 30 |
| 선택 | 읽기 타임아웃 | 30 |
앤드포인트는 운영과 검증용 도메인을 구분하여 주의해서 입력합니다. 검증용 도메인의 경우도 실제 메시지가 발송되니 확장 명령어 테스트 시 주의가 필요합니다.
메시지 템플릿 관리
카카오 알림톡을 사용하기 위해선 카카오톡 메시지 템플릿이 필요합니다. 해당 템플릿은 카카오톡 알림톡 대행사의 관리페이지를 통해 등록할 수 있으며 검수 과정을 거쳐 승인된 템플릿만 사용할 수 있습니다.
다음은 카카오톡 (디케이테크인) 템플릿 관리 페이지 예시입니다.
메시지 템플릿 등록
현재 Logpresso Sonar 에선 내부 업무 알림 메시지에 적합한 "기본형/강조유형 선택안함" 템플릿만 지원합니다. 템플릿 등록은 각 대행사에서 발행하는 템플릿 등록 가이드를 참고하여 진행합니다.
다음은 카카오톡 (디케이테크인) 템플릿 등록 페이지 예시입니다.
내용 작성 시 치환 문자 "#{치환변수명}" 는 kakaotalk-send-batch 확장 명령어 사용 시 동일한 필드명과 치환이 되는 부분입니다. 템플릿 내용 작성 시, 이 점을 고려하여 작성합니다. 템플릿은 치환될 문자까지 포함하여 1,300 자를 초과할 수 없습니다.
Tip
#{content} 와 같이 단순 치환 문자만 배치한 템플릿은 검수 시 반려될 가능성이 높습니다. 메시지의 목적을 알 수 있도록 템플릿 내용을 구체적으로 작성합니다.