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

# G2

Intégrez votre workflow avec G2

L'étape d'intégration G2 vous permet de connecter directement vos workflows AirOps à votre compte G2. Cette intégration vous permet d'extraire programmatiquement des données produit, des avis et des questions d'enquête depuis G2.

{% hint style="info" %}
Cette intégration se connecte à la **API de données**, qui est un produit G2 distinct et payant. Ce n'est pas le même que le site public g2.com, et il ne renvoie que les produits auxquels votre compte G2 est autorisé à accéder. Le simple fait de pouvoir trouver un produit sur g2.com ne signifie pas qu'il est disponible via l'API. Si votre offre G2 n'inclut pas l'accès à l'API de données, ou si aucun produit n'est associé à votre compte, les actions ne renverront aucun résultat. Vérifiez votre accès auprès de votre administrateur G2.
{% endhint %}

## Comment configurer l'étape d'intégration G2

### Authentification

Avant d'utiliser l'intégration G2 dans vos workflows, vous devez d'abord connecter votre compte G2 dans les paramètres AirOps :

1. Ouvrez **Paramètres → Intégrations**.
2. Trouvez la **G2** section et cliquez sur **Configurer**.
3. Complétez le processus d'authentification OAuth en accordant à AirOps les autorisations nécessaires.

### Connecteurs MCP et Playbooks

Vous pouvez également connecter G2 via **Paramètres → Connecteurs MCP** et l'utiliser dans les Playbooks. AirOps utilise son application OAuth pour le flux standard du connecteur.

1. Ouvrez **Paramètres → Connecteurs MCP** et connectez **G2**.
2. Ouvrez l'éditeur de Playbook.
3. Ouvrez le **Outils** le panneau et activez **G2**.
4. Décrivez quelles données d'avis G2 le Playbook doit utiliser pendant l'exécution de création de contenu.

<details>

<summary>Utiliser votre propre application OAuth G2</summary>

Si votre équipe utilise sa propre application OAuth à portée limitée, terminez la configuration avancée avant de poursuivre le flux OAuth G2 dans AirOps.

1. Dans My.G2, ouvrez votre application OAuth G2 et trouvez l'ID client et l'ID secret.
2. Dans AirOps, collez les deux valeurs dans **Paramètres avancés du client OAuth**.
3. Cliquez sur **Enregistrer**, puis copiez l'URL de rappel AirOps : `https://app.airops.com/api/mcp_connectors/oauth/callback`.
4. Retournez à l'application OAuth G2 dans My.G2 et ajoutez l'URL de rappel aux URI de redirection.
5. Retournez dans AirOps et poursuivez le flux OAuth.

</details>

### Types d'action

L'intégration G2 prend en charge les actions suivantes :

* **Obtenir les produits**: Récupérer une liste des produits répertoriés sur G2
* **Rechercher des produits**: Rechercher des produits G2 par mot-clé ou sujet
* **Obtenir les questions d'enquête**: Récupérer les définitions des questions que G2 pose dans les enquêtes produit. Cela ne renvoie pas les réponses aux avis. Utilisez **Obtenir les avis** pour les commentaires écrits laissés par les évaluateurs.
* **Obtenir les avis**: Récupérer les avis d'un produit spécifique

<figure><img src="https://344527547-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>Choisissez une action G2.</p></figcaption></figure>

### Paramètres spécifiques à l'action

**Obtenir les produits**

* **Nom du produit (facultatif)**: Filtrer par nom exact du produit (par ex. `Salesforce`)
* **Slug (facultatif)**: Filtrer par le slug URL du produit G2 (par ex. `salesforce-crm`)
* **Requête de recherche (facultatif)**: Recherche en texte libre dans les noms de produits (par ex. `CRM`)
* **Taille de page (facultatif)**: Nombre de résultats par page (max. 100, par défaut 10)
* **Numéro de page (facultatif)**: Numéro de page à récupérer (par défaut 1)

**Rechercher des produits**

* **Mot-clé (obligatoire)**: Rechercher des produits G2 par mot-clé ou sujet (par ex. `CRM`, `gestion de projet`)
* **Taille de page (facultatif)**: Nombre de résultats par page (max. 100, par défaut 10)
* **Numéro de page (facultatif)**: Numéro de page à récupérer (par défaut 1)

**Obtenir les questions d'enquête**

* **Mis à jour après (facultatif)**: Renvoie les questions mises à jour après cette date (format RFC3339, par ex. `2024-01-01T00:00:00Z`)
* **Mis à jour avant (facultatif)**: Renvoie les questions mises à jour avant cette date (format RFC3339)
* **Taille de page (facultatif)**: Nombre de résultats par page (max. 100, par défaut 10)
* **Numéro de page (facultatif)**: Numéro de page à récupérer (par défaut 1)

**Obtenir les avis**

* **ID du produit (obligatoire)**: L'UUID du produit G2 pour lequel récupérer les avis (par ex. `5079d5b8-c6f0-4b0e-96a9-44b8c9d3a6f1`). Il ne s'agit pas du nom du produit. Pour le trouver, exécutez d'abord une étape **Obtenir les produits** ou **Rechercher des produits** étape d'abord, puis copiez le `id` UUID du produit souhaité à partir de ses résultats.
* **Créé après (facultatif)**: Renvoie les avis créés après cette date (format RFC3339, par ex. `2024-01-01T00:00:00Z`)
* **Créé avant (facultatif)**: Renvoie les avis créés avant cette date (format RFC3339)
* **Mis à jour après (facultatif)**: Renvoie les avis mis à jour après cette date (format RFC3339)
* **Mis à jour avant (facultatif)**: Renvoie les avis mis à jour avant cette date (format RFC3339)
* **Nombre minimum d'étoiles (facultatif)**: Renvoie uniquement les avis avec une note en étoiles supérieure ou égale à cette valeur (1–5)
* **Nombre maximum d'étoiles (facultatif)**: Renvoie uniquement les avis avec une note en étoiles inférieure ou égale à cette valeur (1–5)
* **Taille de page (facultatif)**: Nombre de résultats par page (max. 100, par défaut 10)
* **Numéro de page (facultatif)**: Numéro de page à récupérer (par défaut 1)

<figure><img src="https://344527547-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>Filtrer les avis par date et note en étoiles.</p></figcaption></figure>

## Ce que renvoie l'étape

Chaque action renvoie une réponse simplifiée :

* **données**: la liste des enregistrements trouvés (produits, avis ou questions d'enquête).
* **nombre d'enregistrements**: le nombre total d'enregistrements correspondants.
* **liens**: `suivant` et le `précédent` liens de pagination, lorsqu'ils sont disponibles.
* **message**: inclus uniquement lorsque `données` est vide, en expliquant la cause la plus probable (voir « Pourquoi n'obtiens-je aucun résultat ? » ci-dessous).

Pour **Obtenir les questions d'enquête**, `données` contient les définitions des questions d'enquête de G2, et `nombre d'enregistrements` reflète le nombre total de questions dans le catalogue de G2, et non un nombre limité à un produit.

## Cas d'utilisation courants

* Rechercher des produits concurrents par mot-clé et récupérer leurs avis pour une analyse concurrentielle
* Filtrer les avis par note en étoiles afin de faire ressortir à grande échelle les retours des promoteurs ou des détracteurs
* Résumer les commentaires clients avec une étape d'IA pour faire ressortir les thèmes clés
* Suivre les tendances de sentiment dans le temps à l'aide de données d'avis filtrées par date
* Enrichir le contenu avec de véritables preuves sociales et des citations d'avis provenant de G2

## Pourquoi n'obtiens-je aucun résultat ?

Si une action s'exécute correctement mais ne renvoie aucun produit ni aucun avis, cela signifie presque toujours que le compte G2 connecté n'a rien à renvoyer, et non que l'étape est défectueuse. Les causes les plus courantes sont :

* **Votre offre G2 n'inclut pas l'accès à la Data API.** Cette intégration utilise la Data API payante de G2. Une connexion G2 standard ou gratuite ne dispose pas de cet accès.
* **Aucun produit n'est associé à votre compte.** L'API ne renvoie que les produits auxquels votre compte est autorisé à accéder, et qui sont associés du côté de G2 (par exemple via le tableau de bord partenaires G2). Elle ne recherche pas dans l'ensemble du catalogue public g2.com.
* **Vous recherchez un produit qui ne vous appartient pas.** Récupérer les produits et les avis d'autres entreprises (pour la recherche concurrentielle) nécessite un accès plus large au catalogue dans votre contrat G2.

Dans tous ces cas, la correction se fait du côté de G2. Confirmez auprès de votre administrateur G2 ou de votre responsable de compte ce que comprend votre accès à la Data API et que les produits dont vous avez besoin sont bien associés à votre compte.

## Gestion des erreurs

Par défaut, l'étape d'intégration G2 mettra fin au workflow en cas d'échec. Vous pouvez la configurer pour continuer en sélectionnant « Continuer » au lieu de « Terminer le workflow » dans les paramètres de l'étape.


---

# 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/fr/actions/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.
