# Integration einrichten

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

Eine Integration gilt für das gesamte Unternehmen. Wenn Sie hier HubSpot verbinden, verwendet der Agent es noch nicht automatisch. Sie müssen das Tool noch unter **Skills - Tools & Workflows** **on** schalten, oder ein Workflow-Knoten bleibt auf **Setup required**, bis dasselbe Unternehmen verbunden ist.

Seitenleiste - **Integrations**. Vier Tabs: **Connected**, **Catalogue**, **Deployable Channels**, **AI Assistants**. Am ersten Tag ist **Catalogue** - **Connect** / **Authorize**, dann das Agent-Tool.

Seitenbeschreibung auf **Connected**: *Dies sind die bereits verbundenen Tools und was sie tun können.* Auf **Catalogue**: *Geschäftssysteme und Tools, die Sie verbinden können. Einmal hier verbinden, dann pro Agent unter Agent → Skills aktivieren.*

  <ShotPlaceholder
    src="/assets/integrations/integrations-index.png"
    name="int-connected"
    alt="Integrations Connected Tab mit Google Workspace"
    capture="Integrations Connected."
  />

  <ShotPlaceholder
    src="/assets/integrations/catalogue.png"
    name="int-cat"
    alt="Integrations Catalogue mit Connect und Authorize Karten"
    capture="Integrations Catalogue."
  />

## Warum die Einrichtung wichtig ist

Drei Dinge müssen zutreffen, sonst ist das Tool nur Dekoration:

1. **Catalogue - Connect** oder **Authorize** für *dieses* Unternehmen (OAuth oder Zugangsdaten).
2. Die passende Tool-Karte des Agents ist aktiviert, mit den gewünschten Operationen.
3. Sie **Save** den Agent.

Ein Workflow-Knoten für denselben Anbieter ist eine vierte Sache: das Diagramm, plus dieselbe Verbindung.

## Die vier Tabs

- **Connected** — Working / Not connected / Action needed / Disconnect
- **Catalogue** — Connect oder Authorize eines Anbieters
- **Deployable Channels** — widget, chat, mail - nicht CRM
- **AI Assistants** — Claude, ChatGPT ruft Voice Logica auf

**Authorize** erscheint bei OAuth-Anbietern (HubSpot, Zoho CRM, Google Meet / Chat, Microsoft 365, Dropbox). **Connect** erscheint bei Zugangsdaten- / API-Setups (Salesforce, Guesty, Custom API, ERPs, E-Commerce, Kurierdienste). Nachdem es funktioniert, verlässt die Karte Catalogue und wird unter **Connected** angezeigt.

[Google Workspace](https://docs.voicelogica.ai/de/integrations/google/) erscheint auch unter **Connected**, noch bevor autorisiert wurde - Scopes für Kalender, Drive, Sheets und Mail. Catalogue listet Google Meet / Google Chat weiterhin separat auf.

Die Catalogue-Suche zeigt **Search 42 Integrations...** mit Filtern: All, CRM, ERP, E-commerce, Communication, Hospitality, Productivity, Payments, Logistics.

**Deployable Channels** ist die Art und Weise, wie einige Chat- / Mail- / WhatsApp-Oberflächen angebunden werden. Die **Channels - Website Widget** des Agents und [Telephony](https://docs.voicelogica.ai/de/telephony/) sind weiterhin die üblichen Anrufwege.

## Welcher Weg

- **Anrufer aus unserem CRM erkennen** — turn on **HubSpot oder Zoho** (needs [HubSpot](https://docs.voicelogica.ai/de/integrations/hubspot/) oder [Zoho CRM](https://docs.voicelogica.ai/de/integrations/zoho-crm/). Salesforce, Freshdesk und Zendesk befinden sich auf demselben Catalogue-Tab.)
- **Eigentümer und Gäste (Guesty)** — turn on **Guesty** (needs Client ID + Secret. [Guesty](https://docs.voicelogica.ai/de/integrations/guesty/).)
- **Unser eigenes ERP / Shop-API** — turn on **Custom API** (needs Basis-URL + ein Auth-Header. [Custom API](https://docs.voicelogica.ai/de/integrations/custom-api/). Shopify / Woo und andere Catalogue-Karten verwenden **Connect**, dann dieses Tool.)
- **Auf Google Calendar buchen / ein Sheet schreiben** — turn on **Google Workspace** (needs [Google](https://docs.voicelogica.ai/de/integrations/google/). Öffnet von **Connected** - **Connect Google**.)
- **Claude oder ChatGPT soll unsere Agents aufrufen** — turn on **AI Assistants** (needs Die andere Richtung. [AI Assistants](https://docs.voicelogica.ai/de/integrations/mcp-settings/).)

## Erste Einrichtung - HubSpot, dann ein identifizierter Anruf

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

   Schließen Sie den HubSpot-Zustimmungsbildschirm ab (*Connecting your Voice Logica AI account to HubSpot*). Die Karte sollte zu **Connected** mit einem Working-Status wechseln.

2. **My Agents - dieser Agent - Skills - Tools & Workflows**

   Schalten Sie **HubSpot** ein. Aktivieren Sie identify-by-phone (und auto-identify bei eingehenden Anrufen), wenn diese Optionen erscheinen. Wählen Sie die Eigenschaften aus, die Sie lesen möchten.

3. **Save** Sie den Agent. Rufen Sie die Produktions-DID von einer Nummer an, die in einem HubSpot-Kontakt vorhanden ist.

4. Hören Sie auf den Namen. Wenn die Begrüßung generisch ist - die Nummer ist nicht im Kontakt, das Tool ist ausgeschaltet, oder Sie haben HubSpot für ein anderes Unternehmen verbunden.

## Fehlerbehebung

**Das Tool sagt, es sei für Ihren Workspace noch nicht verbunden**

1. **Integrations - Connected** zeigt diesen Anbieter für *dieses* Unternehmen an.
2. Der Status ist working, nicht **Action needed** / **Not connected**.
3. Sie haben den Agent gespeichert, nachdem Sie das Tool eingeschaltet haben.

**Der Workflow-Knoten sagt Setup required**

Verbinden Sie zuerst denselben Anbieter. [Pick a node](https://docs.voicelogica.ai/de/workflow-nodes/). Das Agent-Tool und der Knoten sind unterschiedliche Oberflächen.

## Nächste Schritte

[HubSpot](https://docs.voicelogica.ai/de/integrations/hubspot/) - erstes CRM.  
[Google authorizations](https://docs.voicelogica.ai/de/integrations/google/) - Kalender, Drive, Sheets, Mail.  
[AI Assistants](https://docs.voicelogica.ai/de/integrations/mcp-settings/) - Claude / ChatGPT ruft Sie auf.