SMS 설정

NextCRM은 Twilio를 통해 SMS를 보내고 받습니다. 각 워크스페이스는 자체 Twilio 계정을 연결하므로 메시지는 사용자의 번호로 발송되고, 비용은 Twilio가 사용자에게 직접 청구합니다. SMS 설정이 끝나면 팀의 누구나 리드 카드나 상세 보기에서 리드에게 문자를 보낼 수 있습니다.

참고: SMS 설정은 워크스페이스 관리자만 변경할 수 있습니다. 영업 관리자를 포함한 다른 역할에는 구성의 SMS 단계가 표시되지 않습니다. 설정을 저장하고 메시지를 보내려면 요금제에 SMS messaging 기능이 포함되어 있어야 합니다.

각 값을 얻는 곳

https://console.twilio.com/ 에서 Twilio Console에 로그인한 후 다음 값을 확인합니다. SMS 단계의 각 필드 옆에 있는 (i) 아이콘에도 같은 정보가 표시됩니다.

NextCRM 필드	Twilio에서 얻는 곳	링크
Twilio 계정 SID	Twilio 계정 ID이며 AC로 시작합니다. Twilio Console > Account Dashboard의 Account Info 섹션에 있습니다.	https://console.twilio.com/
인증 토큰	같은 계정의 비밀 키입니다. Twilio Console > Account Dashboard > Account Info에서 Auth Token 옆의 Show를 클릭합니다.	https://console.twilio.com/
발신 번호	SMS를 보낼 수 있는 Twilio 번호를 국제 형식으로 입력합니다(예: +15551234567). Twilio Console > Phone Numbers > Manage > Active numbers.	https://console.twilio.com/us1/develop/phone-numbers/manage/incoming
메시징 서비스 SID(선택 사항)	발신 번호 대신 사용하며 MG로 시작합니다. Twilio Console > Messaging > Services에서 서비스를 열고 SID를 복사합니다.	https://console.twilio.com/us1/develop/sms/services
Test Account SID / Test Auth Token	실제 SMS를 보내지 않는 무료 테스트 자격 증명입니다. Twilio Console > Account > API keys & tokens의 Test credentials 섹션에 있습니다.	https://console.twilio.com/us1/account/keys-credentials/api-keys
수신 웹훅 URL	저장 후 NextCRM에 표시됩니다. Twilio의 Phone Numbers > Active numbers > 내 번호 > Messaging configuration > A message comes in: Webhook, HTTP POST에 붙여 넣습니다.	https://console.twilio.com/us1/develop/phone-numbers/manage/incoming

설정 순서: Twilio 계정을 만들거나 열기 > Account SID와 인증 토큰을 복사하고 번호 또는 Messaging Service 선택 > NextCRM에 붙여 넣고 저장 > 수신 웹훅 URL을 Twilio에 붙여 넣기 > 연결을 테스트하고 테스트 SMS 보내기.

발신 번호 또는 메시징 서비스 SID 중 하나가 필요합니다. 실제 운영 환경에서 발송할 때는 메시징 서비스를 사용하는 것이 좋습니다.

경고: 라이브 모드에서는 인증 토큰이 항상 필요합니다. NextCRM은 이 토큰으로 Twilio를 호출하고, 수신 웹훅이 실제로 Twilio에서 온 것인지도 검증하기 때문입니다. 따라서 NextCRM은 Twilio API 키를 요청하지 않습니다.

단계별 Twilio 연결

1. 구성 > SMS를 엽니다(SMS 단계 열기). 설정의 SMS 및 통화 카드도 같은 단계를 엽니다.
2. SMS 통합 활성화를 켭니다.
3. Twilio 환경에서 라이브(실제 메시지) 또는 테스트(시뮬레이션 메시지, 아래 참조)를 선택합니다.
4. 라이브 자격 증명을 입력합니다: Twilio 계정 SID, 인증 토큰, 그리고 발신 번호 및/또는 메시징 서비스 SID.
5. 기본 국가 코드를 확인합니다(예: +49 또는 +55). 국가 코드 없이 저장된 전화번호에 이 코드가 추가됩니다.
6. SMS 설정 저장을 클릭합니다.
7. 연결 테스트를 클릭합니다. 성공하면 "Twilio 연결이 확인되었습니다."가 표시되고 상단의 상태 배지가 연결됨으로 바뀝니다.

페이지 상단의 세 단계로 Twilio 연결 카드가 진행 상황을 보여 줍니다: Twilio 자격 증명 입력, 연결 확인, SMS 켜기. 저장된 설정과 마지막 연결 테스트를 바탕으로 단계에 체크 표시가 됩니다. 단계별 안내가 담긴 사용 방법도 이 카드 안에 있습니다.

발신 번호가 국제 형식이 아니면 필드에 "국가 번호가 포함된 국제 형식을 사용하세요 (예: +821012345678)."가 표시됩니다.

비밀 값은 암호화되어 저장되며, 저장 후에는 마스킹되어 다시 표시되지 않습니다. 저장된 값을 유지하려면 비밀 필드를 비워 두세요.

웹훅 URL(답장 수신)

저장하고 나면 NextCRM에 복사 버튼이 있는 읽기 전용 주소 두 개가 표시됩니다.

• 수신 웹훅 URL: 리드가 사용자의 번호로 답장하면 Twilio가 이 주소를 호출합니다.
• 상태 콜백 URL: Twilio가 이 주소로 전송 상태(발송됨, 전달됨, 실패)를 보고합니다.

NextCRM은 모든 메시지와 함께 상태 콜백 URL을 자동으로 보내므로 Twilio에 따로 입력할 필요가 없습니다. 수신 URL은 직접 추가해야 합니다.

1. Twilio Console에서 전화번호의 구성 화면을 엽니다(메시징 서비스를 통해 발송하는 경우에는 해당 서비스의 통합 설정을 엽니다).
2. 메시징 섹션의 수신 메시지 항목("A message comes in")에서 Webhook을 선택하고, 수신 웹훅 URL을 붙여 넣은 다음 HTTP POST를 선택합니다.
3. Twilio에서 저장합니다.

수신된 답장은 전화번호가 같은 리드와 연결되어 해당 리드의 SMS 기록에 표시됩니다. 해당 번호의 리드가 없거나 여러 리드가 같은 번호를 사용하는 경우, 메시지가 잘못된 리드에 연결되지 않도록 미할당 상태로 따로 보관됩니다.

테스트 모드

비용 없이 설정을 시험해 보려면 Twilio 환경에서 테스트를 선택합니다.

• Twilio의 Test Account SID와 Test Auth Token을 입력합니다.
• NextCRM은 테스트 메시지를 항상 테스트 발송 성공을 위한 Twilio의 매직 번호인 +15005550006에서 보내므로, 발신 번호를 입력할 필요가 없습니다.
• 테스트 메시지는 요금이 청구되지 않고, 실제 휴대폰에 도달하지 않으며, 상태 콜백을 발생시키지 않고, 답장을 받을 수 없습니다. 리드에는 Twilio 테스트 모드가 활성화되어 있다는 안내가 표시됩니다.

실제 메시지를 보낼 준비가 되면 라이브로 다시 전환하고 SMS 설정 저장을 클릭합니다.

테스트 메시지 보내기

테스트 SMS 보내기에서 본인의 휴대폰 번호를 국제 형식으로 입력하고, 원하면 내용을 수정한 다음 보내기를 클릭합니다. 번호가 국제 형식이 아니면 "국가 번호가 포함된 국제 형식을 사용하세요 (예: +821012345678)."가 표시되고 보내기는 비활성화된 상태로 유지됩니다. NextCRM이 "테스트 SMS가 대기열에 추가되었습니다."라고 확인해 줍니다. 라이브 모드에서는 실제 SMS가 발송되며 Twilio가 다른 메시지와 똑같이 요금을 청구합니다.

리드에게 SMS 보내기

• 리드 카드에서 전화번호 옆의 SMS 버튼("Send SMS to …")을 클릭합니다. 수신자가 입력된 상태로 SMS 보내기 창이 열립니다. 메시지(최대 1,600자)를 작성하고 보냅니다. 입력하는 동안 창에 메시지에 필요한 SMS 세그먼트 수가 표시됩니다(예: "SMS 세그먼트 2개").
• 리드 상세 정보에서 SMS 탭을 열면 SMS 기록을 보거나, 새 메시지를 보내거나, 동기화를 클릭해 Twilio에서 답장을 가져올 수 있습니다.

전화번호는 E.164 형식이어야 합니다(예: +5511999999999). +가 없는 번호는 기본 국가 코드를 사용해 정규화됩니다. 보낸 메시지와 받은 답장은 모두 리드의 활동 기록에 남습니다.

여러 리드에게 한꺼번에 문자를 보내려면 캠페인 > 새 캠페인 > SMS에서 SMS 캠페인을 만드세요(SMS 캠페인 열기). 긴 문자는 여러 SMS 세그먼트(각각 약 160자)로 나뉘며, 캠페인 편집기에 세그먼트 수가 표시됩니다.

비용 및 제한

• Twilio는 모든 메시지, 전화번호, 서비스 요금을 사용자의 Twilio 계정에 직접 청구합니다. NextCRM은 SMS 건당 요금을 부과하지 않습니다.
• 요금, 발신자 규정, 등록 요건은 수신 국가에 따라 다릅니다. 일부 국가에서는 발송 전에 사업자나 발신자를 등록해야 하므로 Twilio 계정에서 확인하세요.
• Twilio 체험(trial) 계정에는 제한이 있습니다(예: 일반적으로 인증된 번호로만 보낼 수 있습니다). 실제 운영을 시작하기 전에 Twilio 계정을 업그레이드하세요.

문제 해결

• "Twilio credentials are incomplete." Account SID와 인증 토큰을 입력한 다음 저장합니다.
• "Twilio sender is incomplete." 발신 번호 또는 메시징 서비스 SID를 추가합니다.
• 연결 테스트 실패: 먼저 SMS 통합 활성화를 켠 상태로 설정을 저장하고, SID와 토큰이 같은 Twilio 계정 및 환경에 속하는지 확인합니다.
• 답장이 표시되지 않음: Twilio에서 해당 번호 또는 메시징 서비스에 수신 웹훅 URL이 설정되어 있는지, 리드의 전화번호가 발신자 번호와 일치하는지 확인합니다. 리드의 SMS 탭에서 동기화를 사용하세요.

관련 문서

• 이메일 캠페인
• 이메일 설정(SMTP 및 IMAP)
• WhatsApp 설정
• 리드와 파이프라인