messages-mass-send

맥 메시지(Messages) 앱으로 다수 수신자에게 개별 1:1 안내 문자를 무료로 발송하는 도구. 아이폰 수신자는 iMessage, 안드로이드 수신자는 RCS로 자동 라우팅된다 — 문자 요금 0원.

실전 검증: 62명 발송 62명 전달 성공 (iMessage 25 + RCS 37), 요금 0원.

왜 이 방식인가

경로	결과
SMS 계정 직접 발송 (`participant of account id <SMS>`)	❌ error=4 — SMS 릴레이가 죽어 있으면 실패, 아이폰 문자전달 토글이 없는 환경도 있음
iMessage 계정 강제 발송	⚠️ 아이폰 수신자만 성공, 안드로이드는 error=22 (미등록)
`chat id ("any;-;" & 번호)` 발송	✅ Messages가 상대별로 iMessage/RCS 자동 라우팅

단, any;-; chat id는 기존 대화방이 있어야 동작한다. 그래서 2단계로 발송한다:

1단계: 전원에게 iMessage 발송 시도 → 아이폰은 성공 + 대화방 생성, 안드로이드는 실패
2단계: 1단계 실패분만 any;-; chat으로 재발송 → RCS로 전달

사전 요구사항

macOS + 메시지 앱에 Apple ID 로그인 (iPhone 연동 권장)
터미널(또는 실행 주체)에 자동화 권한 (시스템 설정 → 개인정보 보호 → 자동화 → Messages)
전달 검증(verify.py)에는 Full Disk Access 필요 (~/Library/Messages/chat.db 읽기)
수신자 본인 번호로는 발송 불가 (자기 자신 제외할 것)

사용법

# 1. 수신자 파일: 한 줄에 한 번호 (+8210XXXXXXXX 국제 형식)
# 2. 메시지 파일: 보낼 내용 전문 (UTF-8)

# 테스트 1건 발송 (첫 번째 번호에만) — 반드시 먼저 실행하고 수신 확인할 것
python3 scripts/send.py --recipients numbers.txt --message msg.txt --test

# 본 발송 (2초 간격, 2단계 자동)
python3 scripts/send.py --recipients numbers.txt --message msg.txt

# 전달 검증 — osascript "OK"는 성공 증거가 아니다. 반드시 chat.db로 확인
python3 scripts/verify.py --recipients numbers.txt

전달 검증 규칙 (중요)

성공 판정은 chat.db의 message.is_sent=1 · error=0 기준.
sent=0 · error=0은 미확정 상태 — 몇 분 뒤 RCS · sent=1로 확정되는 경우가 흔하다. sent=0이라고 바로 재발송하지 말고 몇 분 대기 후 재조회할 것.
error=22는 iMessage 미등록(안드로이드) — 2단계 대상.

함정 목록 (전부 실측)

대화방을 삭제했으면 any;-; chat 발송은 반드시 실패한다. 같은 명단에 재발송할 땐 처음부터 2단계(iMessage로 챗 재생성 → 실패분 RCS)로 갈 것. (59/60 실패로 실증)
개행 없이 끝나는 목록 파일 + while read 셸 루프 = 마지막 항목 누락. 이 도구의 파이썬 스크립트는 해당 없음. 작업 후 전수 검증이 답이다.
macOS BSD grep은 \| alternation 미지원 — 로그 추출은 awk로.
발신자가 iMessage 이메일 별칭으로 표시될 수 있음 — 메시지 앱 설정에서 발신 주소를 전화번호로 지정해둘 것.

적용 범위

100명 이하 안내 발송용. 건당 2~3초 속도 한계가 있어 수백 명 단위는 상용 문자 서비스(알리고 등)를 쓰는 게 맞다. 스크립트도 100명 초과 명단은 거부한다.
발신번호는 본인 번호로 표시된다 — 상용 서비스 발송과 동일한 수신 경험.

발송 후 대화방 정리 (참고)

공지 발송으로 대화 목록에 방이 수십 개 쌓인다. AppleScript delete chat은 미지원(-10000)이라 UI 자동화로만 지울 수 있는데, 오삭제 위험이 있어 이 패키지엔 포함하지 않았다. 지울 때는:

chat.db로 "이번 공지 발신만 있는 방"만 분류하고, 답장·기존 이력 있는 방은 보존
삭제해도 "최근 삭제된 항목"에 30일 보관됨

책임 있는 사용

수신에 동의한 대상(수강생 안내, 참가자 공지 등)에게만 사용할 것. 스팸·광고성 대량 발송은 정보통신망법 위반이며 이 도구의 용도가 아니다.