Gong 자동화
영업 통화에서 인사이트를 확보하세요. 녹취록 검색, 기간별 통화 데이터 분석, 토픽 및 트래커를 포함한 상세 대화 분석, 워크스페이스 관리까지 모든 것을 자연어 명령으로 처리할 수 있습니다.
툴킷 문서: composio.dev/toolkits/gong
설정
- 클라이언트 구성에 Composio MCP 서버를 추가하세요:
https://rube.app/mcp - 프롬프트가 표시되면 Gong 계정을 연결하세요 (OAuth / Bearer 토큰 인증).
- 자연어 명령을 입력하여 통화 데이터를 분석하기 시작하세요.
핵심 워크플로우
1. 기간별 통화 녹취록 검색
지정된 기간 내 모든 통화의 녹취록을 가져옵니다. 특정 통화 ID나 워크스페이스로 필터링할 수 있습니다.
도구: GONG_RETRIEVE_TRANSCRIPTS_OF_CALLS_V2_CALLS_TRANSCRIPT
예시 프롬프트:
"2025년 2월 1일부터 10일까지의 Gong 녹취록을 가져와줘"
주요 파라미터:
filter__fromDateTime-- ISO-8601 시작 날짜 (예:2025-02-01T00:00:00Z)filter__toDateTime-- ISO-8601 종료 날짜 (예:2025-02-10T23:59:59Z)filter__callIds-- 특정 통화 ID 배열 (선택 사항)filter__workspaceId-- 워크스페이스 ID 필터 (선택 사항)cursor-- 이전 응답의 페이지네이션 커서
필요한 스코프: api:calls:read:transcript
2. 특정 통화의 녹취록 가져오기
필터 객체를 사용하여 화자 정보, 타임스탬프, 토픽 분류가 포함된 녹취록을 검색합니다.
도구: GONG_GET_CALL_TRANSCRIPT
예시 프롬프트:
"통화 ID 555785916001072125의 Gong 녹취록을 가져와줘"
주요 파라미터 (필터 필수):
filter.callIds-- 특정 통화 ID 배열 (예:["555785916001072125"])filter.fromDateTime-- ISO-8601 시작 날짜filter.toDateTime-- ISO-8601 종료 날짜filter.workspaceId-- 워크스페이스 필터 (선택 사항)cursor-- 페이지네이션 커서
3. 날짜 범위로 통화 목록 조회
지정된 기간 내 통화의 기본 메타데이터(참가자, 통화 시간, 일시)를 검색합니다.
도구: GONG_RETRIEVE_CALL_DATA_BY_DATE_RANGE_V2_CALLS
예시 프롬프트:
"지난주 모든 Gong 통화를 나열해줘"
주요 파라미터 (둘 다 필수):
fromDateTime-- ISO-8601 시작 날짜 (예:2025-02-03T00:00:00Z)toDateTime-- ISO-8601 종료 날짜 (예:2025-02-10T00:00:00Z)workspaceId-- 워크스페이스 필터 (선택 사항)cursor-- 페이지네이션 커서
필요한 스코프: api:calls:read:basic
4. 상세 통화 분석 가져오기
하이라이트, 핵심 포인트, 토픽, 트래커, 화자 통계, 질문, 미디어 URL을 포함한 광범위한 통화 세부 정보를 검색합니다.
도구: GONG_RETRIEVE_FILTERED_CALL_DETAILS
예시 프롬프트:
"이번 주 Gong 통화에 대한 상세 분석을 토픽, 핵심 포인트, 화자 통계와 함께 가져와줘"
주요 파라미터:
filter__fromDateTime/filter__toDateTime-- 날짜 범위 필터filter__callIds-- 특정 통화 IDfilter__primaryUserIds-- 통화 호스트 사용자 ID로 필터링- 콘텐츠 선택자 (모두 불리언):
contentSelector__exposedFields__content__keyPoints-- 통화의 핵심 포인트contentSelector__exposedFields__content__topics-- 토픽 지속 시간contentSelector__exposedFields__content__highlights-- 통화 하이라이트contentSelector__exposedFields__content__outline-- 통화 개요contentSelector__exposedFields__content__brief-- 스포트라이트 통화 요약contentSelector__exposedFields__content__callOutcome-- 통화 결과contentSelector__exposedFields__content__trackers-- 스마트/키워드 트래커contentSelector__exposedFields__content__trackerOccurrences-- 트래커 발생 시점 및 화자 (trackers=true 필요)contentSelector__exposedFields__interaction__speakers-- 각 참가자의 발언 시간contentSelector__exposedFields__interaction__questions-- 질문 수contentSelector__exposedFields__interaction__personInteractionStats-- 호스트 통계contentSelector__exposedFields__media-- 오디오/비디오 URL (8시간 유효)contentSelector__exposedFields__parties-- 당사자 정보contentSelector__exposedFields__collaboration__publicComments-- 공개 댓글
contentSelector__context-- CRM/외부 시스템 링크의 경우 "Basic", "Extended", 또는 "None"
필요한 스코프: api:calls:read:extensive (미디어의 경우 api:calls:read:media-url 추가 필요)
5. 특정 통화 ID로 정보 가져오기
고유한 Gong ID를 사용하여 단일 통화의 기본 데이터를 검색합니다.
도구: GONG_RETRIEVE_DATA_FOR_A_SPECIFIC_CALL_V2_CALLS_ID
예시 프롬프트:
"Gong 통화 1223781272986876929의 세부 정보를 가져와줘"
주요 파라미터 (필수):
id-- 통화의 Gong 고유 숫자 식별자 (최대 20자리)
필요한 스코프: api:calls:read:basic
6. 회사 워크스페이스 목록 조회
Gong 조직의 모든 워크스페이스를 검색하여 필터링에 사용할 워크스페이스 ID를 가져옵니다.
도구: GONG_LIST_ALL_COMPANY_WORKSPACES_V2_WORKSPACES
예시 프롬프트:
"내 회사의 모든 Gong 워크스페이스를 나열해줘"
주요 파라미터: 없음.
필요한 스코프: api:workspaces:read
알려진 문제점
- ISO-8601 날짜 형식 필수: 모든 날짜 파라미터는 시간대를 포함한 ISO-8601 형식(
2025-02-01T00:00:00Z또는2025-02-01T02:30:00-07:00)을 사용해야 합니다. 일반 날짜는 실패합니다. - toDateTime 날짜 범위는 제외됨:
toDateTime파라미터는 지정된 시간 전까지 시작된 통화를 반환합니다. 특정 일자의 통화를 포함하려면toDateTime을 다음 날로 설정하세요. - 대규모 결과 집합에는 페이지네이션 필요: 모든 목록 엔드포인트는 페이지네이션된 결과를 반환합니다. 이전 응답의
cursor값을 사용하여 다음 페이지를 가져오세요. 커서가 반환되지 않을 때까지 계속합니다. - 엔드포인트별 스코프 요구 사항 상이: 다른 엔드포인트는 다른 API 스코프가 필요합니다. 녹취록 접근은
api:calls:read:transcript, 기본 통화 데이터는api:calls:read:basic, 상세 분석은api:calls:read:extensive가 필요합니다. - 미디어 URL은 8시간 후 만료: 상세 통화 엔드포인트에서 반환된 오디오 및 비디오 URL은 임시적이며 8시간 후 만료됩니다.
- 트래커 발생 데이터 가용성: 트래커 발생 데이터(시점 및 화자 ID)는 2023년 1월 1일 이후 녹화된 통화에 대해서만 사용 가능합니다. 백필을 위해 Gong 지원팀에 문의하세요.
- 웹 회의 통화 vs. 일반 통화: Gong이 녹화한 웹 회의 통화의 경우 날짜는 예약된 시간을 나타냅니다. 다른 통화의 경우 실제 시작 시간을 나타냅니다.
빠른 참조
| 작업 | 도구 슬러그 | 필수 파라미터 |
|---|---|---|
| 날짜별 녹취록 가져오기 | GONG_RETRIEVE_TRANSCRIPTS_OF_CALLS_V2_CALLS_TRANSCRIPT | 없음 (날짜 범위 권장) |
| 통화 녹취록 가져오기 | GONG_GET_CALL_TRANSCRIPT | filter 객체 |
| 날짜별 통화 목록 조회 | GONG_RETRIEVE_CALL_DATA_BY_DATE_RANGE_V2_CALLS | fromDateTime, toDateTime |
| 상세 통화 분석 가져오기 | GONG_RETRIEVE_FILTERED_CALL_DETAILS | 없음 (날짜 범위 또는 통화 ID 권장) |
| 특정 통화 정보 가져오기 | GONG_RETRIEVE_DATA_FOR_A_SPECIFIC_CALL_V2_CALLS_ID | id |
| 워크스페이스 목록 조회 | GONG_LIST_ALL_COMPANY_WORKSPACES_V2_WORKSPACES | 없음 |
Composio 제공