Twilio SMS

SMS 채널은 Twilio Messaging을 사용합니다. 수신 메시지와 전달 콜백은 웹훅으로 도착하고 발신 메시지는 Twilio REST API를 사용합니다.

필요한 항목

• Twilio Account SID(AC 뒤에 16진수 문자 32개).
• E.164 형식의 SMS 지원 from_number.
• API Key SID(SK 뒤에 16진수 문자 32개).
• 발신 REST 호출용 API Key Secret.
• Twilio 웹훅 서명 검증용 Auth Token.
• 공개 HTTPS 콜백 URL.

최신 전화번호 및 웹훅 설정은 Twilio Messaging 문서를 참조하세요.

Dashboard에서 연결

1. Dashboard → Channel → Add를 엽니다.
2. **SMS (Twilio)**를 선택합니다.
3. Account SID, From number, API Key SID, Status callback URL을 입력합니다.
4. API Key Secret과 Auth Token을 추가합니다.
5. 자격 증명을 저장하고 CLI 마법사에서 정책을 검토한 뒤 Twilio 번호의 수신 웹훅을 구성합니다.

메시징 플랫폼에 따라 Anyy의 공유 웹훅 리스너와 HTTPS 프록시를 활성화하세요. 콜백 URL은 HTTPS여야 하며 다음 계정 경로로 끝나야 합니다.

https://YOUR_HOST/channels/sms/ACCOUNT_ID/webhook

기본 계정 ID는 twilio입니다. 수신 메시지와 구성된 상태 콜백에 같은 경로를 사용하세요.

접근 정책

SMS 기본값은 open이며 open, allowlist, disabled를 지원합니다. 대화형 anyy setup channel 마법사에서 SMS를 선택해 정책을 바꿉니다. Dashboard 자격 증명 양식에는 해당 입력이 없고 현재 설정 작업은 SMS 목록 항목을 편집하지 않습니다. 페어링은 제공되지 않으며 allowlist만 선택해도 허용 번호가 추가되지는 않습니다.

전화번호는 +14155550123처럼 E.164 형식으로 정규화해야 합니다.

같은 호스트의 프록시에서 HTTPS를 종료하면 정확한 X-Forwarded-Proto: https와 X-Forwarded-Host를 포함해 루프백에서 전달하세요. 이 어댑터는 루프백이 아닌 연결의 전달 URL 헤더를 신뢰하지 않습니다. 서명 검증을 위해 원래 공개 URL과 폼 본문을 보존하세요.

전달 영수증

Twilio는 콜백 URL로 전달 진행 상황을 보고할 수 있습니다. Anyy 전송 성공은 우선 공급자에 발송했음을 증명합니다. 불확실한 메시지를 재시도하기 전에 후속 영수증/상태를 확인하세요.

SMS에는 직접 비용이 발생할 수 있습니다

수신, 발신, 통신사, 국제 메시지 요금은 Twilio 계정과 목적지에 따라 다릅니다. 접근을 제한하고 자동화 활성화 전에 아는 번호로 테스트하세요.

연결 확인

anyy channel doctor sms
anyy channel reload

수신 SMS 하나를 보내 발신자 정책을 확인한 뒤 응답과 전달 상태를 테스트하세요.

문제 해결

문제	확인 사항
Twilio가 콜백 URL을 거부함	정확한 HTTPS /channels/sms/ACCOUNT_ID/webhook 경로
웹훅 서명 실패	Auth Token과 프록시의 원래 URL/본문 보존
발신 API 실패	Account SID, API Key SID/Secret, From 번호 기능
발신자 무시	DM 정책과 E.164 허용 목록 값
상태가 진행되지 않음	Status callback URL과 Twilio 전달 콜백 구성