Skip to main content

​
Aircall 정보

Aircall은 클라우드 기반 비즈니스 전화 시스템이자 콜센터 플랫폼입니다. Aircall 소스는 통화, 사용자 및 팀 활동을 Iru로 가져와 컴플라이언스 프레임워크에 증거를 첨부할 수 있도록 합니다. 인증은 Aircall Public API에 대해 HTTP Basic을 사용합니다(api_id를 사용자 이름으로, api_token을 비밀번호로 사용).

​
작동 방식

Iru는 HTTP Basic을 사용하여 HTTPS를 통해 Aircall Public API를 호출합니다. **api_id**를 사용자 이름으로, **api_token**을 비밀번호로 사용합니다(Basic authentication 참조). 공식 참고 자료: Basic authentication, API references.

​
사전 요구 사항

  • Aircall 계정의 관리자 또는 소유자(일반 사용자는 API 키를 생성할 수 없음).
  • 설정에 약 5분.
  • Aircall API 트래픽을 위한 HTTPS.
  • 커넥터 마법사가 열릴 수 있도록 브라우저 팝업 허용.

​
Aircall을 Iru에 연결

Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
1

Aircall에 로그인

Aircall Dashboard를 열고 관리자 또는 소유자 권한이 있는 계정으로 로그인하세요(해당 역할만 API 키를 생성할 수 있음).
2

Integrations & API 열기

왼쪽 사이드바에서 Integrations & API를 선택하세요(문구는 Aircall UI 버전에 따라 약간 다를 수 있음).
3

API 키로 이동

워크스페이스의 레이블에 따라 Aircall API 섹션 또는 API 키 탭을 여세요.
4

새 API 키 생성

Add a new API Key 또는 Generate an API Key를 선택하세요. 명확한 이름(예: Iru Compliance)을 입력하고 확인하면 Aircall이 키 쌍을 생성합니다.
5

api_id 및 api_token 복사

Aircall은 **api_id**와 **api_token**을 함께 표시합니다. 두 값을 모두 안전한 곳에 복사하세요. Iru의 Basic Authentication 단계에서 **api_id**를 사용자 이름으로, **api_token**을 암호로 사용합니다.**api_token**은 한 번만 표시됩니다. 분실한 경우 Aircall에서 이 키를 삭제하고 새 키를 생성한 다음 새 값으로 Iru를 업데이트하세요.
Iru Compliance 탭에서 계속 진행하세요.

​
고려 사항

  • 계정 전체 키: API 키는 단일 사용자가 아닌 계정에 적용됩니다. 팀이 Aircall에서 키를 교체하거나 삭제하지 않는 한, 키를 생성한 사람이 퇴사해도 통합은 계속 작동할 수 있습니다.
  • 속도 제한: Aircall Public API의 기본값은 분당 60개 요청입니다. 제한에 도달하면 Iru는 백오프를 적용합니다. 비정상적으로 잦은 수동 증거 새로 고침은 여전히 429 응답을 유발할 수 있습니다. 문제 해결을 참조하세요.
  • 액세스 모드: Iru는 이 연결을 읽기 중심의 컴플라이언스 증거에 사용합니다. **api_token**은 여전히 Aircall이 해당 키에 할당한 액세스 수준을 부여합니다. 시크릿처럼 저장하고 교체하세요.

​
문제 해결

Iru 사이트에 대한 팝업 차단 설정을 확인하고 다시 시도하세요.
**api_token**이 잘못되었거나 Aircall에서 키가 삭제되었을 수 있습니다. Aircall에서 새 API 키를 생성하고 Iru에 새 api_id / **api_token**을 제출하세요.
Aircall의 속도 제한(기본값 분당 60개 요청)에 도달했습니다. Iru는 자동으로 백오프합니다. 429가 계속되면 Aircall 지원팀에 더 높은 제한에 대해 문의하세요.
관리자 또는 소유자만 키를 생성할 수 있습니다. Aircall 관리자에게 키 생성을 요청하거나 역할을 업데이트하세요.

​
관련 문서

소스 관리

모든 Compliance 소스를 찾아보고 관리합니다.

컴플라이언스 시작하기

프레임워크, 작업 및 아티팩트입니다.

Iru 개요

Endpoint, Compliance 및 Identity가 함께 작동하는 방식입니다.

아티팩트 관리

소스 및 작업의 증거를 업로드, 검토 및 정리합니다.