웹호스팅 서버 IP를 바꾼 뒤 솔라피 문자가 발송되지 않을 때 확인할 항목
워드프레스 문의폼에서 접수된 내용을 이메일뿐 아니라 SMS로도 받도록 설정해 두었는데, 웹호스팅 서버를 이전하거나 복제한 뒤 문자만 발송되지 않는 경우가 있습니다. 폼 플러그인 설정이 갑자기 망가진 것처럼 보이지만, 실제 원인은 솔라피(Solapi, 기존 CoolSMS)의 API 보안 설정에 등록된 서버 IP와 현재 서버 IP가 달라진 데 있을 수 있습니다.
특히 클라우드웨이즈에서 서버를 복제하거나 운영체제를 업그레이드하는 과정에서는 사이트 주소는 그대로여도 실제 애플리케이션이 실행되는 서버의 공인 IP가 달라질 수 있습니다. 이때 솔라피에 새 IP를 등록하지 않으면 별도의 화면 오류 없이 문자 요청이 거부될 수 있습니다.
문의폼은 정상인데 문자만 안 가는 이유
Contact Form 7, WPForms, Everest Forms, Quform, Ninja Forms, Fluent Forms, Forminator 같은 워드프레스 폼 플러그인은 방문자가 입력한 내용을 워드프레스 서버에서 처리합니다. 이메일은 워드프레스 메일 설정이나 SMTP를 통해 전송되고, SMS는 솔라피 API에 인증 요청을 보내는 방식으로 발송됩니다.
따라서 문의가 정상적으로 접수되고 이메일도 도착하는데 SMS만 오지 않는다면 폼 자체보다 문자 API 연결 조건을 먼저 살펴보는 편이 효율적입니다. 폼 플러그인을 다시 설치하거나 연동 코드를 처음부터 수정하기 전에 다음 세 가지를 구분해야 합니다.
첫째는 솔라피 API 키와 시크릿 키가 올바른지, 둘째는 API 키에 등록된 허용 IP가 현재 서버의 IP와 일치하는지, 셋째는 발신번호가 문자 발송에 사용할 수 있는 상태인지입니다. 이 중 하나라도 맞지 않으면 폼 제출은 성공한 것처럼 보여도 문자 발송 단계에서 중단될 수 있습니다.
| 확인 항목 | 어긋나면 나타나는 모습 | 어디서 고치나 |
|---|---|---|
| API 키·시크릿 키 | 인증 실패, 발송 내역에 기록 없음 | 워드프레스 연동 설정 |
| 허용 IP(CIDR) | 폼은 접수되는데 문자만 안 감 | 솔라피 개발 → API Key → 허용 IP 관리 |
| 발신번호 상태 | IP를 고쳐도 계속 실패 | 솔라피 메시지 → 발신번호(6개월 인증) |
| 번호도용문자 차단서비스 | 서버 변경이 없었는데 갑자기 막힘 | 통신사 확인 |
서버 복제와 호스팅 이전 뒤 IP부터 확인하기
서버 IP 변경은 단순한 호스팅 업체 이전에서만 발생하지 않습니다. 클라우드웨이즈에서 새 서버를 만들거나 기존 서버를 복제하는 경우, 서버 OS를 업그레이드하는 경우에도 IP가 바뀔 수 있습니다. 도메인의 DNS가 새 서버를 가리키도록 수정했더라도 솔라피 API 설정은 자동으로 갱신되지 않습니다.
먼저 현재 워드프레스 사이트가 실제로 실행되는 서버의 공인 IP를 확인해야 합니다. 확인할 때는 도메인에 연결된 IP와 서버에서 외부 API 요청을 보낼 때 사용하는 출구 IP가 항상 같다고 단정하지 않는 것이 좋습니다. 일반적인 단일 서버 환경에서는 동일할 수 있지만, 프록시·로드밸런서·별도 네트워크를 사용하는 구성이라면 실제 API 요청의 출발 IP가 다를 수 있습니다.
호스팅 관리 화면에 표시된 서버 공인 IP를 확인한 뒤, 필요하다면 호스팅 업체나 서버 관리 도구에서 외부로 나가는 공인 IP를 추가로 확인합니다. 특히 서버를 옮긴 직후에는 DNS 캐시 때문에 접속은 이전 서버로 들어가고 API 요청은 새 서버에서 나가는 등 상태가 섞일 수 있으므로, 변경 작업이 완전히 끝났는지도 함께 점검해야 합니다.
솔라피 API 키의 허용 IP 수정 절차
솔라피에서 API 키에 허용 IP를 등록해 두었다면 현재 서버 주소를 목록에 추가하거나 기존 주소를 새 주소로 바꿔야 합니다. 메뉴 명칭은 솔라피 관리자 화면의 개편에 따라 조금 달라질 수 있지만, 제공된 절차 기준으로는 다음 순서로 진행합니다.
- 솔라피 관리자 페이지에 로그인합니다.
- 개발 » API Key로 이동합니다.
- 사용할 API 키 오른쪽의 점 세 개 아이콘을 클릭합니다.
- 허용 IP 관리를 선택합니다.
- 허용 IP 수정 화면의 CIDR 설정에 현재 서버의 공인 IP를 입력합니다.
- 허용 IP 설정을 저장합니다.
- 워드프레스 문의폼에서 테스트 접수를 만들어 문자가 도착하는지 확인합니다.
서버 한 대의 IP만 허용하려는 경우에는 해당 주소를 기준으로 입력하면 됩니다. 여러 서버에서 같은 API 키를 사용해야 한다면 필요한 IP를 모두 등록할 수 있지만, 사용하지 않는 주소까지 넓게 허용하면 API 키 보안 수준이 낮아집니다. 서버를 교체한 뒤 이전 서버 IP를 바로 삭제할지 여부는 마이그레이션이 완전히 끝났는지에 따라 결정하는 것이 안전합니다. 이전 서버에서 아직 작업이 진행 중이라면 잠시 두 주소를 허용한 뒤 테스트가 끝난 다음 사용하지 않는 주소를 제거할 수 있습니다.
CIDR 입력 형식이 필요한 화면에서는 단순히 서버 주소만 입력하는 것이 아니라 해당 화면이 요구하는 표기 형식을 따라야 합니다. 입력이 저장되지 않거나 계속 인증 실패가 발생하면 IP 값 자체뿐 아니라 CIDR 형식, 공백, 오탈자를 확인해야 합니다.
IP 변경 외에 발신번호도 점검해야 하는 이유
서버 IP가 정상적으로 등록되어도 발신번호 조건 때문에 문자가 보내지지 않을 수 있습니다. 솔라피에 등록한 발신번호가 통신사의 번호도용문자 차단서비스에 가입되어 있으면 웹이나 API를 통한 문자 발송이 제한될 수 있습니다. 발신번호를 실제 휴대전화에서 사용할 수 있다는 사실만으로 웹 발송이 허용되는 것은 아닙니다.
문자 발송이 갑자기 막혔고 최근에 서버 변경이 없었다면 이 서비스 가입 여부를 통신사에 확인해야 합니다. 반대로 서버를 바꾼 직후부터 문제가 시작됐다면 허용 IP 문제를 먼저 처리하되, IP를 수정한 뒤에도 실패하면 발신번호 상태를 이어서 확인하는 순서가 적절합니다.
발신번호 인증 기간도 별도로 관리해야 합니다. 솔라피에서는 발신번호를 6개월마다 인증해야 하며, 인증을 완료하면 다시 6개월의 유효 기간이 늘어납니다. 관리자 화면에서 메시지 » 발신번호로 이동한 다음 활성화된 발신번호 오른쪽의 점 세 개 아이콘을 열고 번호 인증을 선택할 수 있습니다.
인증 만료일은 서버 설정과 관계없이 발신번호 자체에 적용되는 조건입니다. 따라서 IP를 수정했는데도 발송이 되지 않는다면 발신번호가 활성 상태인지, 인증 기간이 끝나지 않았는지, 실제 API 요청에서 사용하는 발신번호와 관리자 화면에서 인증한 번호가 같은지 확인해야 합니다.
테스트할 때 확인할 순서와 자주 생기는 착각
문자 발송 테스트는 브라우저에서 폼을 한 번 제출하는 것만으로 끝내지 않는 편이 좋습니다. 먼저 이메일이 정상적으로 도착하는지 확인하고, 솔라피의 발송 내역이나 잔액·발송 상태를 확인한 뒤, 수신 전화번호와 발신번호를 구분해 점검합니다. 폼 제출 성공 메시지는 워드프레스가 입력을 접수했다는 뜻일 뿐, 솔라피가 실제로 문자를 전달했다는 의미는 아닐 수 있습니다.
다음과 같은 상황은 원인을 혼동하기 쉽습니다.
- DNS만 바꿨다고 생각했지만 실제 서버가 교체되어 공인 IP도 바뀐 경우
- 클라우드웨이즈 서버 복제 후 도메인과 워드프레스 설정은 그대로인 경우
- 이메일은 도착하기 때문에 폼 플러그인 전체가 정상이라고 판단하는 경우
- 발신번호가 휴대전화에서 사용 가능하므로 API 문자도 당연히 발송된다고 생각하는 경우
- API 키의 허용 IP를 수정했지만 오타나 잘못된 CIDR 형식으로 저장한 경우
- 새 서버와 이전 서버를 함께 운영하면서 어느 쪽에서 요청이 나가는지 확인하지 않은 경우
테스트할 때 주의할 점
서버 IP 수정 후에는 실제 문의폼을 사용해 테스트하되, 동일한 문의가 고객이나 운영자에게 중복 전달되지 않도록 테스트용 수신번호를 사용하는 것이 좋습니다. 문자 내용이 길어질 때 장문 문자나 메시지 길이 제한이 적용되는지는 별도 문제이므로, IP 문제를 해결한 뒤에도 특정 내용에서만 실패한다면 메시지 형식과 길이를 확인해야 합니다.
문제가 계속될 때 판단할 기준
허용 IP를 새 서버 주소로 수정했는데도 문자가 오지 않는다면 다음 순서로 범위를 좁혀 볼 수 있습니다. 먼저 API 키가 현재 워드프레스에 저장된 키와 솔라피 관리자에서 수정한 키가 같은지 확인합니다. 여러 환경을 운영하면 개발 사이트와 운영 사이트가 서로 다른 키를 사용하는 경우가 있어, 엉뚱한 API 키의 허용 IP를 수정하는 실수가 생깁니다.
그다음 서버에서 외부 API 통신이 차단되는지, 방화벽이나 보안 플러그인이 요청을 막고 있지 않은지 확인합니다. 워드프레스 보안 플러그인, 서버 방화벽, PHP 설정, TLS 인증서 문제도 API 요청에 영향을 줄 수 있지만, 이런 문제는 서버 IP 변경과 직접 연결되지 않을 수 있습니다. 따라서 IP를 등록한 시점과 발송 실패가 시작된 시점을 비교해 원인 가능성을 나누는 것이 좋습니다.
발송 내역에 실패 사유가 표시된다면 그 내용을 기준으로 확인해야 합니다. 반대로 아무 오류도 보이지 않는다면 폼 플러그인의 성공 처리 방식 때문에 실패가 숨겨졌을 가능성도 있습니다. 이 경우 워드프레스 로그, 연동 플러그인의 API 응답, 솔라피 발송 기록을 함께 확인해야 정확한 원인을 찾을 수 있습니다.
웹호스팅 서버를 이전하거나 복제할 예정이라면 작업 전에 현재 서버 IP와 솔라피 API 키의 허용 IP를 기록해 두는 것이 좋습니다. 이전이 끝난 뒤에는 새 IP 등록, 발신번호 인증 기간 확인, 테스트 문자 발송을 한 묶음으로 점검하면 누락을 줄일 수 있습니다. 특히 API 키에 IP 제한을 걸어 둔 구성은 보안에는 유리하지만, 서버 교체 시 문자 발송이 조용히 중단될 수 있다는 운영상의 대가가 있습니다. 서버 변경 작업에 문자 알림이 포함되어 있다면 DNS만 확인하지 말고 외부 API 허용 목록까지 함께 관리해야 합니다.
