할 수 있는 일
백엔드나 CRM에서 HTTP 요청으로 Tello 통화를 시작해요. 운영에 반영한 에이전트나 크루가 대화를 맡고, 애플리케이션은 통화 생성·조회·전환·종료를 제어해요. 턴마다 직접 답변을 만들려면 SDK나 A2A를 쓰세요.Base URL
인증
포털 개발자 연동 › API 키에서 키를 발급해요. MCP·SDK·A2A에서 쓰던 같은 서버용 키를 그대로 쓸 수 있어요. 키는 계정을 인증하고, 통화에 쓸 대상은 생성 요청마다agentId나
crewId로 지정해요.
모든 REST 엔드포인트에 아래 헤더를 붙이세요.
에이전트 목록으로 인증 확인
401 unauthenticated가
와요. 이유를 더 세분해서 알려 주지는 않아요. 키를 폐기하면 다음 REST 요청부터 거절돼요.
시작하기 전에
발신에는 크레딧, 남은 동시 발신 회선, 수신번호 인증, 발신번호 설정이 필요해요. 연동 준비에서 계정 조건을 확인하세요. 대상 목록에서 에이전트나 크루 id를 고른 뒤 통화를 생성해요. 대상은 운영에 반영된 판이 있어야 해요. REST API는 기본 대상을 자동으로 고르지 않아요.공통 규격
- 요청·응답은 JSON이고 필드 이름은 camelCase예요. 본문을 보낼 때는
Content-Type: application/json을 붙이세요. - 통화 id는
c_12345처럼c_와 숫자로 이루어진 문자열이에요. 숫자 부분을 별도 정수로 변환하지 말고 받은 문자열 그대로 저장하고 보내세요. - 에이전트·크루 id는 응답에서 숫자로 된 문자열로 와요. 생성 요청에서는 양의 정수나 그 정수를 나타내는 문자열을 쓸 수 있어요.
- 시각은 ISO-8601 형식이에요. 응답은 시간대를 명시하고, 목록 날짜 조건은 날짜·시간 필터 규칙을 따라요.
- 아직 만들어지지 않았거나 제공되지 않는 통화 필드는
null이에요. 요약이 없다는 이유로 통화가 진행 중인 것은 아니니, 진행 여부는status로 판단하세요.
오류 응답
오류는 아래 봉투로 와요. 분기는error와 HTTP 상태 코드로 하세요. message는 표시용이고
문구가 달라질 수 있어요.
401 예시
전체 코드와 대처 방법은 REST 오류에 있어요.
응답 이후의 통화
201은 발신 요청을 수락했다는 뜻이지, 상대가 받았거나 통화가 끝났다는 뜻이 아니에요.
응답을 받은 뒤 HTTP 연결을 닫아도 통화는 계속돼요. 상태와 결과는 통화 상세로 확인하고,
중단할 때는 종료 엔드포인트를 호출하세요.
네트워크 문제로 생성 요청을 다시 보낼 수 있다면 처음부터
Idempotency-Key를 붙이세요.
502 call_outcome_unknown을 받았다면 통화가 이미 시작됐을 수 있어요.
목록을 확인하지 않고 새 키로 다시 발신하지 마세요.
관련 문서
통화 생성
대상을 지정하고 중복 발신 없이 통화를 시작해요
통화 상세
상태·전사·요약·차감 크레딧을 확인해요
대상 목록
통화에 쓸 에이전트와 크루 id를 찾아요
오류
오류 코드별로 요청 수정과 재시도 방법을 확인해요