> 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/acoes/workflow-concepts/workflow-steps/b2b-enrichment/g2.md).

# G2

Integre o seu Workflow com G2

A etapa de integração com o G2 permite-lhe ligar os seus workflows do AirOps diretamente à sua conta G2. Esta integração permite-lhe extrair programaticamente dados de produtos, avaliações e perguntas de inquérito do G2.

{% hint style="info" %}
Esta integração liga-se ao **Data API** do G2, que é um produto G2 separado e pago. Não é o mesmo que o site público g2.com e apenas devolve os produtos aos quais a sua conta G2 tem licença de acesso. Conseguir encontrar um produto em g2.com não significa que ele esteja disponível através da API. Se o seu plano G2 não incluir acesso ao Data API, ou se nenhum produto estiver associado à sua conta, as ações não devolverão resultados. Confirme o seu acesso com o administrador do G2.
{% endhint %}

## Como Configurar a Etapa de Integração com o G2

### Autenticação

Antes de usar a integração com o G2 nos seus workflows, tem primeiro de ligar a sua conta G2 nas Definições do AirOps:

1. Abrir **Definições → Integrações**.
2. Encontre a **G2** secção e clique em **Configurar**.
3. Conclua o processo de autenticação OAuth concedendo ao AirOps as permissões necessárias.

### Conectores MCP e Playbooks

Também pode ligar o G2 através de **Definições → Conectores MCP** e usá-lo em Playbooks. O AirOps usa a sua app OAuth para o fluxo padrão do conector.

1. Abrir **Definições → Conectores MCP** e ligar **G2**.
2. Abra o editor de Playbook.
3. Abra o **Ferramentas** painel e ativar **G2**.
4. Descreva que dados de avaliações do G2 o Playbook deve usar durante a execução de criação de conteúdo.

<details>

<summary>Use a sua própria app OAuth do G2</summary>

Se a sua equipa usar a sua própria app OAuth com escopo, conclua a configuração avançada antes de continuar o fluxo OAuth do G2 na AirOps.

1. No My.G2, abra a sua app OAuth do G2 e encontre o ID do cliente e o ID secreto.
2. Na AirOps, cole ambos os valores em **Definições avançadas do cliente OAuth**.
3. Clique em **Guardar**, depois copie o URL de callback da AirOps: `https://app.airops.com/api/mcp_connectors/oauth/callback`.
4. Volte à app OAuth do G2 no My.G2 e adicione o URL de callback aos URIs de redirecionamento.
5. Volte à AirOps e continue o fluxo OAuth.

</details>

### Tipos de ação

A integração com o G2 suporta as seguintes ações:

* **Obter Produtos**: Obter uma lista de produtos listados no G2
* **Procurar Produtos**: Procurar produtos do G2 por palavra-chave ou tópico
* **Obter Perguntas do Inquérito**: Obter as definições das perguntas que o G2 faz nos inquéritos de produto. Isto não devolve respostas de avaliações. Use **Obter Avaliações**  para o feedback escrito deixado pelos avaliadores.
* **Obter Avaliações**: Obter avaliações para um produto específico

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f4115b0282a639a55bb0a39ebf2986fee9d2def2%2Fg2-01-actions.png?alt=media" alt="G2 Integration step with the Action dropdown listing Get Products, Get Reviews, Get Survey Questions, and Search Products by Keyword"><figcaption><p>Escolha uma ação do G2.</p></figcaption></figure>

### Parâmetros específicos da ação

**Obter Produtos**

* **Nome do Produto (Opcional)**: Filtrar pelo nome exato do produto (por ex. `Salesforce`)
* **Slug (Opcional)**: Filtrar pelo slug de URL do produto no G2 (por ex. `salesforce-crm`)
* **Consulta de Pesquisa (Opcional)**: Pesquisa em texto livre pelos nomes dos produtos (por ex. `CRM`)
* **Tamanho da Página (Opcional)**: Número de resultados por página (máx. 100, padrão 10)
* **Número da Página (Opcional)**: Número da página a obter (padrão 1)

**Procurar Produtos**

* **Palavra-chave (Obrigatório)**: Procurar produtos do G2 por palavra-chave ou tópico (por ex. `CRM`, `gestão de projetos`)
* **Tamanho da Página (Opcional)**: Número de resultados por página (máx. 100, padrão 10)
* **Número da Página (Opcional)**: Número da página a obter (padrão 1)

**Obter Perguntas do Inquérito**

* **Atualizado Depois de (Opcional)**: Devolver perguntas atualizadas depois desta data (formato RFC3339, por ex. `2024-01-01T00:00:00Z`)
* **Atualizado Antes de (Opcional)**: Devolver perguntas atualizadas antes desta data (formato RFC3339)
* **Tamanho da Página (Opcional)**: Número de resultados por página (máx. 100, padrão 10)
* **Número da Página (Opcional)**: Número da página a obter (padrão 1)

**Obter Avaliações**

* **ID do Produto (Obrigatório)**: O UUID do produto G2 para obter avaliações (por ex. `5079d5b8-c6f0-4b0e-96a9-44b8c9d3a6f1`). Isto não é o nome do produto. Para o encontrar, execute primeiro uma **Obter Produtos** ou **Procurar Produtos** etapa, depois copie o `id` do produto que pretende a partir dos resultados.
* **Criado Depois de (Opcional)**: Devolver avaliações criadas depois desta data (formato RFC3339, por ex. `2024-01-01T00:00:00Z`)
* **Criado Antes de (Opcional)**: Devolver avaliações criadas antes desta data (formato RFC3339)
* **Atualizado Depois de (Opcional)**: Devolver avaliações atualizadas depois desta data (formato RFC3339)
* **Atualizado Antes de (Opcional)**: Devolver avaliações atualizadas antes desta data (formato RFC3339)
* **Número Mínimo de Estrelas (Opcional)**: Devolver apenas avaliações com uma classificação por estrelas igual ou superior a este valor (1–5)
* **Número Máximo de Estrelas (Opcional)**: Devolver apenas avaliações com uma classificação por estrelas igual ou inferior a este valor (1–5)
* **Tamanho da Página (Opcional)**: Número de resultados por página (máx. 100, padrão 10)
* **Número da Página (Opcional)**: Número da página a obter (padrão 1)

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-38392fb9733689c7d80bbaf9a316f6c81cd48657%2Fg2-02-get-reviews.png?alt=media" alt="G2 Get Reviews action filtering recent four- and five-star reviews"><figcaption><p>Filtrar avaliações por data e classificação por estrelas.</p></figcaption></figure>

## O que a Etapa Devolve

Cada ação devolve uma resposta simplificada:

* **data**: a lista de registos encontrados (produtos, avaliações ou perguntas de inquérito).
* **record\_count**: o número total de registos correspondentes.
* **links**: `next` quanto no `prev` ligações de paginação, quando disponíveis.
* **mensagem**: incluído apenas quando `data` está vazio, explicando a causa mais provável (ver "Porque é que não estou a obter quaisquer resultados?" abaixo).

Para **Obter Perguntas do Inquérito**, `data` contém as definições das perguntas do inquérito do G2, e `record_count` reflete o número total de perguntas no catálogo do G2, não uma contagem limitada a um produto.

## Casos de uso comuns

* Procurar produtos concorrentes por palavra-chave e extrair as respetivas avaliações para análise competitiva
* Filtrar avaliações por classificação por estrelas para destacar feedback de promotores ou detratores em escala
* Resumir o feedback dos clientes com uma etapa de IA para destacar os principais temas
* Monitorizar tendências de sentimento ao longo do tempo usando dados de avaliações filtrados por data
* Enriquecer conteúdo com prova social real e citações de avaliações do G2

## Porque é que não estou a obter quaisquer resultados?

Se uma ação correr com êxito mas não devolver produtos ou avaliações, isso quase sempre significa que a conta G2 ligada não tem nada para devolver, e não que a etapa esteja avariada. As causas mais comuns são:

* **O seu plano G2 não inclui acesso ao Data API.** Esta integração usa o Data API pago do G2. Uma conta G2 standard ou gratuita não tem este acesso.
* **Não há produtos associados à sua conta.** A API apenas devolve os produtos aos quais a sua conta tem licença de acesso, que são associados do lado do G2 (por exemplo, através do G2 Partner Dashboard). Não pesquisa todo o catálogo público de g2.com.
* **Está à procura de um produto que não lhe pertence.** Obter produtos e avaliações de outras empresas (para pesquisa competitiva) requer um acesso mais alargado ao catálogo no seu acordo G2.

Em todos estes casos, a correção está do lado do G2. Confirme com o seu administrador do G2 ou com o representante da conta o que o seu acesso ao Data API inclui e se os produtos de que precisa estão associados à sua conta.

## Tratamento de erros

Por defeito, a etapa de Integração com o G2 terminará o workflow se falhar. Pode configurá-la para continuar selecionando "Continuar" em vez de "Terminar o Workflow" nas definições da etapa.


---

# 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/acoes/workflow-concepts/workflow-steps/b2b-enrichment/g2.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.
