개발자(음성)
조직 ID와 에이전트 ID를 찾고, 웹훅을 관리하고, API 키와 공개 API 엔드포인트를 확인합니다.
찾는 위치
음성 › 음성 개요 › 개발자
이 화면 열기
단계
- 음성 › 음성 개요를 열고 개발자에서 페이지 열기를 누르세요.
- 에이전트 ID / API에서 조직 ID, 조직 슬러그 또는 에이전트 ID를 복사하세요.
- 웹훅에서 엔드포인트 추가를 눌러 내 https 주소로 통화 및 연락처 이벤트를 받으세요.
- API 키에서 키, 마지막 사용 시점, 상태(활성 또는 취소됨)를 확인하세요.
- 공개 엔드포인트와 문서에서 엔드포인트를 복사하거나 API 참조 열기를 누르세요.
이 화면의 설정
| 설정 | 기능 | 기본값 |
|---|---|---|
| 에이전트 ID / API | 조직 ID, 조직 슬러그, API 모드(샌드박스 또는 운영 중), 선택한 AI 에이전트의 에이전트 ID. | — |
| 웹훅 | 내 https 엔드포인트, 이벤트, 마지막 전송, 실패. | — |
| API 키 | CallDesk 운영자가 발급한 키: 이름, 앞부분 문자, 범위, 마지막 사용, 요청, 상태. | — |
| 공개 엔드포인트 | /api/v1 엔드포인트(각각 복사 버튼 포함)와 에이전트 채팅 엔드포인트. | — |
| 문서 | API 참조와 OpenAPI(JSON)를 엽니다. | — |
팁
- 키는 “Authorization: Bearer <key>” 형식으로 보내세요.
알아 두세요
- 누구나 이 페이지를 볼 수 있고, 웹훅 추가·테스트·삭제는 매니저만 할 수 있습니다.
- 에이전트 음성으로 답변을 말하는 API 엔드포인트는 없으며, 해당 행에는 아직 연결되지 않음이 표시됩니다.
관련 사용 방법
- 조직 ID와 에이전트 ID 복사 공개 API를 호출하는 데 필요한 식별자를 가져옵니다.
- 웹훅 추가 및 테스트 통화와 연락처 이벤트를 내 https 엔드포인트로 받습니다. 이벤트에는 서명이 있어 CallDesk에서 온 것인지 확인할 수 있습니다.
- API 키 확인 조직에 어떤 API 키가 있고 어떻게 쓰이는지 확인합니다.
- 공개 API 엔드포인트와 문서 통화와 에이전트용 API 엔드포인트를 찾고 전체 참조 문서를 엽니다.
- 개발자: 웹훅 문제 해결 개발자 페이지에 표시될 수 있는 메시지를 해결합니다.
- 개발자를 위한 API 레퍼런스 자체 앱을 워크스페이스에 연결합니다: REST API, 키와 범위, 오류, 요청 제한, 웹훅.