> 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 G2 permite-lhe ligar os seus fluxos de trabalho do AirOps diretamente à sua conta G2. Esta integração permite-lhe extrair dados de produtos, avaliações e perguntas de inquérito do G2 de forma programática.
{% hint style="info" %}
Esta integração liga-se à **API de Dados**, que é um produto G2 separado e pago. Não é o mesmo que o site público g2.com e só 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 à API de Dados, ou se não houver produtos mapeados para a 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 G2
### Autenticação
Antes de utilizar a integração G2 nos seus fluxos de trabalho, deve primeiro 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 utilizá-lo em Playbooks. O AirOps utiliza a sua aplicação OAuth para o fluxo padrão do conector.
1. Abrir **Definições → Conectores MCP** e ligar **G2**.
2. Abra o editor do Playbook.
3. Abra o **Ferramentas** painel e ativar **G2**.
4. Descreva que dados de avaliações do G2 o Playbook deve utilizar durante a execução de criação de conteúdo.
Use a sua própria aplicação OAuth do G2
Se a sua equipa usar a sua própria aplicação OAuth com escopos, conclua a configuração avançada antes de continuar o fluxo OAuth do G2 no AirOps.
1. Em My.G2, abra a sua aplicação OAuth do G2 e encontre o ID do cliente e o ID secreto.
2. No AirOps, cole ambos os valores em **Definições avançadas do cliente OAuth**.
3. Clique em **Guardar**e depois copie o URL de retorno do AirOps: `https://app.airops.com/api/mcp_connectors/oauth/callback`.
4. Volte à aplicação OAuth do G2 em My.G2 e adicione o URL de retorno aos URIs de redirecionamento.
5. Volte ao AirOps e continue o fluxo OAuth.
### Tipos de ação
A Integração G2 suporta as seguintes ações:
* **Obter Produtos**: Obter uma lista de produtos listados no G2
* **Pesquisar Produtos**: Pesquisar produtos G2 por palavra-chave ou tópico
* **Obter Perguntas de Inquérito**: Obter as definições das perguntas que o G2 faz em inquéritos de produtos. Isto não devolve respostas de avaliações. Utilize **Obter Avaliações** para o feedback escrito deixado pelos avaliadores.
* **Obter Avaliações**: Obter avaliações de um produto específico
### Parâmetros específicos da ação
**Obter Produtos**
* **Nome do Produto (Opcional)**: Filtrar pelo nome exato do produto (ex.: `Salesforce`)
* **Slug (opcional)**: Filtrar pelo slug da URL do produto G2 (ex.: `salesforce-crm`)
* **Consulta de Pesquisa (Opcional)**: Pesquisa em texto livre entre nomes de produtos (ex.: `CRM`)
* **Tamanho da Página (Opcional)**: Número de resultados por página (máx. 100, predefinição 10)
* **Número da Página (Opcional)**: Número da página a obter (predefinição 1)
**Pesquisar Produtos**
* **Palavra-chave (Obrigatório)**: Pesquisar produtos G2 por palavra-chave ou tópico (ex.: `CRM`, `gestão de projetos`)
* **Tamanho da Página (Opcional)**: Número de resultados por página (máx. 100, predefinição 10)
* **Número da Página (Opcional)**: Número da página a obter (predefinição 1)
**Obter Perguntas de Inquérito**
* **Atualizado Depois de (Opcional)**: Devolver perguntas atualizadas depois desta data (formato RFC3339, 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, predefinição 10)
* **Número da Página (Opcional)**: Número da página a obter (predefinição 1)
**Obter Avaliações**
* **ID do Produto (Obrigatório)**: O UUID do produto G2 para obter avaliações (ex.: `5079d5b8-c6f0-4b0e-96a9-44b8c9d3a6f1`). Isto não é o nome do produto. Para o encontrar, execute primeiro uma **Obter Produtos** ou **Pesquisar 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, 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 classificação por estrelas igual ou superior a este valor (1–5)
* **Número Máximo de Estrelas (Opcional)**: Devolver apenas avaliações com 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, predefinição 10)
* **Número da Página (Opcional)**: Número da página a obter (predefinição 1)
## O que a Etapa Devolve
Cada ação devolve uma resposta simplificada:
* **dados**: a lista de registos encontrados (produtos, avaliações ou perguntas de inquérito).
* **contagem\_de\_registos**: o número total de registos correspondentes.
* **ligações**: `seguinte` como no `anterior` ligações de paginação, quando disponíveis.
* **mensagem**: incluído apenas quando `dados` está vazio, explicando a causa mais provável (ver "Porque é que não estou a obter quaisquer resultados?" abaixo).
Para **Obter Perguntas de Inquérito**, `dados` contém as definições das perguntas de inquérito do G2, e `contagem_de_registos` reflete o número total de perguntas no catálogo do G2, e não uma contagem limitada a um produto.
## Casos de Utilização Comuns
* Pesquisar produtos concorrentes por palavra-chave e extrair as respetivas avaliações para análise competitiva
* Filtrar avaliações por classificação por estrelas para identificar feedback de promotores ou detratores em escala
* Resumir o feedback dos clientes com uma etapa de IA para identificar temas principais
* Monitorizar tendências de sentimento ao longo do tempo utilizando 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 for executada com êxito, mas não devolver produtos ou avaliações, quase sempre significa que a conta G2 ligada não tem nada para devolver, e não que a etapa está com defeito. As causas mais comuns são:
* **O seu plano G2 não inclui acesso à API de Dados.** Esta integração utiliza a API de Dados paga do G2. Um início de sessão G2 padrão ou gratuito não tem este acesso.
* **Não há produtos mapeados para a sua conta.** A API só devolve produtos aos quais a sua conta tem licença de acesso, que são mapeados do lado do G2 (por exemplo, através do G2 Partner Dashboard). Não pesquisa todo o catálogo público g2.com.
* **Está à procura de um produto que não lhe pertence.** Extrair produtos e avaliações de outras empresas (para pesquisa competitiva) requer um acesso mais amplo ao catálogo no seu acordo com o G2.
Em todos estes casos, a correção está do lado do G2. Confirme com o seu administrador do G2 ou representante de conta o que o seu acesso à API de Dados inclui e se os produtos de que precisa estão mapeados para a sua conta.
## Tratamento de erros
Por predefinição, a etapa Integração G2 terminará o fluxo de trabalho se falhar. Pode configurá-la para continuar selecionando "Continuar" em vez de "Terminar Fluxo de Trabalho" 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=&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.