Supported file formats

Zoom Revenue Accelerator APIs support the Gong format.

Gong Metadata.json format

{
    "payload": {
        "metaData": {
            "calendarEventId": "",
            "clientUniqueId": null,
            "customData": null,
            "direction": "Conference",
            "duration": 975,
            "id": "",
            "isPrivate": false,
            "language": "en",
            "media": "Video",
            "meetingUrl": "",
            "primaryUserId": "356847842",
            "purpose": null,
            "scheduled": "2023-06-13T00:34:00Z",
            "scope": "External",
            "sdrDisposition": null,
            "started": "2023-06-13T00:50:25Z",
            "system": "Zoom",
            "title": "Meet with Hybe",
            "url": "",
            "workspaceId": ""
        },
        "parties": [
            {
                "affiliation": "External",
                "emailAddress": "",
                "id": "356847847872",
                "methods": ["Invitee", "Attendee"],
                "name": "Jerica Paz",
                "phoneNumber": "(nnn) nnn-nnnn",
                "speakerId": "35684784702",
                "title": "Developer"
            },
            {
                "affiliation": "Unknown",
                "id": "",
                "methods": ["Attendee"],
                "name": "",
                "speakerId": ""
            },
            {
                "affiliation": "Internal",
                "emailAddress": "m",
                "id": "",
                "methods": ["Attendee"],
                "name": "",
                "phoneNumber": "",
                "speakerId": "",
                "title": "",
                "userId": ""
            }
        ],
        "videoUrl": "https://hybe.s3.amazonaws.com/media-data/78852145785878/3565658685965263569/35656586568989.playback.mp4?X-Amz-Security-Token=IVhwrWvcbnWQbghijEKH%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJIMEYCIQDKxal4QOJcwxke72mhRAus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=edb1a6dbad70bc9bc34ae96ab9be15615e1db202ab97763bd912745aad8294ccf"
    }
}

Gong transcript.json format

{
    "payload": {
        "callId": "",
        "transcript": [
            {
                "sentences": [
                    {
                        "end": 440,
                        "start": 0,
                        "text": "Hello."
                    },
                    {
                        "end": 1010,
                        "start": 480,
                        "text": "Good morning!"
                    }
                ],
                "speakerId": "35684784787521127402",
                "topic": "Small Talk"
            },
            {
                "sentences": [
                    {
                        "end": 3830,
                        "start": 3390,
                        "text": "Hey, I'm good."
                    },
                    {
                        "end": 4540,
                        "start": 3870,
                        "text": "How about you?"
                    }
                ],
                "speakerId": "1959796851891129461",
                "topic": "Small Talk"
            },
            {
                "sentences": [
                    {
                        "end": 5890,
                        "start": 5330,
                        "text": "I'm doing well."
                    },
                    {
                        "end": 6830,
                        "start": 5930,
                        "text": "How was your weekend?"
                    }
                ],
                "speakerId": "5159717934028753655",
                "topic": "Small Talk"
            }
        ]
    }
}

Gong Metadata to ZRA API field mapping

ZRA Conversations API request	Gong Source field	Required or optional	Details
`host_id`	`parties.emailAddress`	Optional but highly recommended	Use these fields to retrieve it: `primaryUserId`, `parties.userId`, `emailAddress`
`file_id`	`File_id` from `/iq/files` api response	Required when adding conversation using Method #2 or Method #3
`download_url`	`videoUrl` and `audioUrl`	Required when adding a conversation using Method #1	`videoUrl` should be used if the `conversation_type` is `'meeting'`; `AudioUrl` is used if `conversation_type` is `"phone"`
`conversation_topic`	`Title`	Optional but highly recommended	Use these fields to retrieve it: `primaryUserId`, `parties.userId`, `emailAddress`
`conversation_type`	`Media`	Required	Media: `"Video"` => `conversation_type` = `"meeting"` or Media: `"Audio"` => `conversation_type` = `"phone"`
`Primary_language` (2 letter ISO 639 code)	`Language` (3 letter ISO 639 code)	Optional; Used in Method #3	Optional field
`Meeting_start_time`	`Started`	Required	Source ISO format with timezone : `2023-06-23T03:02:40-07:00`; Converted to UTC : `2023-06-23T10:02:40Z`
-	`Duration`		In seconds
`meeting_end_time`	Computed using `Started` and `Duration`	Optional	If not entered, the duration is shows as `0` min in the Conversations list in the UI
`participants`	`parties`	Required	Array of participants
`participants.display_name`	`parties.name`	Required
`participants.email`	`parties.emailAddress`	Optional	Include if available. If no email is added or email domain is different from the host's domain, it is considered as external participant