# Integraciones

Conecta los proveedores de IA, el CRM, los webhooks y las notificaciones de un cliente a Happ desde un único catálogo

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

Todo lo que un cliente conecta a Happ —proveedores de IA, CRM, webhooks, notificaciones, telefonía— está en un único catálogo de **Integraciones**. Conéctalo, asigna un asistente y listo.

<IntegrationsOverviewDemo />

## Conectar [#connect]

1. **Integraciones** en la barra lateral → **Añadir integración**.
2. Elige el tipo de integración.
3. Introduce las credenciales en el modal (claves API, tokens, URL).
4. Asigna un asistente (solo integraciones de tipo canal) → **Conectar**.

Haz clic en una integración activa para **Editar**; elimínala para desconectarla y detener todo el flujo de datos (las integraciones de canal también limpian sus chats). Lístalas con `GET /api/company-integrations` y el encabezado `X-Access-Token`.

## Modelo de integración de tres niveles [#three-tier-integration-model]

1. **Integración**: definición maestra del tipo (p. ej., "Telegram", "Binotel").
2. **Integración de la empresa**: la conexión de tu cliente con sus credenciales.
3. **Integración del asistente**: qué asistente gestiona esa conexión.

Así puedes conectar varias cuentas de un mismo tipo y asignar un asistente distinto a cada una.

## Proveedores de IA [#ai-providers]

Una clave API por proveedor, añadida en **Añadir integración** (usa tu propia clave). Sin clave, el asistente funciona con los modelos propios de la plataforma.

| Proveedor          | Qué cubre                                                                                             |
| ------------------ | ----------------------------------------------------------------------------------------------------- |
| OpenAI             | Familia GPT-5.x (`gpt-5.1` es el predeterminado para asistentes nuevos), GPT-4.1, GPT-4o: texto y voz |
| Claude (Anthropic) | `claude-sonnet-4-5`: texto                                                                            |
| Gemini (Google)    | Gemini 3.x Flash / Pro: texto y voz                                                                   |
| Groq               | GPT-OSS 120B / 20B: inferencia de texto ultrarrápida                                                  |
| ElevenLabs         | Síntesis y reconocimiento del habla para agentes de voz                                               |
| Qdrant             | Tu propia base de datos vectorial para la base de conocimiento                                        |

El catálogo exacto con precios está en el selector de modelos dentro de un asistente: cambia más rápido que esta página.

## Sistemas CRM [#crm-systems]

Busca compradores por teléfono durante la conversación, crea pedidos y leads, busca en el catálogo de productos: **KeyCRM, NetHunt, Odoo, SalesDrive, Sitniks, Uspacy, RO App, KeepinCRM, Creatio, Zoho CRM, OneBox, Ministerstvo Remontu**. **Bitrix24** funciona de otra forma: replica los chats de Telegram, Instagram y WhatsApp en las Open Lines de Bitrix24.

Consulta [CRM](/docs/integrations/crm) para los campos de credenciales de cada sistema.

## Webhooks [#webhooks]

Recibe eventos de chats y llamadas en tiempo real en tu propio endpoint.

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

## Notificaciones [#notifications]

Avisa al equipo cuando una conversación necesita a una persona, o envía los datos fuera: **Telegram Push**, **Slack**, **Google Sheets**, **push de la aplicación móvil** (análisis de conversaciones finalizadas) y **email** (informes de analíticas semanales y mensuales).

Consulta [Notificaciones](/docs/integrations/notifications).

## Otros [#other]

* **Comentarios en redes sociales**: Instagram Comments, Facebook Comments, Rozetka Comments: el asistente responde bajo publicaciones, reels y fichas de producto.
* **Marketplaces**: Prom.ua, Rozetka, OLX: los chats de compradores llegan a la misma bandeja de entrada.
* **Telefonía**: Binotel, Ringostat, Phonet, Unitalk, Stream Telecom, además de Custom Calls para cualquier otro proveedor. Consulta [Proveedores de telefonía](/docs/integrations/telephony).
* **Viber saliente**: DirectHub envía el primer mensaje a un número de teléfono.
* **Base de datos vectorial**: Qdrant impulsa la [base de conocimiento](/docs/agents/knowledge) (embeddings `text-embedding-3-large` de OpenAI + recuperación con Qdrant).

Mantén las claves API en privado, usa claves separadas para Happ y rótalas periódicamente.

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

## Siguiente [#next]

* [Canales](/docs/integrations/messengers): conecta aplicaciones de mensajería
* [CRM](/docs/integrations/crm): sincroniza tu embudo de ventas
* [Webhooks](/docs/integrations/webhooks): crea integraciones personalizadas
