그누보드 icode 문자 발송 서비스 연동 및 설정 가이드

• 목록
• 스크랩

그누보드 icode 문자 발송 서비스 연동 및 설정 가이드

그누보드 운영자가 icode 문자 발송 서비스를 연동하여 회원가입 및 알림 설정을 완료할 수 있도록 가입부터 환경설정, 오류 해결까지 필요한 절차를 안내합니다.

그누보드 icode 문자 발송 서비스 연동 가이드

그누보드에서 회원가입, 주문, 알림 등의 문자(SMS) 발송 기능을 사용하려면 아이코드(icode) 서비스 가입부터 사이트 내 설정까지의 과정을 순서대로 진행해야 합니다. icode 사이트 UI 개편에 따라 메뉴 경로는 일부 달라질 수 있습니다.

1. icode 회원가입 및 사이버머니 충전

• icode 회원가입 페이지에서 가입을 진행합니다. 문자발송 할인을 받으려면 아이디가 sir_로 시작되어야 합니다.
• 로그인 후 사이버머니를 충전합니다.

2. 발신번호 사전등록 및 토큰키 생성

• icode 사이트의 확장메뉴 > 발신번호 사전등록하기 메뉴에서 발신번호를 사전에 등록합니다. 등록된 번호를 통해서만 문자가 발송됩니다.
• icode 사이트의 다운로드 > 토큰키관리 메뉴에서 신규추가를 눌러 토큰키를 생성합니다.

3. 그누보드 관리자 환경설정 연동

• 그누보드 관리자에 접속한 뒤, 환경설정 > 기본환경설정 > SMS 항목에서 SMS 사용을 '아이코드'로 변경합니다.
• SMS 관리 > SMS 기본설정에서 icode 로그인 아이디와 비밀번호(또는 생성한 토큰키)를 설정합니다.

4. 주의사항 및 문제 해결

• 아이코드 아이디와 비밀번호를 입력한 후 테스트 문자 발송이 정상적으로 이루어지는지 확인합니다.
• 만약 문자 전송 시 “SMS 서버와 통신이 불안정 합니다” 라는 메시지가 뜬다면, 사용하는 요금제에 따라 서버 방화벽에서 포트가 차단되어 있는지 확인해야 합니다. 충전제는 포트 7295번, 정액제는 포트 7296번(공통 IP: 211.172.232.124)이 방화벽에서 막혀있는지 체크해야 합니다.
• 일부 버전 환경에서 설정 후 발송이 원활하지 않을 때 토큰키 관련 입력 항목을 점검하거나 조정해 볼 수 있습니다.

icode 문자 발송 서비스 가입 시 문자 발송 요금 할인을 받으려면, 회원 가입 시 아이디를 sir_로 시작하도록 설정해야 합니다.

그누보드 icode 문자 발송 실패 시 점검 및 해결 방법

그누보드 관리자 환경설정에서 아이코드(icode) 아이디와 비밀번호를 입력했음에도 문자가 발송되지 않거나 성공 메시지가 나타나지 않는 경우, 다음 항목과 순서에 따라 원인을 확인하고 조치할 수 있습니다.

1. 요금제별 포트 및 서버 방화벽 상태 확인

• 확인 위치: 서버 방화벽 설정 및 관리자 상단 메뉴 [SMS 관리]-[SMS 기본설정]
• 상세 내용: icode사에서 제공하는 요금제는 충전제와 정액제로 구분되며, 사용하는 요금제에 따라 요구되는 포트 번호가 다릅니다.
  • 충전제: 포트 7295번을 사용합니다. 문자 전송 시 “SMS 서버와 통신이 불안정 합니다”라는 메시지가 뜬다면, 서버 방화벽에서 IP: 211.172.232.124, PORT: 7295가 차단되어 있는지 확인해야 합니다.
  • 정액제: 포트 7296번을 사용합니다. 동일한 통신 불안정 메시지가 발생하면 서버 방화벽에서 IP: 211.172.232.124, PORT: 7296의 차단 여부를 체크해야 합니다.

2. 토큰키 입력 여부와 충돌 확인

• 확인 위치: 관리자 [환경설정] 또는 [SMS 관리]-[SMS 기본설정]
• 상세 내용: 아이디와 비밀번호를 올바르게 입력했음에도 발송이 실패할 때, 관리자 어드민 SMS 환경설정란에 입력된 JSON 토큰키를 지우고 테스트한 환경에서 정상 발송이 이루어진 사례가 있습니다. 토큰키 설정으로 인해 인증 충돌이 발생하는지 확인합니다.

3. 발신번호 사전등록 여부 확인

• 확인 위치: icode 사이트 내 [확장메뉴]-[발신번호 사전등록하기]
• 상세 내용: 발신번호가 사전에 등록되어 있지 않으면 문자가 정상적으로 발송되지 않습니다. icode 사이트에서 발신번호가 올바르게 사전 등록되었는지 점검해야 합니다.

그누보드 구버전(5.4.0.1 등)을 운영 중인 경우, 최신 버전과 달리 관리자 설정 화면에 '토큰키' 입력란이 없을 수 있습니다. 이 경우 다음과 같이 대처할 수 있습니다.

1. 버전 확인 및 패치: 사용 중인 그누보드 버전이 낮아 토큰키 기능이 포함되지 않은 경우입니다. 커뮤니티 등에서 제공되는 최신 버전으로의 패치 적용을 고려해야 합니다.
2. 토큰키 적용의 어려움: 패치 적용이 어렵거나 간결한 해결을 원하는 경우, 단순히 토큰키 입력란만 추가하는 것은 시스템 구조상 쉽지 않을 수 있습니다.
3. 대안: 최신 버전으로 업데이트가 어렵다면, 해당 버전에서 지원하는 방식(아이디/비밀번호 인증)을 그대로 사용하거나, 다른 문자 발송 업체를 이용하는 방법도 고려할 수 있습니다.

연동 절차 안내

1. 서비스 가입 및 준비: icode 사이트에서 회원가입 시 아이디를 sir_로 시작하여 할인 혜택을 확보하고, 사이버머니를 충전합니다.
2. 사전 설정: icode 내 [확장메뉴]에서 발신번호를 등록하고, [다운로드] 메뉴에서 토큰키를 생성합니다.
3. 그누보드 적용: 관리자 [환경설정] > [기본환경설정]에서 SMS 사용을 '아이코드'로 선택한 후, [SMS 관리] > [SMS 기본설정]에 아이디와 비밀번호(또는 토큰키)를 입력합니다.

상황별 점검 및 조치

• 신규 연동 시: 토큰키를 포함한 모든 정보를 입력하여 설정합니다.
• 발송 실패 시: 서버 방화벽 포트(충전제 7295, 정액제 7296) 개방 여부를 먼저 확인합니다.
• 인증 오류 시: 토큰키 입력값이 인증을 방해하는지 확인하기 위해 토큰키를 비우고 테스트합니다.

다음 행동

• 설정 완료 후 관리자 페이지에서 테스트 문자를 발송하여 정상 수신 여부를 확인하십시오. 실패 시 Q3의 점검 항목을 순서대로 확인하시기 바랍니다.

Q. 문자 발송이 안 될 때 가장 먼저 무엇을 확인하나요?

• 방화벽 확인: '통신 불안정' 메시지 발생 시, 서버 방화벽에서 211.172.232.124 IP의 포트(충전제 7295, 정액제 7296)가 차단되었는지 확인하십시오.
• 토큰키 충돌: 아이디/비번이 정확함에도 발송되지 않는다면, 관리자 설정의 토큰키 항목을 비우고 테스트하여 인증 충돌 여부를 판별하십시오.

Q. 구버전 그누보드라 토큰키 입력란이 없습니다.

• 대안: 해당 버전에서 지원하는 아이디/비밀번호 인증 방식을 사용하십시오. 시스템 구조상 토큰키 기능이 없는 버전은 최신 버전으로 패치하지 않는 한 토큰키 적용이 어렵습니다.

함께 보면 좋은 글

• 아이코드 토큰키 기반 그누보드 SMS/LMS 자동 발송 모듈 연동 가이드

참고자료

기타 참고자료

• sir.kr — 그누보드5 매뉴얼
• sir.kr — SMS 설정에서 아이코드 관련부분. - SIR - 개발자 커뮤니티
• sir.kr — 그누보드5 아이코드 SMS 문자 발송이 안됩니다. - SIR - 개발자 커뮤니티
• sir.kr — 9.1. SMS 기본설정 - SIR - 개발자 커뮤니티