API de Nuvemshop: qué se puede hacer y cómo usarla con agentes de IA
La API de Nuvemshop, plataforma de tiendas en línea que fuera de Brasil se llama Tiendanube, permite leer y actualizar productos, variantes, stock, pedidos, clientes y cupones de la tienda, además de recibir eventos por webhook. La usan comerciantes, agencias y desarrolladores de apps para la plataforma. El acceso es mediante una app autorizada por el dueño de la tienda.
Qué ofrece la API de Nuvemshop
Productos y variantes
Alta y edición de precio, descripción, imágenes y variantes de producto.
Stock
Actualización de las cantidades disponibles por variante.
Pedidos
Consulta y actualización de pedidos, pago y estado del envío.
Clientes
Lectura de los datos de los clientes registrados en la tienda.
Cupones
Creación y gestión de cupones de descuento.
Webhooks
Avisos de nuevo pedido, pago, cambio de producto y otros eventos.
Cómo acceder a la API de Nuvemshop
- Con las credenciales de tu empresaUsa OAuth 2.0: la app se crea en el portal de socios de Nuvemshop y el comerciante la autoriza, lo que genera el token de acceso de esa tienda.
- Hay un límite de solicitudes por tienda: evita los barridos completos frecuentes.
- Pide solo los permisos que el proceso usa.
- Los datos de los clientes están protegidos por la LGPD, la ley brasileña de protección de datos.
Documentación oficial: tiendanube.github.io/api-documentation
Qué hace un agente de iTeam con la API de Nuvemshop
Estado del pedido por WhatsApp
El agente de atención consulta el pedido por su número y responde al cliente con el pago, el envío y el seguimiento.
Descripciones de producto mejoradas
El agente reescribe las descripciones débiles a partir de la ficha técnica y las sube a la tienda tras la aprobación del responsable.
Alerta de stock bajo
Cuando una variante muy vendida llega al mínimo, el agente avisa a compras con el historial de rotación.
Cupón para un cliente recurrente
El agente crea un cupón de un solo uso para un cliente que se quejó de un retraso, dentro del límite de descuento aprobado.
De la credencial al agente trabajando, con aprobación
Crear la app en el portal de socios
Crea una app en Nuvemshop con los permisos necesarios (productos, pedidos, clientes) e instálala en la tienda de la empresa.
Guardar el token en la bóveda
El token generado en la instalación queda en la bóveda de iTeam, y cada agente recibe solo las acciones que necesita.
Probar con aprobación
Mantén los cambios de precio, producto y cupones bajo aprobación durante las primeras semanas.
Equipos de IA listos que usan Nuvemshop
Preguntas sobre la API de Nuvemshop
¿La API de Nuvemshop es gratuita?
En general, la API forma parte de la plataforma y no tiene cobro aparte. Lo que puede haber es el costo de apps de terceros o del plan de la tienda.
¿Necesito programar para usar la API de Nuvemshop con iTeam?
No necesariamente. El equipo de implementación de iTeam crea la app y configura las acciones a partir de la documentación, y tú solo apruebas lo que hace el agente.
¿La API de Nuvemshop sirve para Tiendanube?
Sí. Nuvemshop y Tiendanube son la misma plataforma y comparten la misma API.
