En este artículo

Conexión externa: API, Webhooks e Inteligencia Artificial (MCP)

Vendabo ofrece tres formas de conectar tu tienda con sistemas externos (CRMs, ERPs personalizados, automatizaciones, asistentes de IA):

1. API — para que un sistema externo consulte o modifique datos de tu tienda cuando lo necesite (ej. "dame todos los pedidos de hoy", "actualiza el stock de este producto").
2. Webhooks — para que tu tienda avise automáticamente a un sistema externo cuando algo pasa (ej. "se creó un pedido nuevo", "un cliente actualizó sus datos").
3. MCP (Inteligencia Artificial) — para conectar asistentes como Claude, ChatGPT, Gemini o Cursor directamente con tu tienda, y poder pedirles cosas en lenguaje natural (ej. "agrega 50 unidades al producto X" o "muéstrame ventas de la semana").

A quién va dirigido este artículo: si bien la configuración inicial la haces tú desde el panel, integrar realmente la API o los webhooks requiere a un desarrollador. Este artículo te da el contexto para conversar con tu equipo técnico o proveedor externo. Si necesitas la guía técnica detallada para tu desarrollador, está en Guía de conexión API (enlazada desde la pantalla del admin).

Requisitos previos

• Plan que incluya API y Webhooks. Si los botones "Crear token" o "Crear webhook" aparecen deshabilitados, tu plan no los incluye — considera subir de plan.
• Para implementar la integración: un desarrollador o proveedor externo familiarizado con APIs REST y JSON.

---

1. API (tokens de acceso)

La API permite que otro sistema (un CRM, una app móvil propia, un dashboard interno, una hoja de cálculo automatizada, etc.) lea y modifique datos de tu tienda: productos, pedidos, clientes, inventario, etc.

Cómo entrar

En el menú lateral entra a Ajustes → API.

Verás la lista de tokens de acceso creados y, debajo, instrucciones de conexión.

Crear un token

1. Haz clic en "Crear token".
2. Ponle un nombre descriptivo del sistema que lo va a usar (ej. "CRM Salesforce", "App móvil interna", "Conector con HubSpot").
3. Guarda.
4. Copia el token inmediatamente. Por seguridad, solo se muestra una vez. Si lo pierdes, tienes que generar uno nuevo.

Cómo usar el token

El desarrollador que integra el sistema externo lo usa enviando el token en cada petición a la API, en una cabecera llamada X-Api-Key.

Ejemplo en términos generales:

"Para listar todos los pedidos: hacer un GET a https://tutienda.com/api/v1/orders con la cabecera X-Api-Key: <token>."

La documentación completa con todas las URLs, parámetros y respuestas está disponible en el enlace "Guía de conexión API" (botón visible al entrar a la sección).

Recomendaciones de seguridad

• Un token por sistema externo. Si tienes un CRM, una app móvil y un proveedor de email, usa tres tokens distintos. Si uno se compromete, lo eliminas sin afectar a los otros.
• Comparte el token solo con el desarrollador o sistema autorizado. NO lo pegues en chats públicos, capturas de pantalla compartidas o documentos en la nube sin protección.
• Si sospechas que un token se filtró, elimínalo inmediatamente. En el listado, abre el menú de tres puntos del token y elige "Eliminar". Crea uno nuevo y dáselo al sistema autorizado.
• Revoca tokens de personal que ya no trabaja contigo. Es buena práctica auditarlos cada 6 meses.

Qué se puede hacer con la API

Las operaciones disponibles incluyen (lista parcial):

• Productos: consultar, crear, actualizar, eliminar.
• Variantes: consultar, actualizar precio o stock.
• Pedidos: listar, consultar detalle, marcar como pagado/preparado, cancelar.
• Clientes: listar, crear, actualizar, consultar historial.
• Categorías y colecciones: consultar y modificar.
• Inventario masivo: actualizar stock de hasta 1,000 variantes en una sola operación.

La documentación técnica detalla cada operación, sus parámetros y formatos.

---

2. Webhooks (avisos automáticos)

Mientras la API es bajo demanda (el sistema externo pregunta cuando quiere), los webhooks son automáticos: Vendabo avisa al sistema externo apenas algo sucede en tu tienda.

Útil cuando quieres reaccionar inmediatamente — por ejemplo: cada vez que llega un pedido, mandar un aviso a tu sistema de inventario para reservar las unidades; o cuando un cliente se registra, agregarlo automáticamente a tu CRM.

Cómo entrar

En el menú lateral entra a Ajustes → Webhooks.

Crear un webhook

1. Haz clic en "Crear webhook".
2. Llena los datos:
   • Título: descriptivo (ej. "Notificar pedidos al CRM").
   • URL: la dirección del sistema externo que va a recibir el aviso. Te la da tu desarrollador o el proveedor del sistema.
   • Tipo de evento: elige cuándo se dispara el aviso. Opciones disponibles:
     • Usuario creado — cuando se registra un cliente nuevo.
     • Usuario actualizado — cuando un cliente cambia sus datos.
     • Pedido creado — cuando se completa un pedido nuevo.
     • Pedido actualizado — cuando un pedido cambia de estado (pagado, preparado, cancelado, etc.).
3. Guarda.
4. Después de guardar, abre el menú del webhook y elige "Copiar clave secreta". Pásale esta clave al desarrollador del sistema externo.

Cómo se usa la clave secreta

El sistema externo usa la clave para verificar que el aviso realmente viene de tu tienda y no de un atacante que descubrió la URL. Tu desarrollador la integra en su código para validar cada aviso recibido.

Qué incluye el aviso

Cada aviso es un mensaje en formato JSON con todos los datos del evento. Por ejemplo, para "Pedido creado" incluye el número de pedido, el cliente, los productos, totales, dirección de envío, etc. — exactamente lo que el sistema externo necesita para procesarlo.

Si el sistema externo falla

Vendabo intenta reenviar el aviso si el sistema externo no responde correctamente. Si después de 24 horas de fallos continuos el webhook sigue sin funcionar, Vendabo lo desactiva automáticamente y te envía un email para que lo revises.

Causas comunes de fallos:

• El sistema externo está caído.
• La URL cambió y nadie actualizó la configuración.
• El sistema externo rechaza el aviso por algún cambio en su lógica de validación.

Cuando lo arregles, vuelve a la pantalla de Webhooks, abre el menú del webhook desactivado y elige "Reactivar".

Recomendaciones

• Un webhook por evento + sistema. Si necesitas que el CRM reciba "pedidos creados" y el sistema de inventario también, crea dos webhooks separados (mismo evento, distintas URLs). Es más fácil de mantener.
• NO pongas datos sensibles en la URL. La URL del webhook debe identificar al sistema, no contener tokens ni contraseñas (esos van en cabeceras o cuerpo del aviso).
• Revisa los webhooks desactivados periódicamente. Si recibes un email de "webhook desactivado", actúa rápido — pediste recibir esos avisos por algo importante.

---

3. MCP — Inteligencia Artificial

MCP (Model Context Protocol) es un puente que conecta tu tienda directamente con asistentes de inteligencia artificial como Claude, ChatGPT, Gemini o Cursor. Una vez conectado, puedes pedirle cosas al asistente en lenguaje natural y él opera directamente sobre tu tienda:

• "Crea un producto llamado X con precio Y y categoría Z."
• "Muéstrame las ventas de la semana pasada agrupadas por categoría."
• "Sube el stock de la talla M del producto Camiseta Roja en 30 unidades."
• "Lista los 10 clientes que más gastaron este mes."
• "Archiva todos los productos de la marca X que no se hayan vendido en 6 meses."

El asistente hace las operaciones sin que tengas que entrar al panel manualmente.

Habilitar MCP

MCP viene desactivado por defecto. Para activarlo en tu tienda, contacta al equipo técnico de Vendabo — se habilita por solicitud.

Una vez activado, en la pantalla Ajustes → API aparece una sección adicional "Conectar Claude / ChatGPT / Gemini (MCP)" con instrucciones detalladas.

Cómo conectar tu asistente

La pantalla muestra instrucciones de copiar y pegar específicas para cada asistente:

• Claude Code (CLI): un comando para correr en terminal.
• Claude Desktop o web: un fragmento de configuración JSON para pegar en los ajustes de Claude.
• Gemini CLI / Web: un comando o fragmento JSON.
• Cursor: un fragmento JSON.
• ChatGPT: instrucciones específicas según la versión.

Cada uno usa tu token de API (los mismos de la sección anterior) para autenticarse. Crea uno dedicado para MCP si quieres separar logs.

Qué puede hacer el asistente

Las operaciones disponibles cubren la mayoría de tareas del panel:

• Gestión de productos (crear, editar, archivar, duplicar, manejar variantes y opciones).
• Gestión de inventario (actualizar stock masivamente).
• Gestión de precios (cambios individuales o masivos).
• Gestión de categorías y colecciones.
• Consulta de pedidos y clientes.
• Reportes de ventas.
• Subida de imágenes de productos (incluso desde URLs).

Seguridad y auditoría

Cada operación que hace el asistente queda registrada en un historial de auditoría accesible desde el panel. Puedes ver qué se hizo, cuándo y desde qué token, en caso de que necesites investigar algo.

Para entrar al historial: Ajustes → API → Historial de uso (MCP).

Recomendaciones

• Empieza con tareas de consulta ("muéstrame...", "lístame...") antes de pasar a tareas que modifican datos ("crea...", "elimina..."). Esto te da confianza con el comportamiento del asistente antes de darle más poder.
• Verifica los resultados las primeras veces. Los asistentes son muy buenos pero no infalibles — confirma manualmente que el cambio que hiciste por chat se reflejó como esperabas.
• Usa el historial de auditoría. Si algo no salió como esperabas, ahí puedes ver exactamente qué se ejecutó.
• Un token dedicado para MCP ayuda a separar logs de la API tradicional. Si quieres revocar acceso del asistente sin afectar otras integraciones, eliminas solo ese token.

---

Casos típicos

"Quiero conectar mi CRM (Salesforce / HubSpot / Zoho) con la tienda"

• Crea un token de API dedicado al CRM.
• Da la URL de la API + el token a tu integrador.
• Configura webhooks para que el CRM reciba avisos automáticos de pedidos y clientes nuevos.

"Quiero que mi sistema interno reserve inventario apenas un cliente complete un pedido"

• Configura un webhook de tipo "Pedido creado" apuntando al sistema interno.
• El sistema recibe el aviso con todos los productos del pedido y descuenta el stock internamente.

"Quiero gestionar mi catálogo dictándole a Claude / ChatGPT"

• Solicita activación de MCP al equipo técnico.
• Conecta tu asistente con las instrucciones de la pantalla.
• Empieza con consultas, luego pasa a modificaciones.

"Tengo una aplicación móvil propia y quiero que muestre el catálogo y permita comprar"

• Crea un token de API dedicado a la app móvil.
• Tu desarrollador usa la API para consumir productos, autenticar usuarios, crear pedidos, etc.

"Necesito un dashboard ejecutivo con métricas en tiempo real"

• Tu desarrollador puede consultar la API periódicamente (cada X minutos) para alimentar un dashboard hecho a medida.
• O configurar webhooks para actualizar el dashboard en el momento que cambia un pedido.

---

Tips finales

• API y Webhooks se complementan. API para consultas bajo demanda y operaciones del sistema externo hacia la tienda; webhooks para avisos automáticos de la tienda hacia el sistema externo.
• MCP no reemplaza la API. MCP es para uso humano vía asistente IA, en lenguaje natural. La API es para sistemas automatizados con código.
• Cualquier integración requiere a un desarrollador. El admin de Vendabo configura los tokens y webhooks, pero la integración real (qué hace el sistema externo con los datos) la hace código que un desarrollador escribe.
• Mantén la documentación de tus integraciones. Anota qué token corresponde a qué sistema, qué webhooks están activos y por qué. Tu yo del futuro te lo agradecerá si algo deja de funcionar.
• Si vas a hacer cambios grandes en tu tienda (cambio de plan, cambio de dominio, etc.), avisa a tus integraciones primero. Cambiar el dominio cambia las URLs de la API y de los webhooks — sin aviso previo, todas las integraciones rompen.
• La sección API es solo el primer paso. Hay un ecosistema completo de integradores y partners que pueden ayudarte a conectar Vendabo con prácticamente cualquier sistema empresarial. Si necesitas algo específico, contáctanos.

Siguiente paso

Conectada la tienda con sistemas externos, el resto de artículos del bloque Aplicaciones cubren integraciones específicas con transportistas locales (BM Cargo, Domex, PedidosYa, Buenvío, Mail Boxes Etc., Menssajero) para automatizar envíos y tracking.