ComposioHQ/Gong-Automation

Gong Automation

Gewinnen Sie Erkenntnisse aus Ihren Verkaufsgesprächen – rufen Sie Transkripte ab, analysieren Sie Anrufdaten nach Datumsbereich, greifen Sie auf detaillierte Gesprächsanalysen mit Themen und Trackern zu und verwalten Sie Arbeitsbereiche – alles über natürliche Sprachbefehle.

Toolkit-Dokumentation: composio.dev/toolkits/gong

---

Einrichtung

1. Fügen Sie den Composio MCP-Server zu Ihrer Client-Konfiguration hinzu:

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Gong-Konto, wenn Sie dazu aufgefordert werden (OAuth / Bearer-Token-Authentifizierung).
3. Beginnen Sie mit der Ausgabe von natürlichen Sprachbefehlen zur Analyse Ihrer Anrufdaten.

---

Kern-Workflows

1. Anruftranskripte nach Datumsbereich abrufen

Holen Sie sich Transkripte für alle Anrufe innerhalb eines bestimmten Zeitraums, optional gefiltert nach bestimmten Anruf-IDs oder Arbeitsbereichen.

Tool: GONG_RETRIEVE_TRANSCRIPTS_OF_CALLS_V2_CALLS_TRANSCRIPT

Beispielaufforderung:

"Holen Sie mir Gong-Transkripte für alle Anrufe vom 1. bis 10. Februar 2025"

Wichtige Parameter:

• filter__fromDateTime – ISO-8601 Startdatum (z. B. 2025-02-01T00:00:00Z)
• filter__toDateTime – ISO-8601 Enddatum (z. B. 2025-02-10T23:59:59Z)
• filter__callIds – Optionales Array mit spezifischen Anruf-IDs zum Filtern
• filter__workspaceId – Optionaler Filter für Arbeitsbereichs-ID
• cursor – Seitennummerierungs-Cursor aus der vorherigen Antwort

Erforderlicher Bereich: api:calls:read:transcript

---

2. Transkript für bestimmte Anrufe abrufen

Rufen Sie Transkripte mit Sprecherinformationen, Zeitstempeln und Themenkategorisierung mithilfe eines Filterobjekts ab.

Tool: GONG_GET_CALL_TRANSCRIPT

Beispielaufforderung:

"Holen Sie das Gong-Transkript für Anruf-ID 555785916001072125"

Wichtige Parameter (Filter erforderlich):

• filter.callIds – Array mit spezifischen Anruf-IDs (z. B. ["555785916001072125"])
• filter.fromDateTime – ISO-8601 Startdatum
• filter.toDateTime – ISO-8601 Enddatum
• filter.workspaceId – Optionaler Arbeitsbereichsfilter
• cursor – Seitennummerierungs-Cursor

---

3. Anrufe nach Datumsbereich auflisten

Rufen Sie grundlegende Anrufmetadaten (Teilnehmer, Dauer, Zeitplan) für Anrufe innerhalb eines Datumsbereichs ab.

Tool: GONG_RETRIEVE_CALL_DATA_BY_DATE_RANGE_V2_CALLS

Beispielaufforderung:

"Listen Sie alle Gong-Anrufe von letzter Woche auf"

Wichtige Parameter (beide erforderlich):

• fromDateTime – ISO-8601 Startdatum (z. B. 2025-02-03T00:00:00Z)
• toDateTime – ISO-8601 Enddatum (z. B. 2025-02-10T00:00:00Z)
• workspaceId – Optionaler Arbeitsbereichsfilter
• cursor – Seitennummerierungs-Cursor

Erforderlicher Bereich: api:calls:read:basic

---

4. Detaillierte Anrufanalysen abrufen

Rufen Sie umfangreiche Anrufdetails ab, einschließlich Highlights, Kernpunkten, Themen, Trackern, Sprecherstatistiken, Fragen und Medien-URLs.

Tool: GONG_RETRIEVE_FILTERED_CALL_DETAILS

Beispielaufforderung:

"Holen Sie detaillierte Analysen für Gong-Anrufe dieser Woche, einschließlich Themen, Kernpunkte und Sprecherstatistiken"

Wichtige Parameter:

• filter__fromDateTime / filter__toDateTime – Datumsbereichsfilter
• filter__callIds – Spezifische Anruf-IDs
• filter__primaryUserIds – Filtern nach Benutzer-IDs der Anrufmoderatoren
• Inhaltsselektoren (alle boolesch):
  • contentSelector__exposedFields__content__keyPoints – Kernpunkte des Anrufs
  • contentSelector__exposedFields__content__topics – Themendauern
  • contentSelector__exposedFields__content__highlights – Anruf-Highlights
  • contentSelector__exposedFields__content__outline – Anruf-Gliederung
  • contentSelector__exposedFields__content__brief – Spotlight-Anrufzusammenfassung
  • contentSelector__exposedFields__content__callOutcome – Anrufergebnis
  • contentSelector__exposedFields__content__trackers – Smart-/Keyword-Tracker
  • contentSelector__exposedFields__content__trackerOccurrences – Tracker-Timing und Sprecher (erfordert trackers=true)
  • contentSelector__exposedFields__interaction__speakers – Sprechzeit jedes Teilnehmers
  • contentSelector__exposedFields__interaction__questions – Frageanzahl
  • contentSelector__exposedFields__interaction__personInteractionStats – Moderatorstatistiken
  • contentSelector__exposedFields__media – Audio-/Video-URLs (8 Stunden gültig)
  • contentSelector__exposedFields__parties – Parteieninformationen
  • contentSelector__exposedFields__collaboration__publicComments – Öffentliche Kommentare
• contentSelector__context – "Basic", "Extended" oder "None" für CRM-/externe Systemlinks

Erforderlicher Bereich: api:calls:read:extensive (plus api:calls:read:media-url für Medien)

---

5. Bestimmten Anruf nach ID abrufen

Rufen Sie grundlegende Daten für einen einzelnen Anruf mithilfe seiner eindeutigen Gong-ID ab.

Tool: GONG_RETRIEVE_DATA_FOR_A_SPECIFIC_CALL_V2_CALLS_ID

Beispielaufforderung:

"Holen Sie Details zum Gong-Anruf 1223781272986876929"

Wichtige Parameter (erforderlich):

• id – Gongs eindeutige numerische Kennung für den Anruf (bis zu 20 Stellen)

Erforderlicher Bereich: api:calls:read:basic

---

6. Firmenarbeitsbereiche auflisten

Rufen Sie alle Arbeitsbereiche in Ihrer Gong-Organisation ab, um Arbeitsbereichs-IDs für die Filterung zu erhalten.

Tool: GONG_LIST_ALL_COMPANY_WORKSPACES_V2_WORKSPACES

Beispielaufforderung:

"Listen Sie alle Gong-Arbeitsbereiche in meinem Unternehmen auf"

Wichtige Parameter: Keine erforderlich.

Erforderlicher Bereich: api:workspaces:read

---

Bekannte Fallstricke

• ISO-8601-Datumsformat ist zwingend erforderlich: Alle Datumsparameter müssen das ISO-8601-Format mit Zeitzone verwenden: 2025-02-01T00:00:00Z oder 2025-02-01T02:30:00-07:00. Einfache Daten schlagen fehl.
• Datumsbereich ist ausschließlich bei toDateTime: Der Parameter toDateTime gibt Anrufe zurück, die BIS ZU, ABER AUSSCHLIESSLICH der angegebenen Zeit gestartet wurden. Um Anrufe an einem bestimmten Tag einzuschließen, setzen Sie toDateTime auf den nächsten Tag.
• Seitennummerierung ist für große Ergebnismengen erforderlich: Alle Listenendpunkte geben paginierte Ergebnisse zurück. Verwenden Sie den cursor-Wert aus der vorherigen Antwort, um die nächste Seite abzurufen. Fahren Sie fort, bis kein Cursor mehr zurückgegeben wird.
• Berechtigungsanforderungen variieren je nach Endpunkt: Verschiedene Endpunkte erfordern unterschiedliche API-Berechtigungen. Transkriptzugriff benötigt api:calls:read:transcript, grundlegende Anrufdaten benötigen api:calls:read:basic, und detaillierte Analysen benötigen api:calls:read:extensive.
• Medien-URLs laufen nach 8 Stunden ab: Audio- und Video-URLs, die vom Endpunkt für detaillierte Anrufe zurückgegeben werden, sind temporär und laufen nach 8 Stunden ab.
• Verfügbarkeit von Tracker-Vorkommensdaten: Tracker-Vorkommensdaten (Timing und Sprecher-ID) sind nur für Anrufe verfügbar, die ab dem 1. Januar 2023 aufgezeichnet wurden. Wenden Sie sich an den Gong-Support für eine Nachbereitung.
• Webkonferenzen vs. reguläre Anrufe: Bei Webkonferenz-Anrufen, die von Gong aufgezeichnet wurden, gibt das Datum die geplante Zeit an. Bei anderen Anrufen gibt es die tatsächliche Startzeit an.

---

Kurzreferenz

Aktion	Tool-Kurzname	Erforderliche Parameter
Transkripte nach Datum abrufen	GONG_RETRIEVE_TRANSCRIPTS_OF_CALLS_V2_CALLS_TRANSCRIPT	Keine (Datumsbereich empfohlen)
Anruftranskript abrufen	GONG_GET_CALL_TRANSCRIPT	filter-Objekt
Anrufe nach Datum auflisten	GONG_RETRIEVE_CALL_DATA_BY_DATE_RANGE_V2_CALLS	fromDateTime, toDateTime
Detaillierte Anrufanalysen abrufen	GONG_RETRIEVE_FILTERED_CALL_DETAILS	Keine (Datumsbereich oder Anruf-IDs empfohlen)
Bestimmten Anruf abrufen	GONG_RETRIEVE_DATA_FOR_A_SPECIFIC_CALL_V2_CALLS_ID	id
Arbeitsbereiche auflisten	GONG_LIST_ALL_COMPANY_WORKSPACES_V2_WORKSPACES	Keine

---

Bereitgestellt von Composio