Preguntas Frecuentes

Trusteed ayuda a los asistentes de IA a consultar productos de una tienda y, donde está soportado, a solicitar acciones de compra según sus reglas. Por ejemplo, un asistente puede encontrar un producto y consultar su precio; para comprar puede hacer falta aprobación humana. Lo disponible depende de la plataforma y su configuración.

Puedes empezar con la auditoría gratuita de tu tienda sin crear una cuenta. Si quieres un piloto guiado, dinos qué plataforma usas y qué deseas probar; confirmaremos el alcance y las condiciones antes de empezar.

Los asistentes que admiten el método de conexión correspondiente pueden usar el endpoint MCP de una tienda. Claude y los clientes MCP propios son ejemplos. ChatGPT utiliza una integración de app separada; las acciones disponibles dependen del cliente y de la configuración de la tienda.

Depende de tu plataforma y de las acciones que quieras habilitar. Puedes empezar con la auditoría gratuita para ver qué muestran tus páginas públicas. Para conectar la tienda, consulta la página de integraciones o cuéntanos tu caso y te explicaremos los pasos.

Normalmente puedes conservar tu tienda y tu proveedor de pagos. La conexión varía según la plataforma: Shopify usa autorización desde el panel; otras pueden necesitar un módulo o alta guiada. Consulta el estado actual en la página de tu integración.

La conexión puede usar datos de productos, precios, stock, políticas y pedidos, según las funciones que actives. Revisa los permisos solicitados antes de conectar la tienda. Las credenciales se cifran en reposo.

Puedes fijar límites para las acciones compatibles, como un importe a partir del cual se pide revisión. Por ejemplo, un pedido que supere el límite acordado puede pausarse para aprobación. Los controles disponibles dependen de la integración y del piloto.

El Trust Score determina la visibilidad de tu tienda en los resultados de búsqueda de los agentes. Las tiendas por encima de un nivel de confianza mínimo aparecen en el nivel principal; los niveles de confianza más bajos se despriorizan; las tiendas por debajo del umbral de elegibilidad o suspendidas quedan ocultas. Mejora tu puntuación manteniendo los datos del catálogo actualizados, precios precisos y altas tasas de cumplimiento.

La Agent API usa claves con el prefijo agnt_. Crea claves mediante POST /api/v1/agent-keys con tu JWT. Las claves admiten permisos con ámbito: agent:read (navegación de catálogo), agent:cart (creación de carrito), agent:checkout (inicio de checkout). Incluye la clave en el header X-Agent-Api-Key.

Cada tienda tiene un endpoint MCP único en /{store-slug}/mcp. El servidor MCP global en /mcp sirve a todas las tiendas conectadas y acepta consultas de búsqueda en todo el catálogo. Transporte: Streamable HTTP (MCP spec 2025-06-18+). SSE está deprecado por la spec; no se expone.

Todos los POST de webhook incluyen un header X-Webhook-Signature con una firma HMAC-SHA256. Calcula el HMAC-SHA256 del cuerpo raw de la petición usando tu secreto de webhook y compáralo con el valor del header. Rechaza las peticiones cuyas firmas no coincidan.

Sí. La especificación OpenAPI 3.0 completa está disponible en /api/v1/openapi.json. Impórtala en Postman, Insomnia o cualquier herramienta compatible con OpenAPI. Hay una Swagger UI interactiva disponible en /api/docs.

Trusteed expone múltiples capas de descubrimiento: /.well-known/merchant-index.json (registro completo de comercios: slug, categorías, trust_score, mcp_endpoint, frescura; ISR 5 min, sin autenticación), /.well-known/agent-commerce.json (contrato canónico con endpoints, autenticación, límites de tasa, framework de confianza y directorio de comercios), /mcp.json (manifiesto MCP con todas las herramientas), /.well-known/ai-plugin.json (compatible con ChatGPT/OpenAI) y etiquetas <link rel='mcp'> en la cabecera de cada página para agentes basados en navegador.

La creación de carrito y el inicio de checkout siempre requieren confirmación humana explícita. Las operaciones de solo lectura (búsqueda, detalle de producto, disponibilidad, perfil de comercio) nunca requieren confirmación. El umbral de confirmación también es configurable por comercio. Por defecto, cualquier pedido superior a 100 $ activa un paso de confirmación adicional.

relevanceScore = (text_relevance × 0,55) + (store_trust_score × 0,25) + (freshness × 0,10) + (in_stock × 0,10). Las tiendas por debajo del umbral de confianza del nivel activo siempre se colocan después de todas las tiendas del nivel activo independientemente de su relevanceScore calculado. Es un ordenamiento en dos niveles fijo, no un desempate.

No. Trusteed no es un procesador de pagos ni un merchant of record: cuando hay cargo, se hace en la cuenta de pago del propio comercio, con sus credenciales. La herramienta de checkout (complete_checkout) devuelve un status: COMPLETED con order_id, o PENDING_EXTERNAL_CONFIRMATION con un enlace donde el comprador aprueba o paga (en una tienda Shopify, el checkout del propio comercio). En la tienda de demostración el pedido es simulado y no se cobra nada.