# Faire fonctionner une intégration

} from '../../../../components/docs';

Une intégration s'applique à toute l'entreprise. Connecter HubSpot ici ne fait pas que l'agent l'utilise. Vous devez encore activer l'outil sous **Skills - Tools & Workflows**, sinon un nœud de workflow reste en état **Setup required** jusqu'à ce que la même entreprise soit connectée.

Barre latérale - **Integrations**. Quatre onglets : **Connected**, **Catalogue**, **Deployable Channels**, **AI Assistants**. Le premier jour c'est **Catalogue** - **Connect** / **Authorize**, puis l'outil de l'agent.

Ligne de page sur **Connected** : *These are the tools already connected, and what they can do.* Sur **Catalogue** : *Business systems and tools you can connect. Connect once here, then switch it on per agent under Agent -> Skills.*

  <ShotPlaceholder
    src="/assets/integrations/integrations-index.png"
    name="int-connected"
    alt="Onglet Connected des intégrations avec Google Workspace"
    capture="Integrations Connected."
  />

  <ShotPlaceholder
    src="/assets/integrations/catalogue.png"
    name="int-cat"
    alt="Catalogue des intégrations avec les cartes Connect et Authorize"
    capture="Integrations Catalogue."
  />

## Pourquoi la configuration est importante

Trois conditions doivent être remplies sinon l'outil reste décoratif :

1. **Catalogue - Connect** ou **Authorize** sur *cette* entreprise (OAuth ou identifiants).
2. La carte d'outil correspondante de l'agent est activée, avec les opérations que vous souhaitez.
3. Vous **enregistrez** (**Save**) l'agent.

Un nœud de workflow pour le même fournisseur est une quatrième condition : le graphe, plus la même connexion.

## Les quatre onglets

- **Connected** — Working / Not connected / Action needed / Disconnect
- **Catalogue** — Connect or Authorize a provider
- **Deployable Channels** — widget, chat, mail - not CRM
- **AI Assistants** — Claude, ChatGPT calling Voice Logica

**Authorize** apparaît pour les fournisseurs OAuth (HubSpot, Zoho CRM, Google Meet / Chat, Microsoft 365, Dropbox). **Connect** apparaît pour les configurations par identifiants / API (Salesforce, Guesty, Custom API, ERP, e-commerce, coursiers). Une fois que cela fonctionne, la carte quitte Catalogue et apparaît sur **Connected**.

[Google Workspace](https://docs.voicelogica.ai/fr/integrations/google/) apparaît également sur **Connected** même avant l'autorisation - périmètres pour calendrier, Drive, Sheets et mail. Catalogue liste toujours Google Meet / Google Chat séparément.

La recherche dans Catalogue affiche **Search 42 Integrations...** avec des filtres : All, CRM, ERP, E-commerce, Communication, Hospitality, Productivity, Payments, Logistics.

**Deployable Channels** est la manière dont certaines surfaces de chat / mail / WhatsApp s'attachent. Le **Channels - Website Widget** de l'agent et [Telephony](https://docs.voicelogica.ai/fr/telephony/) restent les chemins d'appel habituels.

## Quel chemin choisir

- **Know the caller from our CRM** — turn on **HubSpot or Zoho** (needs [HubSpot](https://docs.voicelogica.ai/fr/integrations/hubspot/) ou [Zoho CRM](https://docs.voicelogica.ai/fr/integrations/zoho-crm/). Salesforce, Freshdesk et Zendesk sont sur le même onglet Catalogue.)
- **Owners and guests (Guesty)** — turn on **Guesty** (needs Client ID + secret. [Guesty](https://docs.voicelogica.ai/fr/integrations/guesty/).)
- **Our own ERP / shop API** — turn on **Custom API** (needs URL de base + un en-tête d'authentification. [Custom API](https://docs.voicelogica.ai/fr/integrations/custom-api/). Shopify / Woo et autres cartes du catalogue utilisent **Connect**, puis cet outil.)
- **Book on Google Calendar / write a Sheet** — turn on **Google Workspace** (needs [Google](https://docs.voicelogica.ai/fr/integrations/google/). S'ouvre depuis **Connected** - **Connect Google**.)
- **Claude or ChatGPT to call our agents** — turn on **AI Assistants** (needs L'autre direction. [AI Assistants](https://docs.voicelogica.ai/fr/integrations/mcp-settings/).)

## Première configuration - HubSpot, puis un appel identifié

1. **Integrations - Catalogue - HubSpot - Authorize**

   Terminez l'écran de consentement HubSpot (*Connecting your Voice Logica AI account to HubSpot*). La carte devrait se déplacer vers **Connected** avec un statut fonctionnel.

2. **My Agents - this agent - Skills - Tools & Workflows**

   Activez **HubSpot**. Activez l'identification par téléphone (et l'identification automatique sur les appels entrants) lorsque ces options apparaissent. Choisissez les propriétés que vous souhaitez lire.

3. **Enregistrez** (**Save**) l'agent. Appelez le DID de production depuis un numéro qui existe sur un contact HubSpot.

4. Écoutez le nom. Si le message d'accueil est générique - le numéro n'est pas sur le contact, l'outil est désactivé, ou vous avez connecté HubSpot sur une autre entreprise.

## Dépannage

**L'outil indique qu'il n'est pas encore connecté pour votre espace de travail**

1. **Integrations - Connected** affiche ce fournisseur sur *cette* entreprise.
2. Le statut est fonctionnel, pas **Action needed** / **Not connected**.
3. Vous avez enregistré l'agent après avoir activé l'outil.

**Le nœud de workflow indique Setup required**

Connectez d'abord le même fournisseur. [Choisissez un nœud](https://docs.voicelogica.ai/fr/workflow-nodes/). L'outil de l'agent et le nœud sont des surfaces différentes.

## Prochaines étapes

[HubSpot](https://docs.voicelogica.ai/fr/integrations/hubspot/) - premier CRM.  
[Autorisations Google](https://docs.voicelogica.ai/fr/integrations/google/) - calendrier, Drive, Sheets, mail.  
[AI Assistants](https://docs.voicelogica.ai/fr/integrations/mcp-settings/) - Claude / ChatGPT vous appelant.