SMS, KAKAO 서비스 (비즈뿌리오)

Owned by SCADAPRO
Last updated: Nov 13, 2024
10 min read

SMS, 카카오 통신 드라이버 소개

해당 드라이버를 통해 설정된 유저에게 SMS문자, 카카오 알림톡 메세지를 전송할 수 있습니다.

 

통신 드라이버 설치

  1. Driver.lst 파일 내용은 아래와 같습니다. (1장 7쪽 참조.)

CmWebSMS, CmWebSMS.dll, Web 문자전송서비스

  1. Web 문자 메시지 서비스를 제공하는 Web Hosting 업체에 가입을 합니다.

지정된 Web Hosting 업체에 가입을 합니다.    

지정된 업체는 "비즈뿌리오" 입니다. (홈페이지 : https://www.bizppurio.com/ )

  1. SMS Hosting 서비스를 신청 합니다.

  • Web Hosting 업체에 가입 후 별도의 SMS Hosting을 신청하셔야 합니다.

  (요금 방식은 선불, 후불 모두 가능하나 후불방식을 권장 드립니다.)

-기존 호스팅 업체보다 더 안정적인 인프라를 갖춘 Hosting 서비스를 제공합니다.

  • SMS Hosting을 신청시 ID와 PASSWORD를 등록합니다.  

(ID 등록시 꼭 영문으로 등록을 하셔야 정상 동작 합니다.)

  • 등록된 ID와 PASSWORD를 가지고 CIMON-SCADA에 I/O디바이스 설정을 합니다.

 

  • 1.0.17 버전 이전에 설정된 통신 드라이버 설정이 존재한다면 반드시 기존 설정을 삭제 후 설정해주시기 바랍니다.

  • SCADA V3.91 이전 버전에서 작성된 작화 프로젝트를 업그레이드 하셨다면 해당 프로젝트 내 통신 드라이버 설정을 반드시 삭제 후 재 설정 해주시기 바랍니다.

  • 홈페이지에 가입되지 않은 아이디, 패스워드를 입력 시 정상 동작 하지 않을 수 있습니다.

 

비즈 뿌리오 서비스 이용간 사전 조치 사항 - 공통

  1. 비즈뿌리오 (https://www.bizppurio.com ) 홈페이지 접속 후 법인 명의로 회원가입

    • 가입시 모듈 연동 방식으로 반드시 “URL API연동” 선택

    • 요금제 선택 또한 후불 요금제로 선택 진행

    • 회원 가입 후 서비스 영업 담당자 (1599-9782)에게 연락하여 승인 요청

    • ‘승인’ 처리는 담당자 확인 후 1주일 내로 처리 진행

  2. 서비스 가입 신청서 작성 후 스캔본 담당자 이메일로 회신

    • 가입 신청서 작성시 후불(자동이체) 선택 권장

    • 후불 결제와 관련된 모든 내용 작성 권장

    • 서비스 신청 내용에 Master ID는 홈페이지 가입시 사용한 아이디 기입

    • 담당자 메일 정보: hjk2881@daou.co.kr

  3. 가입신청서 원본, 법인(사용)인감날인증명서 담당자에게 등기 발송

  • 주소: ㈜다우기술 경기도 성남시 수정구 금토로 69, 10층(금토동, 다우디지털스퀘어) 비즈메세징사업팀 김현진 책임

  1. 발신번호 사전 등록 (SMS)

    • 비즈뿌리오 홈페이지 로그인 후 [메시지 관리]▶[발신번호 관리] 클릭

    • 발신번호로 사용할 번호를 사전에 등록

    • 가.png

    • 반드시 발신에 사용할 번호를 입력하여 등록

    • 사업자등록증, 해당 발신번호 통신사가입증명서 업로드 등록

    • 등록 이후 승인 조치가 영업일 1일 내로 확인하여 승인 조치 확인

    • 나.png

  2. 담당자 통해 SCADA 프로젝트가 동작하는 현장 사이트의 공인아이피 주소를 화이트리스트에 등록

    • 위 발신 번호 등록까지 승인되면 문자를 발송하는 현장 사이트의 공인 아이피를 사전에 등록하여야 안전한 문자 송신 진행 가능

    • 서비스 영업 담당자(김현진 책임 010-9190-2881)에게 문자 서비스를 동작하는 현장의 공인아이피 정보를 전달

    • 공인 아이피 등록은 복수로 등록 가능

    • 비즈뿌리오 홈페이지 로그인 후 [Biz Lounge]▶[모듈연동 환경설정] 클릭 아래 이미지와 같이 공인 아이피가 등록되었는지 최종 확인

비즈 뿌리오 서비스 이용간 사전 조치 사항 - 카카오 알림톡

  • 카카오 알림톡은 미리 개설된 카카오 비즈니스 채널 계정을 통해 개별 수신자 에게 메세지를 보내는 서비스로 일반 사용자 계정으로 알림톡은 제한됩니다.

  1. 비즈뿌리오 알림톡 서비스를 사용 하기 전 아래 문서에 나온 절차에 따라 카카오 비즈니스 채널 개설과 필요한 사전 설정을 미리 진행합니다.

    • 위 이용 가이드의 18p 참고

  2. 비즈뿌리오 홈페이지 로그인 후 [메세지 관리]▶[카카오톡 관리] ▶[발신 프로필 관리] 클릭 아래 이미지와 같이 등록 버튼을 눌러 사전에 미리 개설된 비즈니스 채널을 등록합니다.

  3. 등록된 카카오톡 채널의 상태가 위와 같이 정상인지 확인 하고 비정상 상태 일시 관리자에게 문의하여 사전 조치

    • 발신프로필 Key는 알림톡 발송을 위한 고유 키값으로 외부에 공개되지 않도록 관리

  4. [메세지 관리]▶[카카오톡 관리] ▶[알림톡 템플릿 관리] 클릭하여 발신프로필 상태 확인

    • ‘발신프로필' ‘발신프로필/그룹’ 에서 생성된 프로필을 선택

  5. 하단의 파란 등록 버튼을 눌러 발신하려는 템플릿의 형식을 등록

    • 템플릿 코드 생성은 자동생성 을 반드시 선택

    • 템플릿 명은 용도에 맞는 이름을 설정하여 기입 (ex: 화재경보메세지발송)

    • 템플릿 카테고리는 용도에 맞는 항목 선택하여 설정

    • 강조 유형은 선택 안함 외 다른 항목은 지원하지 않음

    • 템플릿 내용에 고정 값과 변수값을 지정하여 발송내용 지정

      • 알림톡 템플릿 내용 구성은 카카오에서 정한 기준에 따라 작성 되어야 하며 이를 위반한 내용이 기재될시 서비스 제공자가 템플릿 검수시 반려 처리되어 사용 할 수 없음 아래 링크의 알림톡 등록 기준에 관한 내용 참고 바랍니다.

      • 알림톡 템플릿 심사 기준

    • 미리보기 메세지는 최초 수신자가 볼 수 있는 정보로 검수대상입니다.

    • 버튼 기능은 현재 통신드라이버에서 제공하지 않는 기능입니다.

  6. 최종 등록된 템플릿이 검수 이후 상태가 ‘사용가능’ 으로 바뀔 시 해당 템플릿 코드를 통해 SCADA에서 메세지 발송가능

기본 설정

스테이션 설정

 

내용

스테이션 이름

  • 스테이션을 구별할 수 있는 이름을 입력합니다. 디폴트 값은 “STATION”으로 입력됩니다..

스테이션 종류

  • 사용하시는 WEB SMS 서비스를 선택합니다.

  • 비즈뿌리오사의 서비스를 이용하기 위해 비즈뿌리오 선택

스테이션 설명

  • 스테이션에 대한 간략한 설명을 입력합니다.

SMS 사용자 계정

  • 법인 으로 가입된 WEB 서비스 계정 ID를 입력합니다.

SMS 암호

  • 가입된 서비스 계정의 암호를 입력합니다.

 

내용

발신 번호

  • SMS를 전송할 전화번호를 입력합니다.

  • 반드시 승인 완료 처리된 발신번호를 입력 해야 정상 동작합니다.

  • 카카오 알림톡을 이용시에도 해당 번호를 입력해야 동작합니다.

재시도 횟수

  • 전송 실패 시 재시도 횟수를 지정합니다.

발신 프로필 키

  • 비즈뿌리오에 등록한 카카오톡 비즈니스 채널의 고유 프로필 값을 입력.

템플릿 코드

  • 전송할 알림톡의 지정된 템플릿 코드를 입력합니다.

연락처/그룹/메시지 설정

 문자 메시지 정보는 연락처, 그룹, 메시지 3 부분으로 구성되어 있습니다. 연락처는 문자 메시지를 수신할 사람의 이름과 전화번호를 입력합니다. 그룹은 연락처들의 그룹으로 동시에 같은 메시지를 여러 사람에게 송신할 경우에 설정합니다. 메시지는 송신할 메시지를 미리 등록해 두는 것입니다.

마우스 오른쪽 버튼을 이용하여 그룹, 연락처 및 메시지를 추가, 수정, 삭제할 수 있습니다.

연락처 추가/편집

연락처 리스트 화면에서 삭제할 항목을 선택한 후 Delete 버튼 또는 메뉴에서 연락처 삭제를 선택하면 위와 같이 확인 대화상자가 표시되며 ‘예’를 누르면 선택된 연락처가 삭제됩니다.

연락처 복사/이동

마우스 오른쪽 버튼을 이용하여 연락처를 다른 그룹으로 복사하거나 이동할 수 있습니다.

그룹추가를 선택하면 트리에 새그룹이 추가되고 편집할 수 있습니다.

그룹 추가/편집

 

내용

그룹 수정

  • 그룹이름을 수정합니다.

그룹 삭제

  • 그룹을 삭제합니다. 그룹에 포함된 연락처들은 모두 삭제됩니다.

메세지 추가/편집

 

내용

메시지 ID

  • 메시지를 구분할 수 있는 ID를 입력합니다. (1 – 32767).

문자 메시지

  • 전송할 문자 메시지를 입력합니다. (최대 90자)

  • SMS 서비스 는 최대 90자 까지 입력 가능

  • 알림톡 서비스는 최대 1000자 까지 입력 가능

메시지 리스트 화면에서 삭제할 항목을 선택한 후 삭제 버튼을 누르면 위와 같이 확인 대화상자가 표시되며 ‘예’를 누르면 선택된 메시지가 삭제됩니다.

문자 메세지 송신 방법

DriverCommand 내부함수를 이용해서 문자 메시지를 송신합니다. 문자 메시지 서비스 통신드라이버의 DriverCommand 사용 방법은 다음과 같습니다.

  • 카카오톡 알림톡 발송시 메세지 내용에 #, {, } 와 같은 특수기호를 사용 할 수 없습니다.

  • SMS, 카카오톡의 송신 요청의 성공 여부와 실제 수신자가 메세지를 받았는지 여부는 일치하지 않을 수 있습니다.

DriverCommand

 

내용

형식

DriverCommand("디바이스이름.스테이션이름", Command, "Parameter")

설명

문자 메시지 통신 드라이버에게 Command에 해당하는 명령을 실행 시킵니다

매개변수

명령의 종류에 해당하는 Command와 값에 따른 Parameter의 형태는 다음과 같습니다.

Command     

 명령 번호

내용

1

등록된 그룹에게 등록된 SMS메시지를 송신합니다.

2

등록된 그룹에게 사용자가 지정한 SMS메시지를 송신합니다.

3

등록된 연락처에게 등록된 SMS메시지를 송신합니다.

4

등록된 연락처에 사용자가 지정한 SMS메시지를 송신합니다.

5

사용자가 지정한 번호로 등록된 SMS메시지를 송신합니다.

6

사용자가 지정한 번호로  지정한 SMS메시지를 송신합니다.

7

등록된 그룹에게 등록된 카카오 알림톡을 송신합니다.

8

등록된 그룹에 사용자가 지정한 카카오 알림톡을 송신합니다.

9

등록된 연락처에게 등록된 카카오 알림톡을 송신합니다.

10

등록된 연락처에게 사용자가 지정한 카카오 알림톡을 송신합니다.

11

사용자가 지정한 번호로 등록된 카카오 알림톡을 송신합니다.

12

사용자가 지정한 번호로 사용자가 지정한 카카오 알림톡을 송신합니다.

Parameter

Command가

1,7일 경우 : “그룹이름,메시지ID”

2,8일 경우 : “그룹이름,사용자메시지”

3,9일 경우 :    “연락처,메시지ID”

4,10일 경우 : “연락처,사용자메시지”

5,11일 경우 : “전화번호,메시지ID”

6,12일 경우 : “전화번호,사용자메시지”

 

사용 예시  

명령식

DriverCommand("SMS.STATION", 1, "관리,7")

설명

그룹이 “관리”인 그룹에 속한 모든 구성원에게 메시지 ID가 7번인 메시지를 송신합니다.

명령식

DriverCommand("SMS.STATION", 2, "담당자,주전류 경보발생")

설명

그룹이름이 “담당자”인 그룹에 속한 모든 구성원에게 “주전류 경보발생”이라는 메시지를 송신합니다.

명령식

DriverCommand("SMS.STATION", 3, "홍길동,5")

설명

“홍길동”이란 이름으로 등록된 연락처에게 메시지 ID가 5번인 메시지를 송신합니다.

명령식

DriverCommand("SMS.STATION", 4, "관리자, 1구역 정전")

설명

“관리자”란 이름으로 등록된 연락처에게 “1구역 정전”이라는 메시지를 송신합니다.

명령식

DriverCommand("SMS.STATION", 5, "01112345678,2")

설명

“01112345678”인 전화번호로 메시지 ID가 2번인 메시지를 송신합니다.

명령식

DriverCommand("SMS.STATION", 6, "01112345678, 고수위 경보 발생")

설명

“01112345678”인 전화번호로 “고수위 경보 발생”이라는 메시지를 송신합니다.

명령식

DriverCommand("SMS.STATION", 7, "관리,7")

설명

그룹이름이 “관리”인 그룹에 속한 모든 구성원에게 메시지 ID가 7번인 알림톡 메시지를 송신합니다.

명령식

DriverCommand("SMS.STATION", 8, "담당자,주전류 경보발생")

설명

그룹이름이 “담당자”인 그룹에 속한 모든 구성원에게 “주전류 경보발생”이라는 알림톡 메시지를 송신합니다.

명령식

DriverCommand("SMS.STATION", 9, "홍길동,5")

설명

“홍길동”이란 이름으로 등록된 연락처에게 메시지 ID가 5번인 알림톡 메시지를 송신합니다.

명령식

DriverCommand("SMS.STATION", 10, "관리자, 1구역 정전")

설명

“관리자”란 이름으로 등록된 연락처에게 “1구역 정전”이라는 알림톡 메시지를 송신합니다.

명령식

DriverCommand("SMS.STATION", 11, "01112345678,2")

설명

“관리자”란 이름으로 등록된 연락처에게 “1구역 정전”이라는 알림톡 메시지를 송신합니다.

명령식

DriverCommand("SMS.STATION", 12, "01112345678, 고수위 경보 발생")

설명

“01112345678”인 전화번호로 “고수위 경보 발생”이라는 알림톡 메시지를 송신합니다.

 (참고) 태그의 경보가 발생하였을 때 문자 메시지를 송신하려면 태그의 경보 동작에 위와 같은 형태의 내부함수로 등록해 주면 됩니다.

 

체크 리스트 - SMS

SMS 송신 요청이 실패 했거나 송신 요청은 성공 하였으나 최종발신자에게 메세지가 전달 되지 않을 시 아래

체크리스트를 확인하여 주시기 바랍니다.

  

체크 리스트 - 카카오 알림톡

에러코드 리스트

에러코드

내용

2000

메시지가 유효하지 않음

3000

비즈 뿌리오 계정에 접속 허용 아이피가 등록되어있지 않음

3001

인증 토큰 발급 호출 시, Basic Authentication 정보가 유효하지 않음

3002

토큰이 유효하지 않음

3003

아이피가 유효하지 않음

3004

계정이 유효하지 않음

3005

인증 정보가 유효하지 않음 (bearer)

3006

비즈뿌리오 계정이 존재하지 않음

3007

비즈뿌리오 계정의 암호가 유효하지 않음

3008

비즈뿌리오에 허용된 접속 수를 초과함

3009

비즈뿌리오 계정이 중지 상태임

3010

비즈뿌리오 계정에 등록된 접속 허용 IP와 일치하지 않음

3011

비즈뿌리오 내에서 알 수 없는 오류가 발생됨

3012

비즈뿌리오에 존재하지 않은 메시지 (예: 보관 주기 35일이 지난 메시지)

3013

완료 처리 되지 않은 메시지 (예: 통신사로부터 결과 미 수신)

5000

발송 결과 재 요청 실패

5001

요청한 URI 리소스가 존재하지 않음

5003

알 수 없는 오류 발생

5004

너무 많은 커넥션

5005

알 수 없는 오류 발생

9000

알 수 없는 오류 발생

9070

선불 잔액 부족

4400

SMS 음영 지역

4401

SMS 단말기 전원 꺼짐

4402

SMS 단말기 메시지 저장 초과

4403

SMS 메시지 삭제 됨

4404

SMS 가입자 위치 정보 없음

4405

SMS 단말기 BUSY

4410

SMS 잘못된 번호

4420

SMS 기타에러

4430

SMS 스팸

4431

SMS 발송 제한 수신거부(스팸)

4411

SMS NPDB 에러

4412

SMS 착신거절

4413

SMS SMSC 형식오류

4414

SMS 비가입자, 결번, 서비스정지

4415

SMS 식별코드 오류

4421

SMS 타임아웃

4422

SMS 단말기 일시정지

4423

SMS 단말기 착신거부

4424

SMS URL SMS 미지원폰

4425

SMS 단말기 호 처리 중

4426

SMS 재시도 한도 초과

4427

SMS 기타 단말기 문제

4428

SMS 시스템 에러

4432

SMS 회신번호 차단(개인)

4433

SMS 회신번호 차단(기업)

4434

SMS 회신번호 사전 등록제에 의한 미등록 차단

4435

SMS KISA 신고 스팸 회신 번호 차단

4436

SMS 회신번호 사전 등록제 번호규칙 위반

4437

SMS 중복 발신 제한

4438

SMS 화이트리스트 문구 체크

4443

SMS KISA 스팸 차단

7101

카카오 형식 오류

7103

카카오 Sender key (발신프로필키) 유효하지 않음

7105

카카오 Sender key (발신프로필키) 존재하지 않음

7106

카카오 삭제된 Sender key (발신프로필키)

7107

카카오 차단 상태 Sender key (발신프로필키)

7108

카카오 차단 상태 카카오톡 채널(카카오톡 채널 운영툴에서 확인)

7109

카카오 닫힌 상태 카카오톡 채널

7110

카카오 삭제된 카카오톡 채널

7111

카카오 삭제 대기 상태의 카카오톡 채널

7112

카카오 유효하지 않은 사업자번호

7125

카카오 메시지 차단 상태의 카카오톡 채널

7203

카카오 친구톡 전송 시 친구 대상 아님

7204

카카오 템플릿 불일치

7300

카카오 기타 에러

7305

카카오 성공 불확실(30일 이내 수신 가능)

7306

카카오 카카오 시스템 오류

7308

카카오 전화번호 오류

7311

카카오 메시지가 존재하지 않음

7314

카카오 메시지 길이 초과

7315

카카오 템플릿 없음

7318

카카오 메시지를 전송할 수 없음

7322

카카오 메시지 발송 불가 시간

7323

카카오 메시지 그룹 정보를 찾을 수 없음

7324

카카오 재전송 메시지 존재하지 않음

7325

카카오 변수 글자수 제한 초과

7326

카카오 상담/봇 전환 버튼 글자수 제한 초과

7327

카카오 버튼/바로 연결 내용과 템플릿 불일치

7328

카카오 메시지 강조 표기 타이틀과 템플릿 불일치

7329

카카오 메시지 강조 표기 타이틀 길이 제한 초과 (50 자)

7330

카카오 메시지 타입과 템플릿 강조유형이 일치하지 않음

7331

카카오 헤더가 템플릿과 일치하지 않음

7332

카카오 헤더 길이 제한 초과(16 자)

7333

카카오 아이템 하이라이트가 템플릿과 일치하지 않음

7334

카카오 아이템 하이라이트 타이틀 길이 제한 초과(이미지 없는 경우 30 자, 이미지 있는 경우 21 자)

7335

카카오 아이템 하이라이트 디스크립션 길이 제한 초과(이미지 없는 경우 19 자, 이미지 있는 경우 13 자)

7336

카카오 아이템 리스트가 템플릿과 일치하지 않음

7337

카카오 아이템 리스트의 아이템의 디스크립션 길이 제한 초과(23 자)

7338

카카오 아이템 요약정보가 템플릿과 일치하지 않음

7339

카카오 아이템 요약정보의 디스크립션 길이 제한 초과(14 자)

7340

카카오 아이템 요약정보의 디스크립션에 허용되지 않은 문자 포함

7341

카카오 와이드 아이템 리스트 갯수, 최소 최대 갯수 불일치

7342

카카오 대표링크가 템플릿과 일치하지 않음

7351

카카오 캐러셀 아이템 리스트 갯수, 최소 최대 갯수 불일치

7352

카카오 캐러셀 아이템 메시지 길이 OVER

7421

카카오 타임아웃

7521

카카오 중복발신제한