API de Tray: pedidos, productos y clientes de la tienda con agentes de IA
Tray es una plataforma brasileña de comercio electrónico con una API REST para conectar la tienda a ERP, marketplaces y hubs. La usan comerciantes e integradores para sincronizar pedidos, catálogo e inventario. El acceso se hace mediante una aplicación autorizada por la tienda, que genera las claves de acceso.
Qué ofrece la API de Tray
Pedidos
Listar y consultar pedidos, actualizar el estado y el código de seguimiento.
Productos y variaciones
Crear y editar productos, variaciones, categorías e imágenes.
Inventario y precios
Actualizar inventario y precio por producto o variación.
Clientes
Consultar y actualizar los registros de clientes.
Cupones y envío
Consultar las formas de envío y gestionar cupones.
Notificaciones
Recibir avisos de pedidos nuevos y cambios en una URL de notificación.
Cómo acceder a la API de Tray
- Con las credenciales de tu empresaLa tienda autoriza una aplicación registrada en Tray, que recibe un código para generar el access token y el refresh token.
- Tray aplica límites de solicitudes por tienda; el agente usa notificaciones en lugar de consultar todo el tiempo.
- Los datos de clientes y direcciones están sujetos a la ley brasileña de protección de datos (LGPD).
- Los cambios masivos de precio, con aprobación.
Documentación oficial: developers.tray.com.br
Qué hace un agente de iTeam con la API de Tray
Seguimiento enviado sin que lo pidan
Cuando el pedido se despacha, el agente guarda el seguimiento en Tray y avisa al cliente por WhatsApp.
Carrito y pedido pendiente
Los pedidos que esperan pago reciben un recordatorio del agente con el enlace de pago.
Catálogo sin errores
El agente revisa los productos sin foto, sin peso o con descripción corta y propone correcciones.
Inventario sincronizado
Las diferencias entre el ERP y Tray se convierten en una alerta con la lista de SKU afectados.
De la credencial al agente trabajando, con aprobación
Autorizar la aplicación en la tienda
Registra la aplicación de integración en Tray y autorízala en la tienda para generar las claves de acceso.
Registrar la credencial en la bóveda de iTeam
La credencial de Tray queda en la bóveda de iTeam, fuera de prompts y hojas de cálculo. Cada agente recibe solo las acciones que necesita (leer pedidos, actualizar el seguimiento, ajustar el inventario), y lo que escribe datos pasa por aprobación.
Probar con aprobación humana
Antes de habilitarlo, actualiza el seguimiento de un pedido de prueba. En las primeras semanas, las acciones de escritura quedan con aprobación y todo queda en la auditoría.
Equipos de IA listos para este trabajo
Atención por WhatsApp
Jaca contesta en WhatsApp Business con tus precios, horarios y políticas, y cuando algo pide criterio humano se lo pasa a tu equipo con el contexto co…
Soporte al cliente
Jaca contesta los tickets repetidos con lo que ya está escrito en Confluence, y tu equipo se queda con los casos que piden criterio.
Recepcionista con IA
Jaca atiende el teléfono con voz, entiende qué necesita quien llama y deja la cita agendada o el recado en manos de la persona correcta.
Atención para tiendas online
Jaca consulta el pedido en Shopify o WooCommerce y contesta el estado del envío al momento, sin que nadie de tu equipo abra el panel.
Postventa y customer success
Nina vigila cómo usa cada cliente lo que compró, Jaca lo contacta en el momento justo y Romeo detecta quién está listo para ampliar.
Encuestas de satisfacción
Gaia diseña la encuesta, Jaca la envía en el momento justo y Nina convierte cada queja en una tarea con dueño.
Preguntas sobre la API de Tray
¿La API de Tray es gratuita?
El uso de la API está incluido para las tiendas de Tray, dentro de los límites de la plataforma; las aplicaciones de terceros pueden tener un costo propio.
¿Necesito programar para usar la API de Tray con iTeam?
No necesariamente. La herramienta HTTP de iTeam aprende los endpoints de la API de Tray a partir de la documentación, y el equipo de implantación configura credenciales, permisos y el proceso. Tu equipo valida el resultado.
¿La API de Tray sirve para integrar con un marketplace?
Sí, es la base de los hubs y ERP que conectan Tray con marketplaces. El agente de iTeam usa la misma API para seguir la operación.
