# Integraciones

> Conexión de canales (WhatsApp, Telegram, Instagram, Messenger, correo) e integraciones de productividad (Calendario, Cal.com, Webhooks, Notion).

Source: https://waslo.io/es/docs/integrations · Last updated: 2026-10-16

## Dos tipos de conexiones

La página de Integraciones de Waslo se organiza en dos grupos:

**Canales** — *los lugares donde te alcanzan tus clientes*. Cada canal abre una puerta nueva para que tu IA reciba y responda mensajes.

**Integraciones** — *lo que tu IA puede hacer con esa conversación*. Reserva en calendario, sincronización con CRM, importación de leads, fuentes de conocimiento.

Abre **Integrations → Marketplace** desde la barra lateral.

## Canales

| Canal | Autenticación | Coste de conexión |
|-------|---------------|-------------------|
| WhatsApp (QR) | Escanea el QR | Gratis (primer número incluido) |
| WhatsApp Cloud API | Meta App + token | Gratis |
| Telegram | Crear un bot con un toque o conectar tu propia cuenta | Gratis |
| Instagram DM | Meta OAuth | Gratis |
| Facebook Messenger | Meta OAuth | Gratis |
| Chat del sitio web | Fragmento del widget | Gratis |
| Correo — Gmail | Google OAuth | Próximamente |
| Correo — Outlook | Microsoft Graph OAuth | Gratis |

**Todos los canales están incluidos en ambos planes**, sin cuota de activación. En pago por uso cada respuesta sigue consumiendo créditos; en Growth las respuestas son ilimitadas.

**WhatsApp Cloud API o QR oficial.** La Cloud API saca el número de la app de WhatsApp; el **QR oficial** mantiene tu app WhatsApp Business y conecta ese mismo número a la API oficial de Meta (también gratis de conectar). Un número se conecta de una sola forma a la vez. Desde el 1 de octubre de 2026, Meta cobra cada respuesta que el agente envía desde un número oficial: la factura Meta a tu cuenta de WhatsApp Business y Waslo la muestra en la página de Facturación. Los tokens de acceso se renuevan solos. Consulta [Cómo conectar WhatsApp](/docs/connecting-whatsapp).

Las respuestas que escribes tú mismo, fuera de Waslo, pueden pausar el agente para ese cliente. Lo que cuenta como una respuesta escrita por ti varía según el canal — la tabla completa está en [Transferencia Humana](/docs/human-handoff).

### Cómo conectar un canal

1. Abre **Integrations → Marketplace**
2. Pulsa la tarjeta del canal que quieras
3. Sigue el flujo propio del canal (escaneo QR / OAuth / pegar bot token / etc.)
4. Cuando termine, el canal aparece como "Connected" en el marketplace y también en el filtro de canales de la bandeja de entrada

## Integraciones (productividad)

Incluidas en todos los planes, sin nada que desbloquear:
- **Knowledge Base** — sube documentos que la IA pueda citar
- **Notion** — comparte páginas con tu integración de Waslo
- **Webhooks CRM** — envía cada evento de lead a tu CRM o a Zapier en tiempo real
- **Inbound Lead API** — recibe leads de campañas en Facebook, LeadsBridge, etc.
- **Notificaciones de Telegram** — avisos al admin cuando hay leads HOT, traspasos o coincidencias de palabras clave
- **Google Calendar** — la IA agenda citas directamente en tu calendario
- **Cal.com** — alternativa con autenticación por API key
- **CSV Lead Import** — carga masiva de leads desde un CSV
- **Sincronización de tienda** — sincroniza tu catálogo desde Shopify, Salla, Zid o ikas
- **Sincronización de CRM** — envía leads a HubSpot

Un complemento de pago:
- **Outbound Campaigns** — envíos masivos de plantillas a listas segmentadas. 3.000 créditos una sola vez en pago por uso, incluidas en Growth.

## Personalidad de IA por canal

Después de conectar un canal, ábrelo desde la barra lateral (por ejemplo **Integrations → Telegram**) y verás un panel **AI behaviour** donde puedes definir prompts y mensajes de bienvenida solo para ese canal. Resulta útil cuando quieres un tono cercano en Telegram y uno más formal en correo.

También puedes hacerlo desde **AI Agent → AI Personality → Context Selector**, que reúne todos tus canales conectados y tus números de WhatsApp en una sola lista.

## Notificaciones de Telegram (avisos al admin)

No confundir con el "canal Telegram". Estas notificaciones son alertas enviadas a **tu propio teléfono** cuando ocurre algo en Waslo.

1. Crea un bot en [@BotFather](https://t.me/BotFather)
2. Obtén el token y tu `chat_id` personal (con [@userinfobot](https://t.me/userinfobot))
3. Pega ambos en **Integrations → Telegram Notifications**

Recibirás alertas por leads HOT, peticiones de traspaso de la IA y coincidencias de palabras clave personalizadas.

## Webhooks CRM

Envía eventos de leads a cualquier URL (CRM, Zapier, n8n, etc.). Configúralo en **Integrations → Webhooks**.

Eventos que se envían: `lead.created`, `lead.classified`, `lead.handoff`, `message.received`, `message.sent`. `lead.classified` se dispara solo para la etapa más caliente.

Cada petición incluye la cabecera `X-Waslo-Signature: sha256=<hex>` para que puedas verificar la firma y comprobar que efectivamente procede de Waslo. El secreto compartido se muestra al crear el webhook.

## Inbound Lead API

Recibe leads desde fuentes externas vía webhook. Encontrarás tu URL única en **Integrations → Webhooks → Inbound**.

Ejemplo de payload JSON:
```json
{
  "phone": "+34600112233",
  "name": "Sara Ramírez",
  "source": "facebook_ads",
  "customFields": { "budget": "5000" }
}
```

Si defines un secreto de firma, también se valida con HMAC.

## Google Calendar / Cal.com

Conecta uno (o los dos) y tu IA podrá agendar citas. Orden de preferencia: Google Calendar → Cal.com → ninguno.

Tras conectar, la IA dispone de cuatro herramientas: `get_availability`, `book_slot`, `list_upcoming_appointments`, `cancel_appointment`. Los clientes reservan sin salir de la conversación.

## Siguientes pasos

- [Configuración del agente de IA](/docs/ai-agent-configuration)
- [Gestión de leads](/docs/lead-management)
- [Facturación y planes](/docs/billing-and-plans) — desglose del precio en créditos