API, MCP y Webhooks

# Construye lo que tu operación necesita sobre Nuvia

Una API abierta para integrar tus sistemas y crear funcionalidades, webhooks para escuchar cada evento y MCP para construir directo desde Claude o ChatGPT.

[Agendar demostración](https://nuvia.ai/es/demo?cta=api_hero_demo) [Ver la documentación](https://developers.nuvia.ai/)

*[Terminal de la API de Nuvia con rutas de agentes, contactos, conversaciones, mensajes, campañas, base de conocimiento y webhooks, y una llamada en la que el CRM inscribe un contacto en una campaña.]*

Por qué Nuvia

## La plataforma se adapta a la operación, no al revés

Cada operación tiene sus propias reglas y sistemas. Cuando la herramienta solo se integra con lo que viene listo, es el proceso el que se adapta a ella. En Nuvia, tu equipo extiende la plataforma.

### En plataformas cerradas

- Integraciones solo con lo que ya viene en el catálogo
- Una API parcial, que no hace lo que el equipo hace en la pantalla
- Pocos eventos para avisar a tus sistemas
- Datos atrapados, exportados a mano en hojas de cálculo
- Cada regla nueva se vuelve un pedido en el roadmap del proveedor

### Con Nuvia

- API pública para agentes, contactos, conversaciones, mensajes, campañas y tablas
- Webhooks que avisan a tus sistemas de cada mensaje, conversación y contacto
- El agente llama a tu sistema en medio de la conversación
- MCP para operar y construir desde Claude, ChatGPT o un agente propio
- Claves de API por alcance, una para cada integración

Para tus sistemas

## Tres formas de construir sobre Nuvia

Integra por la API, escucha por los webhooks y deja que el agente llame a tu sistema en medio de la conversación. Cada integración con su clave y solo los alcances que necesita. Todo en una plataforma con informe SOC 2 Type II emitido.

### API pública y completa

Más de 100 rutas para agentes, contactos, conversaciones, mensajes, bandejas, campañas, tablas y base de conocimiento.

### Eventos en tiempo real

Los webhooks avisan a tu sistema cuando llega un mensaje, cambia la etapa del embudo o se actualiza un contacto.

### El agente llama a tu sistema

En medio de la conversación, el Embudo Inteligente hace una solicitud HTTP a tu sistema y responde al cliente con el dato real.

### Una clave por integración

Cada clave recibe solo los alcances que necesita, con vencimiento opcional y revocación inmediata.

Casos de uso

## Lo que tu equipo construye sobre Nuvia

Integraciones para que cada lead sea atendido al instante y cada dato llegue a donde tiene que llegar, sin copiar y pegar.

*[Casos de uso]*

1. Tu sitioEl lead convierte en el formulario de contacto
2. API de NuviaEl contacto se crea en Nuvia y entra en una secuencia de WhatsApp, email y llamadaPOST /v1/campaigns/{id}/enrollments/from-contact
3. Embudo InteligenteEl agente inicia la conversación en segundos, califica y ofrece horarios

Resultado**Lead atendido en segundos, sin copiar y pegar**

Webhooks

## Escucha cada evento y responde por la API

Registra la URL de tu sistema, elige los eventos y se entera al instante: mensaje recibido o leído, conversación creada, etapa del embudo cambiada, contacto actualizado. Con el evento en mano, tu sistema responde por la API.

- Elige los eventos: mensajes, conversaciones, contactos, follow-ups y campos
- Payload en JSON, con los datos en el mismo formato de las rutas de la API
- Headers propios en cada entrega para que tu sistema valide el origen
- Pausa y reanuda la escucha sin rehacer la configuración

[Leer la guía de webhooks](https://developers.nuvia.ai/guias/webhooks)

*[Eventos de Nuvia llegando por webhook al sistema de la empresa, cada uno respondido con 200. La etapa de la conversación cambia a Propuesta y el sistema responde enviando el enlace de la propuesta por la API.]*

Cómo empezar

## Tu integración en vivo el mismo día

Tu equipo conecta Nuvia al CRM, al ERP y a todo lo que usa la operación en tres pasos.

1.

1**Conecta con seguridad** Genera en el panel una clave con solo los accesos que necesita la integración.

2.

2**Trae tu operación** Contactos, listas y campañas entran por la API, directo desde tu CRM, ERP u hoja de cálculo.POST /v1/contacts

3.

3**Reacciona a cada conversación** Tu sistema se entera de cada evento al instante y responde por la API, sin nadie en el medio.POST /v1/webhooks

[Abrir la guía de inicio rápido](https://developers.nuvia.ai/quickstart) [Cómo gestionar las claves de API](https://nuvia.ai/docs/artigos/15230128-como-gerenciar-api-keys-na-nuvia)

Para tus agentes de IA

## ¿Prefieres construir con IA? Usa el MCP

Conecta Claude, ChatGPT o un agente propio al servidor MCP de Nuvia, inicia sesión y opera la plataforma en lenguaje natural. Cada acción queda registrada en la auditoría.

### Opera Nuvia desde tu IA

Por MCP, Claude, ChatGPT o un agente propio consultan y operan contactos, listas, conversaciones y campañas, y piden confirmación antes de activar.

### Cada acción de la IA registrada

La Auditoría MCP muestra qué consultó o cambió cada asistente, quién lo pidió y cuándo.

[Cómo conectar el MCP](https://nuvia.ai/docs/colecoes/19724087-mcp-da-nuvia)

Agent Builder

### Crea y mejora tu Embudo Inteligente conversando con la IA que ya usas

- Claude
- ChatGPT
- Gemini
- Cursor

[Conocer el Agent Builder](https://nuvia.ai/es/features/funil-inteligente/agent-builder)

Preguntas frecuentes

## Dudas sobre la API, el MCP y los webhooks

**¿Cuál es la diferencia entre API, webhook y MCP?**

La API es para que tu sistema llame a Nuvia con una clave; el webhook es Nuvia avisando a tu sistema cuando algo pasa; y el MCP es para que asistentes de IA, como Claude y ChatGPT, operen Nuvia en lenguaje natural con el login de la plataforma.

**¿Dónde está la documentación de la API?**

En developers.nuvia.ai, con la referencia completa de la API y de los webhooks, guías y ejemplos de integración, en portugués, inglés y español. La especificación OpenAPI y la colección de Postman también están ahí.

**¿Qué cubre la API de Nuvia?**

Agentes, contactos, conversaciones, mensajes, campañas y base de conocimiento, además de [búsqueda y enriquecimiento de datos](https://nuvia.ai/es/features/dados-e-enriquecimento). Cada clave tiene solo los alcances que elijas.

**¿Qué eventos puedo recibir por webhook?**

Mensaje recibido, enviado, entregado, leído y con error; conversación creada, actualizada y con etapa cambiada; contacto creado y actualizado; seguimiento enviado y campo actualizado. Eliges cuáles quieres recibir.

**¿Puedo enviar plantillas de WhatsApp en masa por la API?**

Sí. La API envía mensajes de texto, imagen, audio, video y documento, y también plantillas aprobadas por Meta en masa, incluso fuera de la ventana de 24 horas de [WhatsApp por la API oficial](https://nuvia.ai/es/features/canais).

**¿Puedo inscribir un contacto en una campaña desde mi CRM?**

Sí. Cuando entra un lead nuevo o un negocio cambia de etapa en tu CRM, este inscribe el contacto en una [campaña activa](https://nuvia.ai/es/features/campanhas) por la API. Nuvia crea el contacto si todavía no existe y avisa a tu sistema por los webhooks.

**¿Cómo funciona la autenticación de la API?**

Cada integración usa una clave de API creada por un administrador en Configuración › API Keys y enviada en el header Authorization. La clave tiene solo los alcances elegidos, vigencia opcional y se puede revocar en cualquier momento.

**¿Nuvia cumple con SOC 2?**

Sí. Nuvia cumple con SOC 2 Type II, con un informe emitido en noviembre de 2026 tras una auditoría independiente de Advantage Partners. El informe y los controles de seguridad están en el Trust Center, en trust.nuvia.ai.

**¿Qué es el MCP y para qué sirve?**

El MCP es un estándar abierto que conecta asistentes de IA con otros sistemas. Con el MCP de Nuvia, Claude, ChatGPT o un agente propio entran con el login de Nuvia y consultan y operan conversaciones, contactos y campañas en lenguaje natural, y es por él que el [Agent Builder](https://nuvia.ai/es/features/funil-inteligente/agent-builder) arma agentes.

## Lleva Nuvia dentro de tus sistemas

Te mostramos la API, los webhooks y el MCP funcionando con tu operación.

[Agendar demostración](https://nuvia.ai/es/demo?cta=api_final_demo) [Ver la documentación](https://developers.nuvia.ai/)

---
Source: https://nuvia.ai/es/features/api-mcp-webhooks
