ComposioHQ/Gong-Automation

Automação Gong

Desbloqueie insights de suas chamadas de vendas — recupere transcrições, analise dados de chamadas por intervalo de datas, acesse análises detalhadas de conversas com tópicos e trackers, e gerencie workspaces — tudo através de comandos em linguagem natural.

Documentação do toolkit: composio.dev/toolkits/gong

---

Configuração

1. Adicione o servidor MCP do Composio à configuração do seu cliente:

   https://rube.app/mcp
   

2. Conecte sua conta Gong quando solicitado (autenticação OAuth / Bearer token).
3. Comece a emitir comandos em linguagem natural para analisar seus dados de chamadas.

---

Workflows Principais

1. Recuperar Transcrições de Chamadas por Intervalo de Datas

Obtenha transcrições para todas as chamadas dentro de um período de tempo especificado, com filtragem opcional por IDs de chamada específicos ou workspace.

Ferramenta: GONG_RETRIEVE_TRANSCRIPTS_OF_CALLS_V2_CALLS_TRANSCRIPT

Exemplo de prompt:

"Obter transcrições do Gong para todas as chamadas de 1 a 10 de fevereiro de 2025"

Parâmetros-chave:

• filter__fromDateTime — Data de início ISO-8601 (ex.: 2025-02-01T00:00:00Z)
• filter__toDateTime — Data de fim ISO-8601 (ex.: 2025-02-10T23:59:59Z)
• filter__callIds — Array opcional de IDs de chamadas específicas para filtrar
• filter__workspaceId — Filtro opcional de ID do workspace
• cursor — Cursor de paginação da resposta anterior

Escopo necessário: api:calls:read:transcript

---

2. Obter Transcrição para Chamadas Específicas

Recupere transcrições com informações do orador, timestamps e categorização de tópicos usando um objeto de filtro.

Ferramenta: GONG_GET_CALL_TRANSCRIPT

Exemplo de prompt:

"Obter a transcrição do Gong para o ID de chamada 555785916001072125"

Parâmetros-chave (filtro obrigatório):

• filter.callIds — Array de IDs de chamadas específicas (ex.: ["555785916001072125"])
• filter.fromDateTime — Data de início ISO-8601
• filter.toDateTime — Data de fim ISO-8601
• filter.workspaceId — Filtro opcional de workspace
• cursor — Cursor de paginação

---

3. Listar Chamadas por Intervalo de Datas

Recupere metadados básicos de chamadas (participantes, duração, horário) para chamadas dentro de um intervalo de datas.

Ferramenta: GONG_RETRIEVE_CALL_DATA_BY_DATE_RANGE_V2_CALLS

Exemplo de prompt:

"Listar todas as chamadas Gong da última semana"

Parâmetros-chave (ambos obrigatórios):

• fromDateTime — Data de início ISO-8601 (ex.: 2025-02-03T00:00:00Z)
• toDateTime — Data de fim ISO-8601 (ex.: 2025-02-10T00:00:00Z)
• workspaceId — Filtro opcional de workspace
• cursor — Cursor de paginação

Escopo necessário: api:calls:read:basic

---

4. Obter Análises Detalhadas de Chamadas

Recupere detalhes extensos da chamada, incluindo destaques, pontos-chave, tópicos, trackers, estatísticas de oradores, perguntas e URLs de mídia.

Ferramenta: GONG_RETRIEVE_FILTERED_CALL_DETAILS

Exemplo de prompt:

"Obter análises detalhadas para chamadas Gong desta semana, incluindo tópicos, pontos-chave e estatísticas de oradores"

Parâmetros-chave:

• filter__fromDateTime / filter__toDateTime — Filtro de intervalo de datas
• filter__callIds — IDs de chamadas específicas
• filter__primaryUserIds — Filtro por IDs de usuário anfitrião da chamada
• Seletores de conteúdo (todos booleanos):
  • contentSelector__exposedFields__content__keyPoints — Pontos-chave da chamada
  • contentSelector__exposedFields__content__topics — Durações dos tópicos
  • contentSelector__exposedFields__content__highlights — Destaques da chamada
  • contentSelector__exposedFields__content__outline — Esboço da chamada
  • contentSelector__exposedFields__content__brief — Briefing da chamada em destaque
  • contentSelector__exposedFields__content__callOutcome — Resultado da chamada
  • contentSelector__exposedFields__content__trackers — Trackers inteligentes/palavras-chave
  • contentSelector__exposedFields__content__trackerOccurrences — Tempo e orador do tracker (requer trackers=true)
  • contentSelector__exposedFields__interaction__speakers — Tempo que cada participante falou
  • contentSelector__exposedFields__interaction__questions — Contagens de perguntas
  • contentSelector__exposedFields__interaction__personInteractionStats — Estatísticas do anfitrião
  • contentSelector__exposedFields__media — URLs de áudio/vídeo (válidas por 8 horas)
  • contentSelector__exposedFields__parties — Informações das partes
  • contentSelector__exposedFields__collaboration__publicComments — Comentários públicos
• contentSelector__context — "Basic", "Extended" ou "None" para links do CRM/sistema externo

Escopo necessário: api:calls:read:extensive (mais api:calls:read:media-url para mídia)

---

5. Obter uma Chamada Específica por ID

Recupere dados básicos de uma única chamada usando seu ID Gong único.

Ferramenta: GONG_RETRIEVE_DATA_FOR_A_SPECIFIC_CALL_V2_CALLS_ID

Exemplo de prompt:

"Obter detalhes para a chamada Gong 1223781272986876929"

Parâmetros-chave (obrigatório):

• id — Identificador numérico único do Gong para a chamada (até 20 dígitos)

Escopo necessário: api:calls:read:basic

---

6. Listar Workspaces da Empresa

Recupere todos os workspaces da sua organização Gong para obter IDs de workspace para filtragem.

Ferramenta: GONG_LIST_ALL_COMPANY_WORKSPACES_V2_WORKSPACES

Exemplo de prompt:

"Listar todos os workspaces Gong da minha empresa"

Parâmetros-chave: Nenhum obrigatório.

Escopo necessário: api:workspaces:read

---

Armadilhas Conhecidas

• O formato de data ISO-8601 é obrigatório: Todos os parâmetros de data devem usar o formato ISO-8601 com fuso horário: 2025-02-01T00:00:00Z ou 2025-02-01T02:30:00-07:00. Datas simples falharão.
• Intervalo de datas é exclusivo em toDateTime: O parâmetro toDateTime retorna chamadas iniciadas ATÉ, MAS EXCLUINDO, o horário especificado. Para incluir chamadas em um dia específico, defina toDateTime para o dia seguinte.
• Paginação é necessária para grandes conjuntos de resultados: Todos os endpoints de listagem retornam resultados paginados. Use o valor cursor da resposta anterior para buscar a próxima página. Continue até que nenhum cursor seja retornado.
• Requisitos de escopo variam por endpoint: Diferentes endpoints exigem diferentes escopos de API. Acesso a transcrições precisa de api:calls:read:transcript, dados básicos de chamada precisam de api:calls:read:basic, e análises detalhadas precisam de api:calls:read:extensive.
• URLs de mídia expiram em 8 horas: URLs de áudio e vídeo retornados pelo endpoint de chamada detalhada são temporários e expiram após 8 horas.
• Disponibilidade de dados de ocorrência de tracker: Dados de ocorrência de tracker (tempo e ID do orador) estão disponíveis apenas para chamadas gravadas a partir de 1º de janeiro de 2023. Entre em contato com o suporte do Gong para preenchimento retroativo.
• Chamadas de web-conference vs. regulares: Para chamadas de web-conference gravadas pelo Gong, a data representa o horário agendado. Para outras chamadas, representa o horário real de início.

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Obrigatórios
Obter transcrições por data	GONG_RETRIEVE_TRANSCRIPTS_OF_CALLS_V2_CALLS_TRANSCRIPT	Nenhum (intervalo de datas recomendado)
Obter transcrição de chamada	GONG_GET_CALL_TRANSCRIPT	Objeto filter
Listar chamadas por data	GONG_RETRIEVE_CALL_DATA_BY_DATE_RANGE_V2_CALLS	fromDateTime, toDateTime
Obter análises detalhadas de chamadas	GONG_RETRIEVE_FILTERED_CALL_DETAILS	Nenhum (intervalo de datas ou IDs de chamada recomendados)
Obter chamada específica	GONG_RETRIEVE_DATA_FOR_A_SPECIFIC_CALL_V2_CALLS_ID	id
Listar workspaces	GONG_LIST_ALL_COMPANY_WORKSPACES_V2_WORKSPACES	Nenhum

---

Desenvolvido por Composio