Description
n8n-nodes-aligo
알리고(Aligo) SMS API를 n8n에서 사용할 수 있는 커뮤니티 노드입니다.
기능
- 문자 발송 – 단건/다중 수신자 문자 발송
- 대량 발송 – 최대 500건 동시 발송
- 전송 결과 조회 – 발송 내역 목록 조회
- 전송 상세 조회 – 특정 메시지 상세 결과 조회
- 잔여 건수 조회 – 발송 가능 건수 확인
- 예약 취소 – 예약 발송 취소
설치
n8n 커뮤니티 노드로 설치
- n8n의 Settings > Community Nodes 메뉴로 이동
- Install 클릭
n8n-nodes-aligo 입력 후 설치
수동 설치
cd ~/.n8n/nodes
npm install n8n-nodes-aligo
사전 준비
- 알리고 회원가입
- API Key 발급 (관리자 페이지에서 발급)
- 발신번호 등록 (사전 등록된 번호만 발송 가능)
- API 사용하는 IP 등록
Credential 설정
| 항목 |
설명 |
| API Key |
알리고에서 발급받은 API 키 |
| User ID |
알리고 로그인 아이디 |
사용법
문자 발송 (Send SMS)
| 필드 |
필수 |
설명 |
| Sender |
O |
발신자 전화번호 (사전 등록 필요) |
| Receiver |
O |
수신자 전화번호 (쉼표로 구분, 최대 1,000명) |
| Message |
O |
메시지 내용 (최대 2,000byte) |
| Message Type |
X |
SMS(단문) / LMS(장문) / MMS(그림문자) |
| Title |
X |
문자 제목 (LMS/MMS만 해당) |
| Reservation Date |
X |
예약일 (YYYYMMDD) |
| Reservation Time |
X |
예약시간 (HHMM) |
| Test Mode |
X |
테스트 모드 (실제 발송 안함) |
대량 발송 (Send Bulk SMS)
| 필드 |
필수 |
설명 |
| Sender |
O |
발신자 전화번호 |
| Message Type |
O |
SMS / LMS / MMS |
| Recipients |
O |
JSON 배열 형식의 수신자 목록 (최대 500건) |
Recipients 형식:
[
{"receiver": "01012345678", "msg": "첫번째 메시지"},
{"receiver": "01087654321", "msg": "두번째 메시지"}
]
전송 결과 조회 (Get Send History)
| 필드 |
필수 |
설명 |
| Page |
X |
페이지 번호 (기본값: 1) |
| Page Size |
X |
페이지당 출력 갯수 (30~500) |
| Start Date |
X |
조회 시작일 (YYYYMMDD) |
| Limit Day |
X |
조회 종료일 (YYYYMMDD) |
전송 상세 조회 (Get Send Detail)
| 필드 |
필수 |
설명 |
| Message ID |
O |
메시지 고유 ID (발송 결과에서 확인) |
잔여 건수 조회 (Get Remaining Count)
추가 파라미터 없이 API 연결 확인 및 잔여 건수를 조회합니다.
예약 취소 (Cancel Reservation)
| 필드 |
필수 |
설명 |
| Message ID |
O |
취소할 예약 메시지 ID |
개발
# 의존성 설치
npm install
# 개발 서버 실행
npm run dev
# 빌드
npm run build
# 린트
npm run lint
참고
라이선스
MIT
