> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orova.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> Connectez votre CRM HubSpot à votre agent IA

## Configuration

<Steps>
  <Step title="Créer une Private App dans HubSpot">
    1. Allez dans **Settings → Integrations → Private Apps** dans HubSpot
    2. Cliquez sur **Create a private app**
    3. Nommez-la « Orova Integration »
    4. Dans **Scopes**, activez : `crm.objects.contacts`, `crm.objects.deals`, `crm.objects.companies`
    5. Cliquez sur **Create app** et copiez le jeton d'accès
  </Step>

  <Step title="Ajouter les identifiants dans Orova">
    Allez dans **Settings → Integrations → HubSpot** et collez votre jeton d'accès.
  </Step>

  <Step title="Créer un outil">
    Allez dans **Tools → Create Tool** et sélectionnez le modèle **HubSpot**.
  </Step>

  <Step title="Attribuer à votre agent">
    Dans les paramètres de votre agent, ajoutez l'outil HubSpot.
  </Step>
</Steps>

## Outils disponibles

| Outil               | Description                                         |
| ------------------- | --------------------------------------------------- |
| `search_contacts`   | Rechercher des contacts par nom, email ou téléphone |
| `get_contact`       | Obtenir les détails d'un contact par ID             |
| `create_contact`    | Créer un nouveau contact                            |
| `update_contact`    | Mettre à jour les propriétés d'un contact           |
| `search_companies`  | Rechercher des entreprises                          |
| `get_company`       | Obtenir les détails d'une entreprise                |
| `create_company`    | Créer une nouvelle entreprise                       |
| `search_deals`      | Rechercher des affaires                             |
| `get_deal`          | Obtenir les détails d'une affaire                   |
| `create_deal`       | Créer une nouvelle affaire                          |
| `update_deal`       | Mettre à jour les propriétés d'une affaire          |
| `get_deal_pipeline` | Obtenir les étapes du pipeline d'affaires           |
| `search_tickets`    | Rechercher des tickets de support                   |
| `get_ticket`        | Obtenir les détails d'un ticket                     |
| `create_ticket`     | Créer un ticket de support                          |
| `create_note`       | Créer une note sur un enregistrement                |
| `create_task`       | Créer une tâche                                     |
| `get_owners`        | Lister les propriétaires HubSpot                    |

## Exemple de conversation

> **Utilisateur** : « Pouvez-vous rechercher John Smith dans notre CRM ? »
>
> **Agent** : *appelle `search_contacts` avec la requête « John Smith »*
>
> **Agent** : « J'ai trouvé John Smith — il est Sales Manager chez Acme Corp. Son email est \[email]. Voulez-vous que je crée une affaire pour lui ? »