Freshsales 정보
Iru는 Freshsales(Freshworks CRM) API에서 사용자 및 해당 역할, 역할 및 권한, 테리토리, 민감한 데이터에 대한 필드 수준 권한을 읽습니다. 인증에는 API 키와 번들 별칭을 함께 사용하며, 둘 다 Profile Settings → API Settings에서 확인할 수 있습니다. 요청 대상은https://YOUR_BUNDLE_ALIAS.myfreshworks.com/crm/sales/api입니다. 커넥터 마법사는 먼저 API 키를 받은 다음 번들 별칭을 받습니다.
Freshsales와 Freshservice는 인증 방식이 서로 다른 별개의 제품입니다. IT 서비스 관리 데이터를 연결하는 경우에는 Freshservice 문서를 참조하세요.
작동 방식
Authorization 헤더에 Token token=YOUR_API_KEY라는 문자 그대로의 형식으로 들어갑니다. API는 버전이 지정되지 않습니다. 버전 헤더나 날짜별 리비전이 없습니다.
번들 별칭은 Freshworks 조직에 CRM 계정이 둘 이상 있을 때 읽을 CRM 계정을 선택합니다. 이 때문에 해당 필드가 필수입니다. API 키는 사용자별로 발급되며 엔드포인트별 범위 없이 해당 사용자의 역할을 그대로 상속합니다.
공식 참고 자료: Freshworks CRM API.
사전 요구 사항
- 동일한 API Settings 페이지에 있는 번들 별칭과 API 키.
- 키를 생성할 전용 관리자 수준 CRM 사용자. 키는 해당 사용자의 역할을 상속하고 범위가 없으므로, 테리토리 제한이 있는 영업 사용자의 키를 사용하면 불완전한 권한 정보가 반환됩니다.
Freshsales를 Iru에 연결
- Freshsales
- Iru Compliance
Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
1
Freshsales에 로그인
통합이 액세스 권한을 상속할 관리자 수준 사용자로 Freshsales 계정에 로그인합니다.
2
Profile Settings 열기
오른쪽 상단의 프로필 사진을 선택한 다음 Profile Settings를 선택합니다.
3
API Settings 열기
API Settings 탭을 선택합니다.
4
API 키와 번들 별칭 복사
Your API key 아래에 표시된 값을 복사합니다. 같은 탭에서 API 키 바로 아래에 표시된 Bundle alias를 복사합니다. 조직에 CRM 계정이 하나뿐이더라도 이 값은 필수입니다.
Iru Compliance 탭에서 계속 진행하세요.
문제 해결
소스를 켜도 아무것도 열리지 않음
소스를 켜도 아무것도 열리지 않음
Iru 사이트에 대한 팝업 차단 설정을 확인한 후 다시 시도하세요.
401 Authentication Failure
401 Authentication Failure
API 키가 완전한지, 그리고 번들 별칭이 키가 속한 CRM 계정과 일치하는지 확인하세요. 유효한 키라도 잘못된 번들 호스트에 사용하면 잘못된 키와 동일하게 실패합니다.
실수로 Freshservice 키를 복사함
실수로 Freshservice 키를 복사함
두 제품은 서로 다른 자격 증명을 발급하고 인증 방식도 다릅니다. Freshservice 키는 여기에서 작동하지 않습니다.
사용자는 표시되지만 역할 또는 테리토리가 불완전함
사용자는 표시되지만 역할 또는 테리토리가 불완전함
키를 소유한 사용자의 역할로는 해당 항목을 볼 수 없습니다. 관리자 수준 사용자로 키를 다시 생성하세요.
마법사에서 호스트에 연결할 수 없다고 보고함
마법사에서 호스트에 연결할 수 없다고 보고함
번들 별칭은 하위 도메인만 해당합니다.
https:// 또는 .myfreshworks.com을 포함하지 마세요.관련 문서
Sources 관리
모든 Compliance 소스를 찾아보고 관리합니다.
Freshservice
ITSM 증거를 위해 Freshservice를 연결합니다.
Compliance 시작하기
프레임워크, 작업 및 아티팩트.
Artifacts 관리
소스 및 작업에서 수집한 증거를 업로드, 검토 및 정리합니다.