> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/integracoes/overview/company-context/gong.md).

# Gong

Integre com Gong para recuperar dados de chamadas, transcrições e gerir registos de chamadas nos seus workflows

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-0382f9963f62c2775488eb23352b156ca88f27aa%2Fgong-step-01-company-context.png?alt=media" alt="Steps panel scrolled to the Company Context group with Gong, Hubspot, and Shopify"><figcaption><p>Adicione a etapa do Gong no Contexto da Empresa.</p></figcaption></figure>

A integração com o Gong permite acessar gravações de chamadas, transcrições e metadados de chamadas do seu workspace do Gong. Use esta integração para analisar conversas de vendas, extrair insights dos dados de chamadas e automatizar fluxos de trabalho com base nas informações das chamadas.

O Gong captura e analisa conversas de vendas em toda a sua equipe. Ao conectar o Gong ao AirOps, você pode criar fluxos de trabalho que aproveitam transcrições de chamadas para criação de conteúdo, extraem insights importantes das conversas, analisam o desempenho das chamadas e integram os dados de chamadas com outros sistemas de negócios.

## Configurando a integração com o Gong

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-75ff1e786b6b888eba8696c4828e85bd7e322805%2Fgong-step-02-configuration.png?alt=media" alt="Gong Integration step with the Gong (SpaceOps) authentication and an empty Action field"><figcaption><p>Configure a etapa do Gong.</p></figcaption></figure>

### Autenticação

{% @arcade/embed url="<https://app.arcade.software/share/FRsO64LnjlYb8Dho3O61>" flowId="FRsO64LnjlYb8Dho3O61" %}

Para conectar sua conta do Gong ao AirOps:

1. No seu workspace do AirOps, acesse **Conta** → **Integrações** → **Adicionar novo** → **Gong**
2. Você será solicitado a entrar no Gong
3. Certifique-se de ter acesso para entrar e conectar sua conta do Gong ao AirOps

Depois de conectado, você pode selecionar sua conta do Gong ao configurar etapas do Gong nos seus fluxos de trabalho. Você também pode criar várias conexões do Gong se precisar acessar diferentes workspaces do Gong.

{% hint style="info" %}
***Nota:** A integração com o Gong é no nível do usuário. Isso significa que, embora qualquer usuário possa adicionar a integração do Gong ao seu workspace do AirOps, os dados que você pode recuperar serão limitados às permissões de acesso desse usuário no workspace do Gong.*

*Por exemplo, se o usuário que adicionou a integração ao AirOps tiver acesso limitado no workspace do Gong, os dados recuperados por meio da etapa do Gong no AirOps também будут limitados de acordo.*
{% endhint %}

### Ações disponíveis

A integração com o Gong oferece seis ações para trabalhar com dados de chamadas e conteúdo da biblioteca:

1. [Recuperar transcrições de chamadas](#retrieve-transcripts-of-calls)
2. [Listar chamadas](#list-calls)
3. [Obter dados detalhados](#get-extensive-data)
4. [Adicionar nova chamada](#add-new-call)
5. [Listar pastas da biblioteca](#list-library-folders)
6. [Obter chamadas na pasta](#get-calls-in-folder)

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-060aebfb539df754fcd2f207d603250fbfca2455%2Fgong-step-03-actions.png?alt=media" alt="Gong Action dropdown listing Add Call, Get Calls In Folder, Get Extensive Data, List Calls, List Library Folders, and Retrieve Transcripts"><figcaption><p>Escolha uma ação do Gong.</p></figcaption></figure>

### Recuperar transcrições de chamadas

Recupere transcrições de chamadas para análise e processamento.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-a83151bb67cd6d4522162079c42ba2fddd11c2c2%2Fgong-step-04-transcripts.png?alt=media" alt="Gong step set to Retrieve Transcripts with From Date Time, To Date Time, and Call IDs"><figcaption><p>Recupere transcrições de chamadas.</p></figcaption></figure>

<details>

<summary>Parâmetros obrigatórios</summary>

Nenhum - todos os parâmetros são opcionais para esta ação.

</details>

<details>

<summary>Parâmetros opcionais</summary>

**Data e hora inicial**

* Data e hora (no formato ISO-8601: `2018-02-18T02:30:00-07:00` ou `2018-02-18T08:00:00Z`, onde Z representa UTC) a partir de quando listar as chamadas gravadas
* Retorna chamadas que começaram na data e hora especificadas ou depois
* Se não for fornecido, a lista começa com a chamada mais antiga

**Data e hora final**

* Data e hora (no formato ISO-8601: `2018-02-18T02:30:00-07:00` ou `2018-02-18T08:00:00Z`, onde Z representa UTC) até quando listar as chamadas gravadas
* Retorna chamadas que começaram até, mas sem incluir, a data e hora especificadas
* Se não for fornecido, a lista termina com a chamada mais recente

**ID do espaço de trabalho**

* O ID do workspace
* Identificador opcional para filtrar chamadas por workspace

**IDs das chamadas**

* Lista de IDs de chamadas a serem filtrados
* Se não for fornecido, retorna todas as chamadas entre Data e hora inicial e Data e hora final

**Retornar transcrição simplificada**

* Opção de alternância (true/false)
* Se true, retorna uma versão simplificada da transcrição com IDs de falante normalizados e carimbos de data e hora formatados

</details>

### Listar chamadas

Liste chamadas do seu workspace do Gong com filtragem opcional.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b7377b44b3b61b3e45e3a0125951e1d75a199eba%2Fgong-step-05-list-calls.png?alt=media" alt="Gong step set to List Calls with From Date Time, To Date Time, and Workspace ID"><figcaption><p>Liste chamadas com filtros opcionais.</p></figcaption></figure>

<details>

<summary>Parâmetros obrigatórios</summary>

Nenhum - todos os parâmetros são opcionais para esta ação.

</details>

<details>

<summary>Parâmetros opcionais</summary>

**Data e hora inicial**

* Data e hora (no formato ISO-8601: `2018-02-18T02:30:00-07:00` ou `2018-02-18T08:00:00Z`, onde Z representa UTC) a partir de quando listar as chamadas gravadas
* Retorna chamadas que começaram na data e hora especificadas ou depois
* Se não for fornecido, a lista começa com a chamada mais antiga

**Data e hora final**

* Data e hora (no formato ISO-8601: `2018-02-18T02:30:00-07:00` ou `2018-02-18T08:00:00Z`, onde Z representa UTC) até quando listar as chamadas gravadas
* Retorna chamadas que começaram até, mas sem incluir, a data e hora especificadas
* Se não for fornecido, a lista termina com a chamada mais recente

**Cursor**

* O cursor a partir do qual iniciar
* Isso é retornado pela etapa anterior para paginação

</details>

### Obter dados detalhados

Lista dados detalhados da chamada, incluindo contexto, participantes, comentários e mídia.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-a426c0ab6c51d2793b37dcde3e9104de3ae0a9d2%2Fgong-step-06-extensive-data.png?alt=media" alt="Gong step set to Get Extensive Data with From Date Time, To Date Time, Call IDs, and Workspace ID"><figcaption><p>Obtenha dados detalhados da chamada.</p></figcaption></figure>

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-925962523cb2808e8c8096e27075b19db40dcca0%2Fgong-step-07-extensive-options.png?alt=media" alt="End of the Get Extensive Data form with Call IDs, Workspace ID, and the When the step fails setting"><figcaption><p>O formulário Obter dados detalhados termina com o filtro de ID do workspace.</p></figcaption></figure>

<details>

<summary>Parâmetros obrigatórios</summary>

Nenhum - todos os parâmetros são opcionais para esta ação.

</details>

<details>

<summary>Parâmetros opcionais</summary>

**Data e hora inicial**

* Data e hora (no formato ISO-8601: `2018-02-18T02:30:00-07:00` ou `2018-02-18T08:00:00Z`, onde Z representa UTC) a partir de quando listar as chamadas gravadas
* Retorna chamadas que começaram na data e hora especificadas ou depois
* Se não for fornecido, a lista começa com a chamada mais antiga

**Data e hora final**

* Data e hora (no formato ISO-8601: `2018-02-18T02:30:00-07:00` ou `2018-02-18T08:00:00Z`, onde Z representa UTC) até quando listar as chamadas gravadas
* Retorna chamadas que começaram até, mas sem incluir, a data e hora especificadas
* Se não for fornecido, a lista termina com a chamada mais recente

**ID do espaço de trabalho**

* O ID do workspace
* Identificador opcional para filtrar chamadas por workspace

**IDs das chamadas**

* Lista de IDs de chamadas a serem filtrados
* Se não for fornecido, retorna todas as chamadas entre Data e hora inicial e Data e hora final

**IDs de usuários principais**

* Lista de identificadores de usuário
* Se fornecido, a API retornará apenas as chamadas conduzidas pelos usuários especificados
* Os identificadores neste campo correspondem ao campo primaryUserId das chamadas

**Resultados Máximos**

* O número máximo de resultados a retornar
* Use isto para limitar o tamanho da resposta

**Contexto**

* Seleção suspensa: Básico ou Estendido
* Se 'Basic', adicione links para sistemas externos (objetos de contexto), como CRM, sistema de telefonia, gerenciamento de casos
* Se 'Extended', inclua também os dados (campos de contexto) para esses links

**Momento do contexto**

* Valores separados por vírgula: Now, TimeOfCall
* Valores permitidos que podem ser selecionados juntos
* Momento dos dados de contexto
* O campo é opcional e pode conter 'Now', 'TimeOfCall' ou ambos
* O valor padrão é \['Now']
* Só pode ser fornecido quando o campo de contexto estiver definido como 'Extended'

**Incluir participantes**

* Opção de alternância (true/false)
* Se inclui participantes na resposta

**Incluir comentários públicos**

* Opção de alternância (true/false)
* Se inclui comentários públicos na resposta

**Incluir mídia**

* Opção de alternância (true/false)
* Se inclui mídia na resposta

</details>

### Adicionar nova chamada

Adicione um novo registro de chamada ao Gong.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b785155f61ecaaf89f50872c541f0510743aeb9e%2Fgong-step-08-add-call.png?alt=media" alt="Gong step set to Add Call with Client Unique ID, Actual Start, Primary User ID, Title, and Duration"><figcaption><p>Adicione um registro de chamada ao Gong.</p></figcaption></figure>

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-950526fbb4ebce34598f78970d91b40cfcd2ffe6%2Fgong-step-09-add-call-details.png?alt=media" alt="Add Call fields for Title, Duration, Direction, System, and Disposition"><figcaption><p>Adicione o título, a duração e a direção da chamada.</p></figcaption></figure>

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b11e8085df19dc0ff0495969529b6376e4fb384a%2Fgong-step-10-add-call-media.png?alt=media" alt="End of the Add Call form with Direction, System, Disposition, and the When the step fails setting"><figcaption><p>Complete os detalhes da chamada.</p></figcaption></figure>

<details>

<summary>Parâmetros obrigatórios</summary>

**ID exclusivo do cliente**

* O identificador exclusivo de uma chamada no PBX ou no sistema de gravação
* O Gong usa este identificador para evitar tentativas repetidas de enviar a mesma gravação

**Início real**

* A data e hora reais em que a chamada começou no formato ISO-8601 (por exemplo, `2018-02-18T02:30:00-07:00` ou `2018-02-18T08:00:00Z`, onde Z representa UTC)

**Direção**

* Seleção suspensa
* Se a chamada é de entrada (alguém ligou para a empresa), de saída (um representante ligou para alguém fora da empresa) ou uma chamada em conferência

**Usuário principal**

* Seleção suspensa
* O ID interno de usuário do Gong do membro da equipe que conduziu a chamada

**Participantes**

* Valores separados por vírgula
* Uma lista dos participantes da chamada
* Um participante deve ser fornecido para o Usuário principal
* Cada participante pode ter uma estrutura JSON como neste exemplo: `{ "phoneNumber": "123123", "emailAddress": "email@example.com", "name": "Name", "mediaChannelId": "1" }`

</details>

<details>

<summary>Parâmetros opcionais</summary>

**Título**

* O título da chamada
* Este título está disponível no sistema Gong para indexação e pesquisa

**Finalidade**

* O objetivo da chamada
* Este campo opcional é um texto livre de até 255 caracteres

**Início agendado**

* A data e hora em que a chamada foi agendada para começar no formato ISO-8601 (por exemplo, `2018-02-18T02:30:00-07:00` ou `2018-02-18T08:00:00Z`, onde Z representa UTC)

**Término agendado**

* A data e hora em que a chamada foi agendada para terminar no formato ISO-8601 (por exemplo, `2018-02-18T02:30:00-07:00` ou `2018-02-18T08:00:00Z`, onde Z representa UTC)

**Duração**

* A duração real da chamada em segundos

**Desfecho**

* O desfecho da chamada
* O desfecho é um texto livre de até 255 caracteres

**URL da reunião**

* A URL da chamada em conferência pela qual os usuários entram na reunião

**Código do provedor da chamada**

* Seleção suspensa
* O código identifica o sistema de conferência ou telefonia do provedor
* Por exemplo: `zoom`, `clearslide`, `gotomeeting`, `ringcentral`, `outreach`, `insidesales`, etc.
* Esses valores são predefinidos pelo Gong
* Entre em contato com <help@gong.io> para encontrar o valor correto para o seu sistema

**URL para baixar a mídia**

* A URL a partir da qual o Gong pode baixar o arquivo de mídia
* A URL deve ser única, e o arquivo de áudio ou vídeo deve ter no máximo 1,5 GB
* Se você fornecer esta URL, você não deve executar a **Adicionar mídia da chamada** etapa

**ID do espaço de trabalho**

* Identificador opcional do workspace
* Se especificado, a chamada será colocada neste workspace
* Caso contrário, o algoritmo padrão de alocação de workspace será aplicado

**Código do idioma**

* Seleção suspensa
* O código do idioma para o qual a chamada deve ser transcrita
* Este campo é opcional, pois o Gong detecta automaticamente o idioma falado na chamada e o transcreve de acordo
* Defina este campo apenas se tiver certeza do idioma da chamada

</details>

### Listar pastas da biblioteca

Liste todas as pastas públicas da biblioteca no seu workspace do Gong.

<details>

<summary>Parâmetros obrigatórios</summary>

Nenhum - todos os parâmetros são opcionais para esta ação.

</details>

<details>

<summary>Parâmetros opcionais</summary>

**ID do espaço de trabalho**

* O ID do workspace do Gong
* Apenas pastas públicas são retornadas

</details>

### Obter chamadas na pasta

Recupere todas as chamadas salvas em uma pasta específica da biblioteca do Gong.

<details>

<summary>Parâmetros obrigatórios</summary>

**ID da pasta**

* O ID da pasta da biblioteca do Gong
* Use o recurso **Listar pastas da biblioteca** ação para encontrar IDs de pastas

</details>

<details>

<summary>Parâmetros opcionais</summary>

Nenhum - todos os parâmetros são obrigatórios para esta ação.

</details>

### Exemplo de caso de uso

A integração com o Gong permite vários cenários de automação de fluxos de trabalho:

#### Análise de chamadas e criação de conteúdo

* Extraia transcrições de chamadas de vendas para criar estudos de caso e histórias de sucesso
* Analise objeções comuns em várias chamadas para melhorar o conteúdo de capacitação de vendas
* Gere resumos de chamadas para documentação interna
* Crie materiais de treinamento com base nas chamadas de melhor desempenho

### Notas

* Todos os parâmetros de data e hora usam o formato ISO-8601
* Os IDs do workspace e os IDs das chamadas podem ser encontrados no seu workspace do Gong
* Para paginação com grandes conjuntos de dados, use o `Cursor` parâmetro retornado pelas solicitações anteriores
* Os uploads de arquivos de mídia são limitados a 1,5 GB


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/integracoes/overview/company-context/gong.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
