준비물
Vapi 조직이 EU 리전이면 아래 Vapi API 주소는
https://api.eu.vapi.ai, SIP 주소는 sip.eu.vapi.ai를 써요. US 리전은 https://api.vapi.ai와 sip.vapi.ai예요.
수신
Telkit 번호로 걸려 온 전화를 Vapi 음성 에이전트가 받아요.
- Vapi에서 SIP trunk credential을 만들어요
Vapi API의 POST /credential로 provider가 byo-sip-trunk인 credential을 만들어요. Vapi는 들어온 전화의 출발 IP를 숫자 IPv4로 맞춰 보므로 수신 gateway에는 주소 이름이 아니라 IP를 넣어요. 자세한 칸은 Vapi SIP trunk 문서와 gateway 칸 설명을 봐요.
Telkit이 보내는 전화
Vapi 대시보드에서는 Integrations의 Phone Number Providers에서 SIP Trunk를 고르고 Configure New SIP Trunk를 눌러 같은 값을 넣어요. gateway마다 Allow inbound calls를 켜고 Allow outbound calls를 꺼요.
응답의
id가 credential ID예요. 다음 단계와 수신 주소에 써요.
Vapi 문서는 서버를 여러 고객이 함께 쓰기 때문에 IP 인증을 권하지 않아요. Vapi는 수신 전화를 출발 IP로만 맞춰 보고 Telkit은 아이디와 비밀번호를 보내지 못해서, 수신에는 이 방법을 써요.
- Telkit 번호를 Vapi로 가져와요
Vapi 대시보드의 Phone Numbers에서 Create Phone Number를 누르고 BYO SIP Trunk Number를 골라요. API로는 POST /phone-number예요. 자세한 칸은 Vapi 번호 가져오기 예를 봐요.
응답의
id가 Vapi 번호 ID예요. 발신 시험 통화에 써요.
- Telkit 번호를 Vapi로 넘겨요
Vapi는 {번호}@CREDENTIAL_ID.sip.vapi.ai로 전화를 받아요. Telkit 번호 연결에 사용자 없이 sip:CREDENTIAL_ID.sip.vapi.ai를 넣고 번호 형식을 E.164로 하면, Telkit이 받은 070 번호를 +827012345678 모양으로 앞에 붙여 보내요. CREDENTIAL_ID는 1단계의 credential ID로 바꿔요.
전송은 TLS로 하고 srtp는 none으로 해요. Vapi 문서는 수신 전화의 음성 암호화를 안내하지 않아요.
- 에이전트
- API
Telkit 070 번호로 걸려 온 전화를 Vapi SIP 주소로 넘기는 한 줄이에요.
- 시험 통화를 걸어요
내 휴대폰으로 070 번호에 전화를 걸어요. Vapi 음성 에이전트가 받으면 끝나요. 주소를 저장하고 1분이 지나기 전에 걸면 끊길 수 있어요.
발신
Vapi 음성 에이전트가 Telkit 070 번호로 전화를 걸어요.
- 발신 접속 정보를 받아요
- 에이전트
- API
Telkit 070 번호의 발신 접속 정보를 만드는 한 줄이에요.
- Vapi credential에 발신 gateway를 더해요
수신에서 만든 credential에 발신 gateway 하나와 인증 정보를 더해요. Vapi는 이미 있는 credential을 고칠 때 PATCH /credential/CREDENTIAL_ID로 gateways 배열 전체를 보내라고 안내해요. 수신 gateway 두 개를 그대로 두고 아래 gateway를 더해 보내요. 자세한 방법은 Vapi Twilio SIP 문서의 credential 단계를 봐요.
- 시험 통화를 걸어요
비밀번호를 만들고 1 ~ 2분 뒤에 Vapi에서 내 휴대폰으로 전화를 걸어요. 대시보드에서 가져온 번호와 assistant를 고르고 받는 번호를 넣거나, POST /call/phone에 assistantId, phoneNumberId, customer.number를 보내요. 받는 번호는 +821012345678 모양으로 넣어요. 휴대폰에 내 070 번호가 뜨고 음성 에이전트가 말하면 끝나요. 방법은 Vapi 발신 문서를 봐요.
문제 해결
더 있다면 문제 해결을 봐 주세요.
관련 쪽
지원 플랫폼
수신과 발신이 되는 플랫폼을 한눈에 봐요.
한도와 동시 통화
통화가 막혔을 때 한도를 확인해요.
Vapi SIP trunk 문서
Vapi의 SIP trunk 문서예요.
에이전트에게 맡기기
이 연결을 에이전트에게 통째로 맡겨요.