szerintedmi/callsitter

어떤 프로젝트인가요?

핵심 기능

• 01Telnyx를 통해 착신 전환된 전화를 OpenAI realtime 음성 에이전트로 받습니다.
• 02통화를 사기, 스팸, 정상 통화로 분류하고 그에 맞춰 에이전트의 응대를 조정합니다.
• 03정상적인 발신자의 메시지를 받아 통화 요약에 포함합니다.
• 04통화마다 Telegram 상태 메시지 하나를 보내고 실시간으로 갱신합니다.
• 05주인이 Telegram이나 브라우저에서 에이전트를 조정하거나 통화를 넘겨받을 수 있습니다.
• 06통화별 비용을 추적하고 지출, 동시 통화, 통화 한도를 적용합니다.

활용 사례

• 직접 응대하지 않고 자동 사기 전화 발신자의 시간을 낭비하게 합니다.
• 개인 번호로 걸려 온 영업 전화와 자동 발신 전화를 정중히 거절합니다.
• 전화기를 확인하기 어려운 동안 정상적인 발신자의 메시지를 받아 둡니다.
• 분류, 통화 흐름, 실시간 조정을 결합한 AI 전화 선별 시스템의 구현 방식을 살펴봅니다.

빠른 시작

1. 1

   Bun으로 의존성을 설치하세요

   bun install
2. 2

   `.env` 파일을 만들고 API 키를 입력하세요

   cp .env.example .env
3. 3

   개발 서버를 시작하고 관리자 UI를 여세요

   bun run dev

사용 전 알아둘 점

• !실제로 통화를 실행하려면 Telnyx, OpenAI, Telegram, Cloudflare 터널 등 여러 서비스의 계정과 키가 필요합니다.
• !셀프 호스팅으로 설정해야 하며 전화 통신 및 터널 구성도 필요해 상당한 작업이 듭니다.
• !통화 비용은 각 서비스 제공업체에서 청구하며, README에 설명된 지출 한도를 설정해야 합니다.

토픽

자주 묻는 질문

callsitter은(는) 무엇인가요?

주인을 대신해 전화를 받고, 사기꾼의 시간을 낭비시키고, 영업 전화를 거절하며, 실제 발신자의 메시지를 받아 주는 AI 전화 비서입니다. 전화가 Telnyx 번호로 착신 전환되면 CallSitter가 주인의 전화를 대신 받습니다. OpenAI realtime 에이전트가 대화를 처리하고, TypeSafe Jev라는 분류기가 쌓이는 대화 내용을 분석해 사기, 스팸, 정상적인 용건인지 판단합니다. 그러면 YAML 기반 통화 흐름에 따라 에이전트가 응대합니다. 사기꾼에게는 시간을 낭비하게 하고, 영업 전화는 정중히 거절하면서 수신 목록에서 삭제해 달라고 요청하며, 정상적인 발신자에게서는 메시지를 받습니다.

callsitter은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

callsitter은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

callsitter은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. callsitter의 마지막 커밋은 2026년 10월 18일입니다.

callsitter은(는) 어디에 사용할 수 있나요?

직접 응대하지 않고 자동 사기 전화 발신자의 시간을 낭비하게 합니다. 개인 번호로 걸려 온 영업 전화와 자동 발신 전화를 정중히 거절합니다. 전화기를 확인하기 어려운 동안 정상적인 발신자의 메시지를 받아 둡니다. 분류, 통화 흐름, 실시간 조정을 결합한 AI 전화 선별 시스템의 구현 방식을 살펴봅니다.

callsitter는 어떻게 설치하나요?

Bun으로 의존성을 설치하세요: bun install `.env` 파일을 만들고 API 키를 입력하세요: cp .env.example .env 개발 서버를 시작하고 관리자 UI를 여세요: bun run dev

callsitter은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/szerintedmi/callsitter