# Integración de CONTPAQi con WhatsApp y agentes de IA, a medida > Conectamos CONTPAQi Comercial Premium con tu agente de IA de WhatsApp por medio de su SDK: existencias por almacén, clientes y documentos de venta. - URL: https://www.soyagentia.com/integraciones/contpaqi-whatsapp/ - Actualizado el 20 de octubre de 2026 - Revisado por Alejandro Díaz, CEO de Agent IA SAS - SoyAgentia (Agent IA SAS, NIT 901.976.734-4) ## En resumen - Desarrollamos a medida el conector entre CONTPAQi Comercial Premium y el agente de IA de SoyAgentia, para que responda en WhatsApp con existencias y precios de tu sistema y registre los documentos acordados. - CONTPAQi no publica una API web para Comercial: la vía documentada es su SDK, una librería que trabaja con el sistema instalado en Windows, monousuario o como estación. - Por eso el conector corre en un equipo de tu red con CONTPAQi instalado y expone al agente solo las operaciones acordadas. - No es un conector que se activa con un clic: se define el alcance contigo y se cotiza aparte del plan. Si vendes con CONTPAQi Comercial Premium, lo que tu cliente pregunta por WhatsApp ya está en tu empresa de CONTPAQi: cuántas piezas hay en cada almacén, el precio de su lista, si su cotización ya quedó registrada. La integración a medida conecta el agente de IA de SoyAgentia con esos datos usando el SDK oficial de CONTPAQi, la herramienta que CONTPAQi publica para que desarrolladores externos consulten o modifiquen información del sistema. Comercial Premium es un sistema de escritorio, así que esta integración tiene una parte local que conviene entender antes de empezar. Aquí te explicamos qué puede hacer el agente, cómo se conecta, qué necesitas de tu lado y cómo trabajamos. Si usas otro ERP, revisa las [integraciones con ERP](https://www.soyagentia.com/integraciones/erp/). ## Qué puede hacer el agente de IA conectado a CONTPAQi El SDK publica funciones que leen y registran información siguiendo las reglas de negocio del sistema. Con ellas, el agente puede: - Consultar la existencia de un producto en un almacén con fRegresaExistencia, que devuelve la existencia a una fecha dada. - Buscar el producto por su código con fBuscaProducto y leer sus datos con fLeeDatoProducto, incluidos los precios de sus listas (campos cPrecio1, cPrecio2 y siguientes). - Buscar al cliente por su código con fBuscaCteProv y, si es nuevo y así lo decides, darlo de alta con fAltaCteProv. - Registrar el documento de venta acordado, por ejemplo una cotización, con fAltaDocumento y sus partidas con fAltaMovimiento, usando el código de concepto que ya tienes configurado (aCodConcepto), y afectarlo con fAfectaDocto, como pide el manual. - Localizar un documento por su llave con fBuscaDocumento cuando el cliente pregunta por él, y dejar la referencia en el [CRM de SoyAgentia](https://www.soyagentia.com/crm-whatsapp/) junto con la conversación. ## Cómo se conecta: el SDK de CONTPAQi CONTPAQi documenta su SDK en el Manual de Referencia del SDK, que su [base de conocimiento](https://contenidos.contpaqi.com/generales) publica para CONTPAQi Comercial Premium y CONTPAQi Factura Electrónica. No es una API web: es una librería (MGWServicios, en el caso de Comercial Premium) que se instala con el sistema y se llama desde un programa en Windows. Cada proceso inicializa el SDK (fInicializaSDK), abre la empresa (fAbreEmpresa), hace su trabajo, cierra la empresa y termina el SDK (fTerminaSDK). Según los requerimientos del SDK, necesitas Comercial Premium o Factura Electrónica instalado, monousuario o como estación. En la práctica, el conector vive en un equipo Windows de tu red con CONTPAQi instalado y publica hacia el agente un servicio con autenticación que solo ofrece las operaciones acordadas. El agente nunca entra a tu base de datos de forma directa. Hay dos detalles del manual que cuidamos. El SDK trabaja con una empresa a la vez, y CONTPAQi recomienda no usar un SDK de una versión distinta a la de tu sistema, así que las actualizaciones de CONTPAQi se coordinan con el conector. Si trabajas con CONTPAQi Escritorio Virtual, el entorno virtual en el que CONTPAQi ofrece Comercial Premium, la ubicación del conector se define en el diagnóstico. ## Lo que necesitas tener en CONTPAQi Antes de empezar, revisa estos puntos con tu distribuidor CONTPAQi: - CONTPAQi Comercial Premium vigente. El manual del SDK está escrito para Comercial Premium y Factura Electrónica; si usas Comercial Pro o Start, lo revisamos en el diagnóstico porque el manual no los menciona. - Un equipo Windows en tu red, encendido en tu horario de atención, con CONTPAQi instalado como estación y salida a internet para comunicarse con el agente. - Una empresa de pruebas, copia de la tuya, para desarrollar sin tocar la productiva. El SDK abre la empresa por su directorio, así que basta con indicar cuál usar en cada etapa. - Conceptos de documento, almacenes y listas de precios definidos, porque el agente usa los que ya tienes. - Las licencias que correspondan. Por ejemplo, el manual indica que emitir documentos con fEmiteDocumento en Comercial Premium requiere licencia de 5 usuarios o más. ## Cómo trabajamos la integración a medida El proyecto sigue cinco pasos: - Diagnóstico: definimos con tu equipo y tu distribuidor qué consulta y qué registra el agente en CONTPAQi, con qué concepto, almacén y lista de precios, y en qué canales. - Acceso: preparas el equipo Windows con CONTPAQi y la empresa de pruebas, y nos das acceso para instalar el conector. - Desarrollo: construimos el conector sobre el SDK y las reglas del agente: qué datos pide, cuándo registra y cuándo pasa la conversación a una persona. - Pruebas: validamos con conversaciones reales contra la empresa de pruebas hasta que los documentos queden afectados y se vean en CONTPAQi como los registra tu equipo. - Puesta en marcha: apuntamos a tu empresa productiva, revisamos contigo los primeros documentos y monitoreamos que el equipo del conector siga disponible. ## Límites y decisiones de diseño Para que no haya sorpresas: - No es un conector listo: se desarrolla para tu CONTPAQi y se cotiza aparte del plan del agente. - El agente no timbra ni toca la contabilidad. El SDK tiene funciones de timbrado y CONTPAQi Contabilidad tiene su propio SDK, pero quedan fuera salvo que se defina expresamente en el alcance. - Si el equipo del conector se apaga o pierde conexión, el agente no puede consultar CONTPAQi. Para ese caso se define que avise al cliente y pase la conversación a tu equipo. - Tus licencias de CONTPAQi siguen siendo tuyas con tu distribuidor. - CONTPAQi es una marca de Computación en Acción, S.A. de C.V. SoyAgentia no está afiliada a Computación en Acción. ## Preguntas frecuentes ### ¿CONTPAQi tiene una API en la nube para conectar WhatsApp? No para Comercial Premium en su documentación pública. La vía que documenta CONTPAQi es el SDK, que trabaja con el sistema instalado. Por eso el conector necesita un equipo de tu red con CONTPAQi. ### ¿Funciona con CONTPAQi Comercial Pro o Comercial Start? El manual del SDK está escrito para Comercial Premium y Factura Electrónica. Si usas Pro o Start, lo revisamos en el diagnóstico antes de comprometer un alcance. ### ¿El agente puede facturar desde WhatsApp? El SDK tiene funciones para emitir y timbrar CFDI, pero no las usamos por defecto: el agente registra el documento acordado y tu equipo factura como siempre. Si quieres incluirlo, se evalúa en el alcance junto con las licencias que pide CONTPAQi. ### ¿Tengo que cambiar de distribuidor CONTPAQi? No. Tu distribuidor sigue a cargo de tus licencias y actualizaciones. Nosotros construimos el conector y coordinamos con él las versiones del SDK. ### ¿Cuánto cuesta conectar CONTPAQi con el agente? Depende del alcance y se cotiza aparte del plan del agente, que ves en [planes](https://www.soyagentia.com/pricing/). Las licencias de CONTPAQi las sigues pagando a tu distribuidor. Pide tu cotización en [cotizar](https://www.soyagentia.com/cotizar/). ## Sigue leyendo - [Integraciones con ERP a medida](https://www.soyagentia.com/integraciones/erp/) - [Todas las integraciones](https://www.soyagentia.com/integraciones/) - [Agentes de IA para WhatsApp](https://www.soyagentia.com/agentes-ia-whatsapp/) - [Integración de SAP Business One con WhatsApp](https://www.soyagentia.com/integraciones/sap-business-one-whatsapp/) - [Cotizar una integración a medida](https://www.soyagentia.com/cotizar/)