할 수 있는 일
Tello는 세 가지 방식으로 외부 시스템과 연결해요. 셋 다 같은 계정, 같은 에이전트, 같은 크레딧을 쓰고 발급 방식만 달라요. 대화의 두뇌를 누가 맡느냐가 셋을 가르는 기준이에요.- MCP: Claude Desktop 같은 MCP 클라이언트가 도구를 호출해요. 두뇌는 그 클라이언트예요.
- SDK: 여러분 코드가 WebSocket으로 턴을 받아 답변을 만들어요. 두뇌는 여러분 코드예요.
- A2A: 외부 AI 에이전트가 JSON-RPC로 Tello 에이전트에 작업을 넘겨요. 두뇌는 그 에이전트예요.
연동 방식 고르기
방식마다 키를 따로 발급하므로 한 계정에서 MCP와 SDK를 동시에 쓸 수 있어요. 다만 한 에이전트에
시나리오와 외부 AI 호출(A2A)을 함께 걸 수는 없어요.
시작하기 전에
어떤 방식을 고르든 발신에 필요한 조건은 같아요. 아래가 하나라도 비면 통화가 만들어지기 전에 거부돼요. 거부 코드는 조건과 1:1로 대응하니 SDK 오류 표와 함께 보면 돼요.
Free 플랜에서는 수신번호 등록으로 인증한 번호로만 발신할 수 있어요.
아무 번호로나 걸려면 유료 플랜의 전용 070 번호가 필요해요.
배포된 에이전트도 하나 있어야 해요. 에이전트는 서버가 정하므로 연동 코드에서 지정하지 않아요.
공통 규격
- 프로토콜 버전은
1.0이에요. 세 방식 모두 같은 버전을 써요. - 키는 포털에서 방식별로 발급해요. MCP 키로 SDK에 접속할 수는 없어요.
- 전화번호는 E.164 형식(
+821012345678)으로 보내요.
주의사항
- 연동 테스트에서도 실제 통화가 발신되고 크레딧이 차감돼요. 통제된 테스트 수신번호로만 시험하세요.
- 전체 키는 발급 직후 한 번만 볼 수 있어요. 분실하면 폐기 후 재발급해요.
- 폐기한 키는 즉시 쓸 수 없어요.
- 한 에이전트에 시나리오와 외부 AI 호출(A2A)을 함께 걸 수 없어요.
관련 문서
SDK 시작하기
설치부터 첫 통화까지 순서대로 따라가요
MCP
MCP 클라이언트에 Tello 도구를 붙여요
A2A
에이전트끼리 통화를 주고받아요
에이전트 관리
통화에 투입할 에이전트를 만들고 배포해요