메인 콘텐츠로 건너뛰기
OpenAI의 SIP를 거쳐 Telkit 070 번호로 전화를 받아요. 수신만 되고 발신은 지원하지 않아요.

준비물

수신

Telkit 번호로 걸려 온 전화를 GPT-Live 음성 에이전트가 받아요. 전화가 올 때마다 OpenAI가 내 웹훅 서버에 알림을 보내고, 서버가 accept를 보내야 통화가 시작돼요.

  1. OpenAI에서 웹훅을 만들어요

OpenAI settings에서 프로젝트를 열고 Webhooks에서 Create를 눌러 아래처럼 채워요. 자세한 칸은 OpenAI 웹훅 문서를 봐요. 만들면 서명 비밀값이 한 번만 보여요. 웹훅 서버의 환경 변수 OPENAI_WEBHOOK_SECRET에 넣어 두세요. 같은 프로젝트의 General에서 프로젝트 ID를 확인해요. proj_로 시작해요.

  1. Telkit 번호를 OpenAI로 넘겨요

SIP 주소는 sip:{프로젝트 ID}@sip.api.openai.com이에요. 유럽에 데이터를 두는 프로젝트는 sip-eu.api.openai.com을 써요. 아래 proj_abc123을 1단계에서 확인한 프로젝트 ID로 바꿔요.

Telkit 070 번호로 걸려 온 전화를 OpenAI 프로젝트의 SIP 주소로 넘기는 한 줄이에요.

전송, 음성 암호화, 번호 형식은 기본값 그대로 둬요. OpenAI는 TLS 신호와 SRTP 음성을 요구하고, Telkit 기본값이 TLS와 SDES SRTP예요. Telkit이 보내는 전화

  1. 웹훅 서버에서 전화를 받아요

전화가 오면 OpenAI가 웹훅으로 live.transport.incoming 알림을 보내요. 서버는 서명을 검증하고, data.type이 sip이면 data.session_id를 그대로 써서 POST /v1/live/sessions/{session_id}/accept를 보내요. 200이 오면 통화가 시작돼요. 같은 알림이 다시 올 수 있으니 webhook-id 헤더로 한 번만 처리해 주세요.
Node.js
accept 본문에 audio.format은 넣지 않아요. 음성 형식은 SIP가 정해요. 받지 않을 전화는 POST /v1/live/sessions/{session_id}/reject에 {"status_code": 486}처럼 300 ~ 699 사이의 SIP 응답 코드를 보내요. 도구와 통화 중 이벤트는 OpenAI SIP 문서를 봐요.

  1. 시험 통화를 걸어요

웹훅 서버를 실행하고 내 휴대폰으로 070 번호에 전화를 걸어요. 음성 에이전트가 받으면 끝나요. 주소를 저장하고 1분이 지나기 전에 걸면 끊길 수 있어요.

발신: 지원 안 함

OpenAI API 레퍼런스는 SIP 트렁크에 Opus를 요구하고 Telkit 발신은 G.711만 받아요. 그래서 OpenAI 음성 에이전트가 Telkit 070 번호로 전화를 걸 수 없어요. 발신이 되는 플랫폼은 지원 플랫폼에서 확인해요.

문제 해결

더 있다면 문제 해결을 봐 주세요.

지원 플랫폼

수신과 발신이 되는 플랫폼을 한눈에 봐요.

한도와 동시 통화

통화가 막혔을 때 한도를 확인해요.

OpenAI SIP 문서

OpenAI의 전화와 SIP 문서예요.

에이전트에게 맡기기

이 연결을 에이전트에게 통째로 맡겨요.