# Integrationen

Binden Sie KI-Anbieter, CRM, Webhooks und Benachrichtigungen eines Kunden aus einem Katalog an Happ an

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Alles, was ein Kunde mit Happ verbindet — KI-Anbieter, CRM, Webhooks, Benachrichtigungen, Telefonie —, liegt in einem einzigen Katalog: **Integrationen**. Verbinden, Agenten zuweisen, fertig.

<IntegrationsOverviewDemo />

## Verbinden [#connect]

1. **Integrationen** in der Seitenleiste → **Integration hinzufügen**.
2. Wählen Sie den Integrationstyp.
3. Geben Sie die Zugangsdaten im Dialog ein (API-Schlüssel, Tokens, URLs).
4. Weisen Sie einen Agenten zu (nur bei Kanal-Integrationen) → **Verbinden**.

Klicken Sie auf eine aktive Integration, um sie zu bearbeiten (**Bearbeiten**). Wenn Sie eine Integration löschen, wird sie getrennt und jeder Datenfluss gestoppt (bei Kanal-Integrationen werden dabei auch die zugehörigen Chats bereinigt). Eine Liste erhalten Sie über `GET /api/company-integrations` mit dem Header `X-Access-Token`.

## Dreistufiges Integrationsmodell [#three-tier-integration-model]

1. **Integration** — die übergeordnete Typdefinition (z. B. „Telegram“, „Binotel“).
2. **Company Integration** — die Verbindung Ihres Kunden mit seinen Zugangsdaten.
3. **Assistant Integration** — welcher Agent diese Verbindung bedient.

So können Sie mehrere Konten eines Typs verbinden und jedem einen anderen Agenten zuweisen.

## KI-Anbieter [#ai-providers]

Ein API-Schlüssel pro Anbieter, hinzugefügt über **Integration hinzufügen** (Bring Your Own Key). Ohne eigenen Schlüssel nutzt der Agent die plattformeigenen Modelle.

| Anbieter           | Was abgedeckt ist                                                                                |
| ------------------ | ------------------------------------------------------------------------------------------------ |
| OpenAI             | GPT-5.x-Familie (`gpt-5.1` ist der Standard für neue Agenten), GPT-4.1, GPT-4o — Text und Stimme |
| Claude (Anthropic) | `claude-sonnet-4-5` — Text                                                                       |
| Gemini (Google)    | Gemini 3.x Flash / Pro — Text und Stimme                                                         |
| Groq               | GPT-OSS 120B / 20B — ultraschnelle Textinferenz                                                  |
| ElevenLabs         | Sprachsynthese und Spracherkennung für Sprachagenten                                             |
| Qdrant             | Ihre eigene Vektordatenbank für die Wissensdatenbank                                             |

Den genauen Katalog mit Preisen finden Sie in der Modellauswahl des Agenten — er ändert sich schneller als diese Seite.

## CRM-Systeme [#crm-systems]

Käufer während des Gesprächs per Telefonnummer finden, Bestellungen und Leads anlegen, den Produktkatalog durchsuchen: **KeyCRM, NetHunt, Odoo, SalesDrive, Sitniks, Uspacy, RO App, KeepinCRM, Creatio, Zoho CRM, OneBox, Ministerstvo Remontu**. **Bitrix24** funktioniert anders — es spiegelt Telegram-, Instagram- und WhatsApp-Chats in die Open Lines von Bitrix24.

Die Zugangsfelder je System finden Sie unter [CRM](/docs/integrations/crm).

## Webhooks [#webhooks]

Empfangen Sie Chat- und Anrufereignisse in Echtzeit an Ihrem eigenen Endpunkt.

Siehe [Webhooks](/docs/integrations/webhooks).

## Benachrichtigungen [#notifications]

Benachrichtigen Sie das Team, wenn ein Gespräch einen Mitarbeiter braucht, oder exportieren Sie die Daten: **Telegram Push**, **Slack**, **Google Sheets**, **Push in der mobilen App** (abgeschlossene Gesprächsanalysen) und **E-Mail** (wöchentliche und monatliche Analyseberichte).

Siehe [Benachrichtigungen](/docs/integrations/notifications).

## Sonstiges [#other]

* **Social-Media-Kommentare** — Instagram Comments, Facebook Comments, Rozetka Comments: Der Agent antwortet unter Beiträgen, Reels und Produktkarten.
* **Marktplätze** — Prom.ua, Rozetka, OLX: Käufer-Chats landen im selben Posteingang.
* **Telefonie** — Binotel, Ringostat, Phonet, Unitalk, Stream Telecom sowie Custom Calls für jeden anderen Anbieter. Siehe [Telefonieanbieter](/docs/integrations/telephony).
* **Ausgehendes Viber** — DirectHub sendet die erste Nachricht an eine Telefonnummer.
* **Vektor-DB** — Qdrant bildet die Grundlage der [Wissensdatenbank](/docs/agents/knowledge) (OpenAI-Embeddings `text-embedding-3-large` + Abruf über Qdrant).

Halten Sie API-Schlüssel geheim, verwenden Sie für Happ eigene Schlüssel und erneuern Sie sie regelmäßig.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Weiter [#next]

* [Kanäle](/docs/integrations/messengers) — Messenger verbinden
* [CRM](/docs/integrations/crm) — Ihre Vertriebspipeline synchronisieren
* [Webhooks](/docs/integrations/webhooks) — eigene Integrationen bauen