준비물
수신
Telkit 번호로 걸려 온 전화를 GPT-Live 음성 에이전트가 받아요. 전화가 올 때마다 OpenAI가 내 웹훅 서버에 알림을 보내고, 서버가accept를 보내야 통화가 시작돼요.
- OpenAI에서 웹훅을 만들어요
OpenAI settings에서 프로젝트를 열고 Webhooks에서 Create를 눌러 아래처럼 채워요. 자세한 칸은 OpenAI 웹훅 문서를 봐요.
만들면 서명 비밀값이 한 번만 보여요. 웹훅 서버의 환경 변수
OPENAI_WEBHOOK_SECRET에 넣어 두세요.
같은 프로젝트의 General에서 프로젝트 ID를 확인해요. proj_로 시작해요.
- Telkit 번호를 OpenAI로 넘겨요
SIP 주소는 sip:{프로젝트 ID}@sip.api.openai.com이에요. 유럽에 데이터를 두는 프로젝트는 sip-eu.api.openai.com을 써요. 아래 proj_abc123을 1단계에서 확인한 프로젝트 ID로 바꿔요.
- 에이전트
- API
Telkit 070 번호로 걸려 온 전화를 OpenAI 프로젝트의 SIP 주소로 넘기는 한 줄이에요.
- 웹훅 서버에서 전화를 받아요
전화가 오면 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 문서를 봐요.
- 시험 통화를 걸어요
웹훅 서버를 실행하고 내 휴대폰으로 070 번호에 전화를 걸어요. 음성 에이전트가 받으면 끝나요. 주소를 저장하고 1분이 지나기 전에 걸면 끊길 수 있어요.
발신: 지원 안 함
OpenAI API 레퍼런스는 SIP 트렁크에 Opus를 요구하고 Telkit 발신은 G.711만 받아요. 그래서 OpenAI 음성 에이전트가 Telkit 070 번호로 전화를 걸 수 없어요. 발신이 되는 플랫폼은 지원 플랫폼에서 확인해요.문제 해결
더 있다면 문제 해결을 봐 주세요.
관련 쪽
지원 플랫폼
수신과 발신이 되는 플랫폼을 한눈에 봐요.
한도와 동시 통화
통화가 막혔을 때 한도를 확인해요.
OpenAI SIP 문서
OpenAI의 전화와 SIP 문서예요.
에이전트에게 맡기기
이 연결을 에이전트에게 통째로 맡겨요.