Integración de Oracle NetSuite con WhatsApp y agentes de IA, a medida
Actualizado el 20 de octubre de 2026 · Revisado por Alejandro Díaz, CEO de Agent IA SAS
En NetSuite ya está lo que tu cliente pregunta por WhatsApp: cuántas unidades hay disponibles en cada ubicación, su nivel de precio, el estado de su pedido y lo que tiene vencido. La integración a medida conecta el agente de IA de SoyAgentia con la API REST de tu cuenta para que responda con esos datos y registre las transacciones que acuerdes.
Aquí verás qué registros de NetSuite usa el agente, cómo se autentica, qué límites aplica Oracle y cómo trabajamos el proyecto. Si tienes otro ERP, revisa integraciones con ERP.
Qué puede hacer el agente de IA conectado a Oracle NetSuite
Cada operación usa un registro que la API REST de NetSuite soporta. Con ellos, el agente puede:
- Consultar la disponibilidad de un artículo por ubicación en el registro inventoryItem, cuya sublista locations trae la cantidad disponible (quantityAvailable) y la cantidad en mano (quantityOnHand).
- Leer el precio del artículo en su sublista de precios, por nivel de precio, moneda y cantidad, si tienes activadas las funciones de monedas múltiples, precios múltiples y precios por cantidad.
- Buscar al cliente en el registro customer por su correo o su teléfono, con el filtro q o con una consulta SuiteQL, y crearlo con un POST si no existe y así lo acordamos.
- Registrar una cotización (estimate) o un pedido de venta (salesOrder) con los artículos y cantidades del chat, y devolver al cliente su número de pedido (tranId).
- Consultar el estado de un pedido o de una factura (invoice) y, si se incluye en el alcance, el saldo y el saldo vencido del cliente (balance y overdueBalance).
Cómo se conecta: SuiteTalk REST Web Services
SuiteTalk REST Web Services es la API REST de NetSuite: permite crear, leer, actualizar y borrar registros en JSON en /services/rest/record/v1/, y ejecutar consultas SuiteQL con un POST a /services/rest/query/v1/suiteql, con hasta 100.000 resultados. A diferencia de los RESTlets, no exige escribir ni desplegar scripts en tu cuenta. El resumen está en la documentación de REST Web Services.
REST no admite inicio de sesión con usuario y contraseña: se autentica con OAuth 2.0 o con autenticación por token (TBA), y Oracle prefiere OAuth 2.0. Para un conector de servidor a servidor usamos el flujo client credentials (M2M): tu administrador crea un registro de integración y asocia una entidad, un rol y nuestro certificado público en la configuración de OAuth 2.0. El detalle está en configurar la autenticación.
Oracle está retirando SOAP: el endpoint 2025.2 es el último planeado, desde la 2027.1 no se podrán crear integraciones SOAP nuevas y en la 2028.2 dejarán de funcionar todas, según sus preguntas sobre el retiro de SOAP. Si algún caso no se puede resolver con REST, Oracle indica usar RESTlets de SuiteScript.
Las peticiones de web services y RESTlets comparten un límite de concurrencia por cuenta. La base depende de tu nivel de servicio (5 en Standard, 15 en Premium, 20 en Enterprise y Ultimate) y sube 10 por cada licencia SuiteCloud Plus, según la tabla de límites de Oracle. Si se supera, NetSuite devuelve un error y el conector reintenta.
Lo que necesitas tener en Oracle NetSuite
Revisa estos puntos con tu administrador o tu partner de NetSuite:
- La función REST Web Services activada en la pestaña SuiteCloud de Enable Features, con los términos de SuiteCloud aceptados.
- Un rol propio para la integración con el permiso REST Web Services y acceso solo a los registros acordados; Oracle no recomienda usar el rol de administrador para integraciones.
- SuiteTax activado si los pedidos llevan impuestos: REST no admite las funciones de impuestos heredadas.
- Una cuenta sandbox, que se compra aparte y contiene una copia de tus datos de producción, para desarrollar y probar sin tocarlos.
- Margen en tu límite de concurrencia, que puedes ver en la página Integration Governance, porque lo comparten todas tus integraciones.
Cómo trabajamos la integración a medida
El proyecto sigue cinco pasos:
- Diagnóstico: definimos qué consulta y qué registra el agente, con qué registros y consultas SuiteQL, qué ubicaciones y niveles de precio usa y en qué canales.
- Acceso: tu administrador crea en el sandbox el registro de integración, el rol y el mapeo del certificado para el flujo M2M.
- Desarrollo: construimos el conector y las reglas del agente: qué ubicación consulta, cuándo crea la cotización o el pedido y cuándo pasa la conversación a una persona.
- Pruebas: validamos con conversaciones reales en el sandbox hasta que las transacciones salgan como las registra tu equipo.
- Puesta en marcha: repetimos la configuración de OAuth 2.0 en producción, revisamos contigo los primeros pedidos y monitoreamos errores y concurrencia.
Límites y decisiones de diseño
Para que no haya sorpresas:
- No es un conector listo: se desarrolla para tu NetSuite y se cotiza aparte del plan del agente. SoyAgentia no es partner de Oracle.
- El agente no toca la contabilidad: no registra pagos, notas crédito ni transforma pedidos en facturas, salvo que se defina expresamente en el alcance.
- La API REST no crea registros en bloque: el agente registra una transacción por petición.
- El mapeo del flujo client credentials no se copia al sandbox y se borra en cada actualización del sandbox, así que hay que repetirlo después de cada refresco.
- Oracle NetSuite es una marca de Oracle Corporation. SoyAgentia no está afiliada a Oracle Corporation.
Integraciones disponibles
- Oracle NetSuite (SuiteTalk REST Web Services y SuiteQL)
- WhatsApp Business API (Cloud API)
- Instagram, Messenger, TikTok, WordPress y Shopify, según el alcance
Sigue leyendo
Preguntas frecuentes
¿Por qué la integración usa REST y no SOAP?
Porque Oracle presenta SuiteTalk REST como el reemplazo de SOAP y recomienda REST con OAuth 2.0 para toda integración nueva desde la versión 2026.1. Desde la 2027.1 ya no se podrán crear integraciones SOAP nuevas.
¿Tengo que darles un usuario y contraseña de NetSuite?
No. La API REST no acepta usuario y contraseña. El conector usa OAuth 2.0 con un certificado que tu administrador asocia a un rol de integración, y puede revocarlo cuando quiera.
¿La integración afecta a mis otras integraciones con NetSuite?
Comparte con ellas el límite de concurrencia de tu cuenta. En el diagnóstico revisamos ese límite en Integration Governance y diseñamos el conector para hacer pocas llamadas por conversación y reintentar si NetSuite rechaza una petición.
¿Puedo probar todo en mi sandbox antes de producción?
Sí, y es lo recomendable. El sandbox tiene el mismo límite de concurrencia que producción y una copia de tus datos. Solo hay que configurar OAuth 2.0 allí por separado.