Gong

Access Gong conversation intelligence - calls, transcripts, users, and analytics.

Setup

Store credentials in `~/.config/gong/credentials.json`:

```json

{

"base_url": "https://us-XXXXX.api.gong.io",

"access_key": "YOUR_ACCESS_KEY",

"secret_key": "YOUR_SECRET_KEY"

}

```

Get credentials from Gong: Settings → Ecosystem → API → Create API Key.

Authentication

```bash

GONG_CREDS=~/.config/gong/credentials.json

GONG_BASE=$(jq -r '.base_url' $GONG_CREDS)

GONG_AUTH=$(jq -r '"\(.access_key):\(.secret_key)"' $GONG_CREDS | base64)

curl -s "$GONG_BASE/v2/endpoint" \

-H "Authorization: Basic $GONG_AUTH" \

-H "Content-Type: application/json"

```

Core Operations

List Users

```bash

curl -s "$GONG_BASE/v2/users" -H "Authorization: Basic $GONG_AUTH" | \

jq '[.users[] | {id, email: .emailAddress, name: "\(.firstName) \(.lastName)"}]'

```

List Calls (with date range)

```bash

curl -s -X POST "$GONG_BASE/v2/calls/extensive" \

-H "Authorization: Basic $GONG_AUTH" \

-H "Content-Type: application/json" \

-d '{

"filter": {

"fromDateTime": "2025-01-01T00:00:00Z",

"toDateTime": "2025-01-31T23:59:59Z"

},

"contentSelector": {}

}' | jq '{

total: .records.totalRecords,

calls: [.calls[] | {

id: .metaData.id,

title: .metaData.title,

started: .metaData.started,

duration_min: ((.metaData.duration // 0) / 60 | floor),

url: .metaData.url

}]

}'

```

Get Call Transcript

```bash

curl -s -X POST "$GONG_BASE/v2/calls/transcript" \

-H "Authorization: Basic $GONG_AUTH" \

-H "Content-Type: application/json" \

-d '{"filter": {"callIds": ["CALL_ID"]}}' | \

jq '.callTranscripts[0].transcript[] | "\(.speakerName // "Speaker"): \(.sentences[].text)"' -r

```

Get Call Details

```bash

curl -s -X POST "$GONG_BASE/v2/calls/extensive" \

-H "Authorization: Basic $GONG_AUTH" \

-H "Content-Type: application/json" \

-d '{

"filter": {"callIds": ["CALL_ID"]},

"contentSelector": {"exposedFields": {"content": true, "parties": true}}

}' | jq '.calls[0]'

```

Activity Stats

```bash

curl -s -X POST "$GONG_BASE/v2/stats/activity/aggregate" \

-H "Authorization: Basic $GONG_AUTH" \

-H "Content-Type: application/json" \

-d '{

"filter": {

"fromDateTime": "2025-01-01T00:00:00Z",

"toDateTime": "2025-01-31T23:59:59Z"

}

}'

```

Endpoints Reference

| Endpoint | Method | Use |

|----------|--------|-----|

| `/v2/users` | GET | List users |

| `/v2/calls/extensive` | POST | List/filter calls |

| `/v2/calls/transcript` | POST | Get transcripts |

| `/v2/stats/activity/aggregate` | POST | Activity stats |

| `/v2/meetings` | GET | Scheduled meetings |

Pagination

Responses include cursor for pagination:

```json

{"records": {"totalRecords": 233, "cursor": "eyJ..."}}

```

Include cursor in next request: `{"cursor": "eyJ..."}`

Date Helpers

```bash

Last 7 days

FROM=$(date -v-7d +%Y-%m-%dT00:00:00Z 2>/dev/null || date -d "7 days ago" +%Y-%m-%dT00:00:00Z)

TO=$(date +%Y-%m-%dT23:59:59Z)

```

Notes