# Supported file formats

<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->

Zoom Revenue Accelerator APIs support the Gong format.

## Gong Metadata.json format

```json
{
    "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

```json
{
    "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 |     |