준비물
수신
Telkit 번호로 걸려 온 전화를 Grok 음성 에이전트가 받아요. 전화가 올 때마다 xAI가 내 웹훅 서버에 알림을 보내고, 서버가 WebSocket으로 그 통화에 붙어요.
- xAI에 070 번호를 등록해요
POST https://api.x.ai/v2/phone-numbers로 내 070 번호를 등록해요. xAI는 이 번호로 오는 전화를 IP allowlist나 digest 인증 가운데 하나로 받는데, Telkit은 아이디와 비밀번호를 보내지 못하니 IP allowlist를 써요. 자세한 칸은 xAI SIP 문서를 봐요.
Telkit이 보내는 전화
webhook.dispatch_signing_secret이 웹훅 서명 비밀값이에요. 한 번만 보이니 웹훅 서버에 저장해 두세요.
- Telkit 번호를 xAI로 넘겨요
xAI는 sip:{번호}@sip.voice.x.ai로 전화를 받아요. Telkit 번호 연결에 사용자 없이 sip:sip.voice.x.ai를 넣고 번호 형식을 E.164로 하면, Telkit이 받은 070 번호를 +827012345678 모양으로 앞에 붙여 보내요. 전송은 기본값인 TLS 그대로 둬요.
- 에이전트
- API
Telkit 070 번호로 걸려 온 전화를 xAI SIP 주소로 넘기는 한 줄이에요.
- 웹훅 서버에서 통화에 붙어요
전화가 오면 xAI가 웹훅으로 realtime.call.incoming 알림을 보내요. 서버는 webhook-id, webhook-timestamp, webhook-signature 헤더를 1단계의 서명 비밀값으로 검증하고 data.call_id를 읽어요. 그다음 xAI API 키로 wss://api.x.ai/v1/realtime?call_id={call_id}에 붙어 session.update로 음성 에이전트를 설정하고, 말을 시작할 때 response.create를 보내요.
Python
- 시험 통화를 걸어요
웹훅 서버를 실행하고 내 휴대폰으로 070 번호에 전화를 걸어요. 음성 에이전트가 받으면 끝나요. 주소를 저장하고 1분이 지나기 전에 걸면 끊길 수 있어요.
발신: 지원 안 함
xAI 문서는 Grok 음성 에이전트가 SIP 트렁크로 전화를 거는 방법을 안내하지 않아요. 그래서 Telkit 070 번호로 전화를 걸 수 없어요. 발신이 되는 플랫폼은 지원 플랫폼에서 확인해요.문제 해결
더 있다면 문제 해결을 봐 주세요.
관련 쪽
지원 플랫폼
수신과 발신이 되는 플랫폼을 한눈에 봐요.
한도와 동시 통화
통화가 막혔을 때 한도를 확인해요.
xAI SIP 문서
xAI의 SIP 전화 문서예요.
에이전트에게 맡기기
이 연결을 에이전트에게 통째로 맡겨요.