메시지 한 통을 테스트로 보내려고 대시보드를 열고, 발신번호를 찾고, 폼에 문자 내용을 입력하고… 익숙한 풍경이죠. 이제는 그럴 필요가 없어요.

solactl은 SOLAPI 서비스를 터미널에서 바로 다룰 수 있게 해주는 공식 CLI 도구예요.
SMS부터 카카오 알림톡, RCS까지 한 줄 명령으로 발송할 수 있고, 자동화 스크립트나 CI/CD 파이프라인에도 그대로 끼워 넣을 수 있어요. 솔라피 시작하기 가이드를 막 따라 해본 분이라면, 다음 단계로 곧장 넘어갈 수 있는 도구입니다.

solactl send sms --from <등록한 발신번호> --to 01000000000 --text "안녕하세요"

이 한 줄이면 충분합니다.

AI에게 메시징 능력을 더해주세요

solactl을 이번 릴리스에서 가장 강력하게 만드는 건, 사실 여러분이 쓰는 AI 에이전트예요.

Claude Code, Cursor, Codex 같은 AI 코딩 도구는 자연어를 셸 명령으로 옮기는 데 이미 능숙해요. 거기에 solactl을 쥐어주는 순간, AI는 SOLAPI의 모든 기능을 마치 자기 도구처럼 다룰 수 있게 됩니다. 별도 MCP 서버나 SDK 래퍼 없이, CLI 그 자체가 AI를 위한 인터페이스가 되는 거죠.

"어제 발송한 알림톡 중 실패한 건들만 골라서 SMS로 다시 보내줘" "이번 달 잔액 추이 정리해서 알려줘" "신규 채널 등록하고, 주문확인 템플릿 검수 요청까지 넣어줘"

AI에게 이렇게 말하면, 내부적으로는 이런 일이 벌어져요.

solactl messages list --status FAILED --json | jq ...
solactl send sms --to ... --text ...
solactl kakao template create ... --json
solactl kakao template inspect <id>

왜 CLI가 AI에게 잘 맞을까요?

  • 모든 명령에 --json 옵션 — 사람을 위한 표 출력과 머신을 위한 구조화 출력이 분리돼 있어요. AI는 JSON을 받아 다음 액션을 스스로 판단할 수 있어요.

  • --help로 자기 학습 — AI는 문서를 먼저 안 읽어도, solactl --help와 solactl <명령> --help만으로 사용법을 파악합니다.

  • 클라이언트 사이드 유효성 검증 — 잘못된 인자는 API 호출 전에 막혀요. AI가 발송 전에 스스로 교정할 수 있어, 비용과 실수를 동시에 줄여줍니다.

  • 에러 메시지가 명확 — 진단 메시지는 stderr로, 결과는 stdout으로 분리돼 있어 AI가 실패 원인을 확인하기 쉬워요.

  • 멀티 프로필 — AI가 운영 환경을 건드리지 않도록, --profile dev로 안전한 샌드박스를 줄 수 있어요.

💡 CLI가 곧 MCP — 별도 MCP 서버를 띄우지 않아도, AI 에이전트의 Bash 권한만으로 SOLAPI의 거의 모든 기능을 활용할 수 있어요. "메시징을 다룰 수 있는 AI 에이전트"를 만드는 가장 빠른 길입니다.

무엇을 할 수 있나요?

모든 채널을 하나의 CLI로

SMS, LMS, MMS는 물론 카카오 알림톡(ATA), 친구톡(BMS), RCS까지 — SOLAPI가 지원하는 모든 메시지 타입을 동일한 인터페이스로 발송할 수 있어요. 채널마다 다른 도구를 쓸 필요 없이, solactl send <타입> 한 가지 패턴만 기억하면 됩니다.

solactl send sms --from <등록한 발신번호>  --to 01012345678 --text "주문이 접수됐어요"
solactl send lms --from <등록한 발신번호>  --to 01012345678 --subject "공지" --text "..."
solactl send ata --to 01012345678 --pf-id <pfId> --template-id <id>
solactl send rcs --from <등록한 발신번호>  --to 01012345678 --rcs-from <brand>

발신번호 등록과 일일 발송량 정책은 SOLAPI 가이드를 따라 사전에 준비해 두세요. 등록된 번호는 solactl senderid list로 바로 확인할 수 있어요.

카카오 비즈메시지 운영도 터미널에서

채널 조회부터 알림톡 템플릿 생성·검수 요청·해제까지, 카카오 비즈메시지 운영에 필요한 작업을 모두 CLI로 처리할 수 있어요. 브랜드 메시지(BMS) 템플릿 관리도 포함돼 있습니다.

solactl kakao channel list
solactl kakao template create --pf-id <pfId> --name "주문확인" ...
solactl kakao template inspect <templateId>
solactl kakao brand-template list

멀티 프로필로 안전하게 환경 분리

개발·스테이징·운영 환경을 오가며 일하는 분들을 위해, 여러 API Key를 프로파일로 저장하고 한 번에 전환할 수 있어요.

solactl configure --profile prod
solactl configure use prod
solactl configure list

버전 업그레이드

새 버전이 릴리스되면 한 줄로 최신 버전을 받을 수 있어요. 체크섬 검증과 URL 검증이 내장돼 있어서, 공급망 공격 걱정 없이 안전하게 업데이트할 수 있습니다.

solactl upgrade

5초 만에 시작하기

Linux / macOS는 한 줄로 설치할 수 있어요.

curl -fsSL https://raw.githubusercontent.com/solapi/solactl/main/scripts/install.sh | bash

~/.local/bin에 바이너리가 떨어지고, PATH가 잡혀 있지 않으면 친절하게 안내 메시지가 뜹니다.

그다음, 발급받은 API Key/Secret으로 초기 설정을 마치면 끝이에요.

solactl configure
solactl balance        # 잔액 확인
solactl senderid list  # 발신번호 확인

어떤 분께 추천드려요

  • AI 에이전트와 함께 일하는 개발자 — Claude Code·Cursor·Codex 같은 도구에 solactl을 노출시키는 것만으로, AI가 메시징 운영을 직접 처리할 수 있어요.

  • 커머스 자동화·노코드 자동화를 검토 중인 팀 — 노코드 자동화로 다 풀리지 않는 영역을, 셸 스크립트와 cron으로 깔끔하게 메울 수 있어요. 모든 명령은 --json으로 머신 파서블한 출력을 지원합니다.

  • 운영팀 — 발송 내역 조회(messages list), 잔액 모니터링(balance), 발신번호 점검(senderid list)을 대시보드 없이 빠르게 처리할 수 있어요.

  • 카카오 알림톡/브랜드 메시지 담당자 — 템플릿 등록·검수 사이클을 CLI로 단축하세요. 검수 요청·취소·휴면 해제까지 전 단계를 지원해요.

  • API 연동 전 단계의 PoC가 필요한 개발자 — SDK를 끼우기 전에 CLI로 먼저 동작을 검증하고, 그 명령을 그대로 스크립트로 옮길 수 있어요.

보안은 기본으로

solactl은 v0.1.4부터 보안을 한층 강화했어요.

  • 체크섬 검증 — 업그레이드 시 다운로드 파일의 SHA256 체크섬을 검증합니다.

  • URL 화이트리스트 — 신뢰된 호스트로의 redirect만 허용해요.

  • 디버그 로그 마스킹 — --debug 출력에서 API Key, Secret, 토큰을 자동으로 가립니다.

  • 자격증명 보호 — 프로파일은 ~/.solapi/config에 권한 제한된 형태로 저장돼요.

지원 플랫폼

플랫폼

아키텍처

지원 수준

Linux

amd64, arm64

우선 지원

macOS

amd64 (Intel), arm64 (Apple Silicon)

우선 지원

Windows

amd64, arm64

바이너리 제공 (제한적 테스트)

더 알아보기

solactl 자료

SOLAPI 이용 가이드와 함께 보면 좋아요

피드백과 이슈 제보는 SOLAPI Community에서 받고 있어요. 많은 관심 부탁드려요!

⚠️ 현재 solactl은 미리보기 단계예요. API와 CLI 인터페이스가 변경될 수 있으니, 운영 환경에 도입하실 땐 버전을 고정해서 사용해 주세요.