> 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 de manière programmatique les données produit, les avis et les questions d’enquête depuis G2.
{% hint style="info" %}
Cette intégration se connecte à l’ **Data API**, qui est un produit G2 distinct et payant. Il ne s’agit pas du même service que le site public g2.com, et il renvoie uniquement les produits auxquels votre compte G2 est autorisé à accéder. Le fait de pouvoir trouver un produit sur g2.com ne signifie pas qu’il est disponible via l’API. Si votre forfait G2 n’inclut pas l’accès à Data API, ou si aucun produit n’est associé à votre compte, les actions ne renverront aucun résultat. Confirmez 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. Ouvrir **Paramètres → Intégrations**.
2. Trouvez la **G2** section et cliquez sur **Configurer**.
3. Terminez 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. Ouvrir **Paramètres → Connecteurs MCP** et connectez **G2**.
2. Ouvrez l’éditeur de Playbook.
3. Ouvrez le **Outils** 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.
Utilisez votre propre application OAuth G2
Si votre équipe utilise sa propre application OAuth à portée limitée, effectuez 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 dans 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.
### Types d’actions
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 par 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 pour un produit spécifique
### 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 d’URL du produit G2 (par ex. `salesforce-crm`)
* **Requête de recherche (facultatif)**: Recherche en texte libre parmi les noms des produits (par ex. `CRM`)
* **Taille de page (facultatif)**: Nombre de résultats par page (max 100, défaut 10)
* **Numéro de page (facultatif)**: Numéro de page à récupérer (défaut 1)
**Rechercher des produits**
* **Mot-clé (obligatoire)**: Rechercher des produits G2 par mot-clé ou par sujet (par ex. `CRM`, `gestion de projet`)
* **Taille de page (facultatif)**: Nombre de résultats par page (max 100, défaut 10)
* **Numéro de page (facultatif)**: Numéro de page à récupérer (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, défaut 10)
* **Numéro de page (facultatif)**: Numéro de page à récupérer (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`). Ce n’est pas le nom du produit. Pour le trouver, exécutez d’abord une **Obtenir les produits** ou **Rechercher des produits** étape, puis copiez l’ `id` du produit que vous souhaitez à 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 d’étoiles minimum (facultatif)**: Renvoie uniquement les avis avec une note d’étoiles supérieure ou égale à cette valeur (1–5)
* **Nombre d’étoiles maximum (facultatif)**: Renvoie uniquement les avis avec une note d’étoiles inférieure ou égale à cette valeur (1–5)
* **Taille de page (facultatif)**: Nombre de résultats par page (max 100, défaut 10)
* **Numéro de page (facultatif)**: Numéro de page à récupérer (défaut 1)
## Ce que renvoie l’étape
Chaque action renvoie une réponse simplifiée :
* **data**: la liste des enregistrements trouvés (produits, avis ou questions d’enquête).
* **record\_count**: le nombre total d’enregistrements correspondants.
* **links**: `next` et `prev` liens de pagination, lorsqu’ils sont disponibles.
* **message**: inclus uniquement lorsque `data` est vide, ce qui explique la cause la plus probable (voir « Pourquoi n’obtiens-je aucun résultat ? » ci-dessous).
Pour **Obtenir les questions d’enquête**, `data` contient les définitions des questions d’enquête de G2, et `record_count` reflète le nombre total de questions dans le catalogue de G2, et non un décompte limité à un produit.
## Cas d’utilisation courants
* Rechercher des produits concurrents par mot-clé et extraire leurs avis pour une analyse concurrentielle
* Filtrer les avis par note d’étoiles pour faire ressortir à grande échelle les retours des promoteurs ou des détracteurs
* Synthétiser les retours clients avec une étape IA pour faire ressortir les thèmes clés
* Surveiller l’évolution des tendances de sentiment au fil du 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 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 forfait G2 n’inclut pas l’accès à Data API.** Cette intégration utilise l’API Data 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, qui sont associés du côté de G2 (par exemple via le G2 Partner Dashboard). Elle ne recherche pas l’ensemble du catalogue public g2.com.
* **Vous recherchez un produit que vous ne possédez pas.** L’extraction des produits et 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 doit être effectuée du côté de G2. Vérifiez auprès de votre administrateur G2 ou de votre responsable de compte ce que comprend votre accès à Data API et que les produits dont vous avez besoin sont 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 qu’elle continue 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=&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.