대상 목록

할 수 있는 일

인증한 계정에서 발신 대상으로 고를 수 있는 에이전트와 크루를 조회해요. 통화 생성의 agentId 또는 crewId에 이 목록의 id를 넣어요. 키에 실행 대상을 묶지 않고 매 요청에서 대상을 지정해요.

GET https://api.telloai.io/v1/agents

curl "https://api.telloai.io/v1/agents" \
  --header "Authorization: Bearer <API_KEY>"

삭제되지 않았고 배포 상태인 에이전트를 돌려줘요. id 오름차순이에요. 쿼리나 요청 본문은 필요 없어요.

200 예시

{
  "data": [
    {
      "id": "12",
      "name": "예약 안내",
      "description": "예약 일정을 확인하고 변경을 도와줘요"
    }
  ]
}

에이전트 목록은 배포 상태를 기준으로 해요. 실제 통화 생성 시점에는 운영에 반영된 판이 여전히 유효한지도 확인하므로, 목록을 읽은 뒤 설정이 바뀌면 생성이 거절될 수 있어요.

GET https://api.telloai.io/v1/crews

curl "https://api.telloai.io/v1/crews" \
  --header "Authorization: Bearer <API_KEY>"

삭제되지 않았고 운영에 반영된 판이 활성 상태인 크루를 돌려줘요. id 오름차순이에요. 크루 원본을 편집 중이어도 기존 운영 판이 활성 상태면 목록에 남아요. 쿼리나 요청 본문은 필요 없어요.

200 예시

{
  "data": [
    {
      "id": "34",
      "name": "예약 접수 흐름",
      "description": null
    }
  ]
}

두 엔드포인트 모두 성공하면 **200 OK와 { data }**가 와요. data는 아래 필드를 가진 객체 배열이에요. 대상이 없으면 빈 배열이에요. 통화 목록과 달리 nextCursor는 없어요.

필드	타입	설명
`id`	문자열	에이전트 또는 크루 id예요. 숫자로 이루어진 문자열로 와요
`name`	문자열	대상 이름이에요
`description`	문자열 또는 `null`	에이전트의 역할 설명 또는 크루 설명이에요. 없으면 `null`이에요

에이전트 id와 크루 id는 값이 겹칠 수 있어요. /agents에서 받은 id는 agentId에, /crews에서 받은 id는 crewId에 넣으세요. 통화 생성에는 둘 중 정확히 하나만 넣어요.

이 목록에는 기본 대상 표시나 필수 시작 변수 목록을 싣지 않아요. 크루가 요구하는 시작 값은 통화 생성의 필수 변수 규칙을 확인하세요. 인증·처리 오류는 REST 오류에 있어요.