{"id":13804,"date":"2026-11-12T15:23:04","date_gmt":"2026-11-12T15:23:04","guid":{"rendered":"https:\/\/support.spoki.com\/?post_type=docs&#038;p=13804"},"modified":"2026-11-12T15:31:05","modified_gmt":"2026-11-12T15:31:05","password":"","slug":"shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide","status":"publish","type":"docs","link":"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/","title":{"rendered":"Metaobjects de Shopify para el agente de IA: mensajes de lanzamiento y gu\u00eda de configuraci\u00f3n"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Mensaje de lanzamiento externo (clientes)<\/h2>\n\n\n\n<p><strong>Asunto: Tu agente de IA ya puede leer los metaobjects de Shopify<\/strong><\/p>\n\n\n\n<p>Tu agente de IA de Spoki ya puede responder con el contenido que guardas en los metaobjects de Shopify, no solo con lo que aparece en el producto.<\/p>\n\n\n\n<p>Muchas tiendas guardan en los metaobjects los detalles que var\u00edan seg\u00fan el pa\u00eds o el idioma: colores y revestimientos, im\u00e1genes, precios, disponibilidad, plazos de entrega. Hasta ahora el agente solo pod\u00eda leer los productos, as\u00ed que no pod\u00eda decirle a un cliente en Francia qu\u00e9 colores de un sof\u00e1 se venden en Francia. Ahora s\u00ed puede.<\/p>\n\n\n\n<p><strong>Qu\u00e9 puede hacer el agente<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ver qu\u00e9 tipos de metaobject tiene tu tienda.<\/li>\n\n\n\n<li>Leer las entradas de un tipo y buscarlas por nombre, por ejemplo un modelo y un pa\u00eds.<\/li>\n\n\n\n<li>Seguir los enlaces entre entradas, productos e im\u00e1genes.<\/li>\n<\/ul>\n\n\n\n<p>El agente solo lee el contenido publicado y visible en tu storefront. Nunca modifica nada en tu tienda.<\/p>\n\n\n\n<p><strong>Qu\u00e9 tienes que hacer<\/strong><\/p>\n\n\n\n<p>Las nuevas opciones est\u00e1n desactivadas de forma predeterminada. Si no haces nada, tu agente sigue funcionando exactamente igual que hoy. Para usarlas:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>A\u00f1ade los permisos de metaobject a la app de Shopify que has conectado a Spoki: read_metaobjects, read_metaobject_definitions y read_files, junto a read_products.<\/li>\n\n\n\n<li>En Spoki, abre tu integraci\u00f3n de Shopify en AI Agents > Integrations and Tools y gu\u00e1rdala de nuevo, o crea una nueva.<\/li>\n\n\n\n<li>Activa las tres opciones nuevas: List Metaobject Definitions, Get Metaobjects, Get Metaobject.<\/li>\n<\/ol>\n\n\n\n<p>La gu\u00eda paso a paso est\u00e1 m\u00e1s abajo, tanto para una app existente como para una nueva. Si necesitas ayuda, escribe al soporte de Spoki.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Mensaje de lanzamiento interno (Support, CS, Sales, equipo de IA)<\/h2>\n\n\n\n<p><strong>Asunto: El agente de IA puede leer los metaobjects de Shopify (activaci\u00f3n opcional por cliente)<\/strong><\/p>\n\n\n\n<p>La herramienta de Shopify del agente de IA tiene tres opciones nuevas de solo lectura que leen los metaobjects directamente de la tienda del cliente. Se cre\u00f3 para poltronesof\u00e0, cuyo producto es un contenedor gen\u00e9rico, mientras que los colores, las im\u00e1genes, los precios y la disponibilidad por pa\u00eds viven en los metaobjects.<\/p>\n\n\n\n<p><strong>Qu\u00e9 se ha publicado<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Tres opciones en la integraci\u00f3n de Shopify: List Metaobject Definitions, Get Metaobjects, Get Metaobject.<\/li>\n\n\n\n<li>El agente lee en tiempo real desde Shopify con las credenciales del propio cliente. En Spoki no se almacena nada.<\/li>\n\n\n\n<li>Solo se devuelve el contenido publicado: tipos con acceso al storefront, entradas Active, productos Active.<\/li>\n\n\n\n<li>No hizo falta ning\u00fan cambio en la aplicaci\u00f3n web. Las opciones aparecen en el formulario existente de la integraci\u00f3n de Shopify.<\/li>\n<\/ul>\n\n\n\n<p><strong>A qui\u00e9n afecta<\/strong><\/p>\n\n\n\n<p>A nadie, hasta que active la funci\u00f3n. Las opciones est\u00e1n desactivadas de forma predeterminada y las integraciones existentes siguen funcionando sin cambios.<\/p>\n\n\n\n<p><strong>Qu\u00e9 debe hacer un cliente para usarlo<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>A\u00f1adir read_metaobjects, read_metaobject_definitions y read_files a su app de Shopify. Tambi\u00e9n es obligatorio read_products; los clientes que siguieron nuestra gu\u00eda de configuraci\u00f3n ya lo tienen.<\/li>\n\n\n\n<li>Volver a guardar la integraci\u00f3n de Shopify en Spoki (o crear una nueva), para que se vuelvan a comprobar los permisos.<\/li>\n\n\n\n<li>Activar las tres opciones y guardar.<\/li>\n\n\n\n<li>A\u00f1adir al prompt del agente una frase que indique que el contenido que depende del pa\u00eds est\u00e1 en los metaobjects.<\/li>\n<\/ol>\n\n\n\n<p><strong>Qu\u00e9 debe saber el equipo de Support<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>S\u00edntoma<\/th><th>Causa<\/th><th>Qu\u00e9 hacer<\/th><\/tr><\/thead><tbody><tr><td>Las tres opciones muestran \u00abMissing required permissions\u00bb<\/td><td>A la app de Shopify le falta uno de los cuatro scopes<\/td><td>Seguir la gu\u00eda de configuraci\u00f3n que aparece m\u00e1s abajo y volver a guardar la integraci\u00f3n<\/td><\/tr><tr><td>Las opciones no aparecen en una integraci\u00f3n antigua<\/td><td>La integraci\u00f3n se guard\u00f3 antes del lanzamiento<\/td><td>Abrirla y volver a guardar las credenciales<\/td><\/tr><tr><td>El agente dice que un tipo o una entrada no existe<\/td><td>El tipo no tiene acceso al storefront, o la entrada est\u00e1 en Draft<\/td><td>Activar el acceso al storefront en la definici\u00f3n del metaobject y poner la entrada en Active<\/td><\/tr><tr><td>El agente responde desde el producto e ignora los metaobjects<\/td><td>El prompt no los menciona<\/td><td>A\u00f1adir la frase del prompt que aparece en la gu\u00eda<\/td><\/tr><tr><td>El agente no encuentra una entrada<\/td><td>La b\u00fasqueda solo compara palabras del nombre de la entrada<\/td><td>Nombrar las entradas con el modelo y el pa\u00eds, o preguntar con el nombre exacto<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>L\u00edmites que conviene tener en cuenta<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>El agente debe conocer el pa\u00eds del cliente a partir de la conversaci\u00f3n. No se detecta autom\u00e1ticamente.<\/li>\n\n\n\n<li>La b\u00fasqueda funciona sobre el nombre de la entrada. Si una tienda nombra las entradas de otra forma, el agente tiene que recorrerlas una a una, lo que es m\u00e1s lento.<\/li>\n\n\n\n<li>Probado en staging con una tienda de prueba (5 de 5 preguntas sobre pa\u00edses respondidas correctamente). Todav\u00eda no lo ha usado ning\u00fan cliente real.<\/li>\n<\/ul>\n\n\n\n<p><strong>Estado y responsable<\/strong><\/p>\n\n\n\n<p>Pull request <a href=\"https:\/\/github.com\/Spoki-App\/spoki-ai\/pull\/658\" rel=\"noreferrer noopener\" target=\"_blank\">spoki-ai #658<\/a>, a la espera de la revisi\u00f3n del equipo de IA. Seguimiento en la tarea de Notion <a href=\"https:\/\/app.notion.com\/p\/415e5c7af25c814eafc1fb3c5f9fbb9b\" rel=\"noreferrer noopener\" target=\"_blank\">Shopify MetaObjects<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Gu\u00eda de configuraci\u00f3n: antes de empezar<\/h2>\n\n\n\n<p>Necesitas cuatro permisos de Shopify (scopes) en la app conectada a Spoki, y tus metaobjects deben estar publicados.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Scope<\/th><th>Para qu\u00e9 sirve<\/th><th>\u00bfEs probable que ya est\u00e9?<\/th><\/tr><\/thead><tbody><tr><td>read_metaobjects<\/td><td>Leer las entradas de los metaobjects<\/td><td>No, nuevo<\/td><\/tr><tr><td>read_metaobject_definitions<\/td><td>Leer los tipos de metaobject y sus campos<\/td><td>No, nuevo<\/td><\/tr><tr><td>read_files<\/td><td>Leer las im\u00e1genes y los archivos vinculados a una entrada<\/td><td>No, nuevo<\/td><\/tr><tr><td>read_products<\/td><td>Leer los productos vinculados a una entrada<\/td><td>S\u00ed, si seguiste la gu\u00eda de Spoki para Shopify<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Si falta uno de los cuatro, las tres opciones permanecen desactivadas en Spoki con el aviso \u00abMissing required permissions\u00bb.<\/p>\n\n\n\n<p>Hay dos cosas que debes comprobar en el admin de Shopify, en Content &gt; Metaobjects:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>El acceso al storefront est\u00e1 activado<\/strong>\u00a0en cada definici\u00f3n de metaobject que el agente deba leer. Los tipos sin acceso al storefront quedan ocultos para el agente.<\/li>\n\n\n\n<li><strong>Las entradas est\u00e1n en Active<\/strong>, no en Draft. Las entradas en Draft quedan ocultas para el agente.<\/li>\n<\/ul>\n\n\n\n<p>A continuaci\u00f3n, sigue la gu\u00eda que corresponda a tu app:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>A.<\/strong>\u00a0Conectaste Spoki con un Client ID y un Client Secret (app del Dev Dashboard).<\/li>\n\n\n\n<li><strong>B.<\/strong>\u00a0Conectaste Spoki con un token de acceso de Admin API (custom app antigua creada en el admin de tu tienda).<\/li>\n\n\n\n<li><strong>C.<\/strong>\u00a0Todav\u00eda no tienes una app, o prefieres una independiente.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">A. App existente con Client ID y Client Secret (Dev Dashboard)<\/h2>\n\n\n\n<p>A\u00f1ades los scopes publicando una nueva versi\u00f3n de tu app. El Client ID y el Client Secret no cambian.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Abre el\u00a0<a href=\"https:\/\/dev.shopify.com\/dashboard\" target=\"_blank\" rel=\"noreferrer noopener\">Shopify Dev Dashboard<\/a>\u00a0y selecciona la app que conectaste a Spoki.<\/li>\n\n\n\n<li>En el men\u00fa de la izquierda, haz clic en\u00a0<strong>Versions<\/strong>\u00a0y luego en\u00a0<strong>Create version<\/strong>\u00a0(arriba a la derecha). El formulario se abre precargado con los datos de tu versi\u00f3n actual.<\/li>\n\n\n\n<li>En la secci\u00f3n\u00a0<strong>API access<\/strong>, localiza el campo\u00a0<strong>Scopes<\/strong>. Conserva todo lo que ya est\u00e9 ah\u00ed y a\u00f1ade, separados por comas: read_metaobjects,read_metaobject_definitions,read_files. A\u00f1ade tambi\u00e9n read_products si no est\u00e1 en la lista.<\/li>\n\n\n\n<li>Deja el resto de campos como est\u00e1n y haz clic en\u00a0<strong>Release<\/strong>\u00a0al final del formulario.<\/li>\n\n\n\n<li>En el admin de tu tienda Shopify, ve a\u00a0<strong>Settings > Apps and sales channels<\/strong>, abre la app y aprueba los permisos actualizados si Shopify te lo pide.<\/li>\n\n\n\n<li>Contin\u00faa con la secci\u00f3n \u00abEn Spoki\u00bb m\u00e1s abajo.<\/li>\n<\/ol>\n\n\n\n<p>Usa el campo <strong>Scopes<\/strong>, no <strong>Optional scopes<\/strong>: los optional scopes no se conceden autom\u00e1ticamente.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">B. App existente con un token de acceso de Admin API (custom app antigua)<\/h2>\n\n\n\n<p>Esta es la app descrita en el art\u00edculo de ayuda actual, <a href=\"https:\/\/support.spoki.com\/es\/docs\/integraciones\/conectar-shopify-con-spoki-ai-sales-agent\/\" rel=\"noreferrer noopener\" target=\"_blank\">Connect Shopify to Spoki AI Sales Agent<\/a>, creada en el admin de tu tienda en Develop apps. Los scopes se a\u00f1aden en la configuraci\u00f3n de la app.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>En el admin de Shopify, ve a\u00a0<strong>Settings > Apps and sales channels > Develop apps<\/strong>.<\/li>\n\n\n\n<li>Abre la app que creaste para Spoki (por ejemplo, \u00abSpoki AI Integration\u00bb).<\/li>\n\n\n\n<li>Abre la pesta\u00f1a\u00a0<strong>Configuration<\/strong>. En\u00a0<strong>Admin API integration<\/strong>, haz clic en\u00a0<strong>Edit<\/strong>\u00a0(o\u00a0<strong>Configure<\/strong>).<\/li>\n\n\n\n<li>Busca y marca read_metaobjects, read_metaobject_definitions y read_files. Comprueba que read_products est\u00e9 marcado.<\/li>\n\n\n\n<li>Haz clic en\u00a0<strong>Save<\/strong>.<\/li>\n\n\n\n<li>Contin\u00faa con la secci\u00f3n \u00abEn Spoki\u00bb m\u00e1s abajo. Usa el mismo token de acceso de Admin API de antes.<\/li>\n<\/ol>\n\n\n\n<p>La pesta\u00f1a Configuration enumera los scopes que tiene la app actualmente. Haz clic en <strong>Edit<\/strong> en Admin API integration para cambiarlos:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img fetchpriority=\"high\" decoding=\"async\" width=\"1024\" height=\"565\" src=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11-1024x565.jpeg\" alt=\"\" class=\"wp-image-13832\" srcset=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11-1024x565.jpeg 1024w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11-300x165.jpeg 300w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11-768x424.jpeg 768w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11.jpeg 1088w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Escribe \u00abmetaobject\u00bb en el filtro para encontrar los dos scopes de metaobject, marca los de read_, luego filtra por \u00abfiles\u00bb y marca read_files:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"659\" src=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-12-1024x659.jpeg\" alt=\"\" class=\"wp-image-13833\" srcset=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-12-1024x659.jpeg 1024w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-12-300x193.jpeg 300w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-12-768x494.jpeg 768w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-12.jpeg 1088w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Despu\u00e9s de guardar, abre la pesta\u00f1a <strong>API credentials<\/strong>. Si Shopify muestra un nuevo token de acceso de Admin API con <strong>Reveal token once<\/strong>, c\u00f3pialo y sustituye el token en tu integraci\u00f3n de Spoki. El token se muestra solo una vez.<\/p>\n\n\n\n<p>Por confirmar antes de enviar: si Shopify siempre emite un token nuevo tras un cambio de scopes en estas apps m\u00e1s antiguas. Las capturas de arriba son de nuestra tienda de prueba, donde los scopes ya est\u00e1n a\u00f1adidos; no cambi\u00e9 los scopes all\u00ed para comprobarlo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">C. App nueva<\/h2>\n\n\n\n<p>Shopify ya no permite crear las custom apps antiguas en el admin de la tienda, as\u00ed que una app nueva se crea en el Dev Dashboard. El recorrido completo est\u00e1 en el art\u00edculo de ayuda del m\u00e9todo nuevo: <a href=\"https:\/\/support.spoki.com\/docs\/uncategorized\/connect-your-shopify-store-to-spoki-ai-sales-agent-dev-dashboard-new-method\/\" rel=\"noreferrer noopener\" target=\"_blank\">Connect your Shopify store to Spoki AI Sales Agent (Dev Dashboard)<\/a>. La \u00fanica diferencia es la lista de scopes.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Abre el\u00a0<a href=\"https:\/\/dev.shopify.com\/dashboard\" target=\"_blank\" rel=\"noreferrer noopener\">Shopify Dev Dashboard<\/a>\u00a0y crea una app.<\/li>\n\n\n\n<li>Crea su primera versi\u00f3n. En\u00a0<strong>API access > Scopes<\/strong>, introduce los scopes de la gu\u00eda de Spoki y a\u00f1ade los de metaobject. La lista completa:<\/li>\n<\/ol>\n\n\n\n<p>read_products,read_product_listings,write_product_listings,read_orders,write_orders,read_customers,write_customers,read_draft_orders,write_draft_orders,read_metaobjects,read_metaobject_definitions,read_files<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Haz clic en\u00a0<strong>Release<\/strong>.<\/li>\n\n\n\n<li>Instala la app en tu tienda.<\/li>\n\n\n\n<li>En la p\u00e1gina\u00a0<strong>Settings<\/strong>\u00a0de la app, copia el\u00a0<strong>Client ID<\/strong>\u00a0y el\u00a0<strong>Client secret<\/strong>.<\/li>\n\n\n\n<li>Contin\u00faa con la secci\u00f3n \u00abEn Spoki\u00bb m\u00e1s abajo y crea una nueva integraci\u00f3n de Shopify con estas credenciales.<\/li>\n<\/ol>\n\n\n\n<p>Si el agente solo necesita leer productos y metaobjects, bastan los cuatro scopes de la secci\u00f3n \u00abAntes de empezar\u00bb. En ese caso, las opciones de pedidos y clientes permanecen desactivadas en Spoki.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">En Spoki: activa las opciones<\/h2>\n\n\n\n<p>Spoki comprueba los permisos de Shopify al guardar la integraci\u00f3n, as\u00ed que hay que volver a guardarla despu\u00e9s de cambiar los scopes.<\/p>\n\n\n\n<p><strong>Si ya tienes una integraci\u00f3n de Shopify<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Ve a\u00a0<strong>AI Agents > Integrations and Tools<\/strong>.<\/li>\n\n\n\n<li>Abre tu integraci\u00f3n de Shopify y vuelve a guardar las credenciales, sin cambiarlas.<\/li>\n\n\n\n<li>En la lista de opciones de Shopify, activa\u00a0<strong>List Metaobject Definitions<\/strong>,\u00a0<strong>Get Metaobjects<\/strong>\u00a0y\u00a0<strong>Get Metaobject<\/strong>.<\/li>\n\n\n\n<li>Guarda.<\/li>\n<\/ol>\n\n\n\n<p><strong>Si est\u00e1s creando una nueva<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Ve a\u00a0<strong>AI Agents > Integrations and Tools<\/strong>\u00a0y haz clic en\u00a0<strong>Add Tools<\/strong>, luego en\u00a0<strong>Create Integration<\/strong>\u00a0y despu\u00e9s en\u00a0<strong>Shopify<\/strong>.<\/li>\n\n\n\n<li>Elige\u00a0<strong>Dev Dashboard (Recommended)<\/strong>\u00a0e introduce un nombre, una descripci\u00f3n, el nombre de tu tienda, el Storefront Access Token, el Client ID y el Client Secret. Si se trata de una app m\u00e1s antigua, elige\u00a0<strong>Admin API Token (Legacy)<\/strong>.<\/li>\n\n\n\n<li>Haz clic en\u00a0<strong>Add Integration<\/strong>. Aparece la lista de opciones.<\/li>\n\n\n\n<li>Activa las tres opciones de metaobject, m\u00e1s las dem\u00e1s que uses, y haz clic en\u00a0<strong>Create<\/strong>.<\/li>\n\n\n\n<li>Abre tu agente, ve a su pesta\u00f1a\u00a0<strong>Tools<\/strong>, haz clic en\u00a0<strong>Add Tools<\/strong>\u00a0y selecciona la integraci\u00f3n.<\/li>\n<\/ol>\n\n\n\n<p>El formulario de integraci\u00f3n de Shopify en Spoki, con los dos m\u00e9todos de conexi\u00f3n en la parte superior:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"987\" src=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-13-1024x987.jpeg\" alt=\"\" class=\"wp-image-13835\" srcset=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-13-1024x987.jpeg 1024w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-13-300x289.jpeg 300w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-13-768x740.jpeg 768w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-13.jpeg 1120w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Las tres opciones de metaobject est\u00e1n al final de la lista de opciones de Shopify. Cuando la app tiene todos los permisos, se pueden activar todas las opciones:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"885\" height=\"1024\" src=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-15-885x1024.jpeg\" alt=\"\" class=\"wp-image-13846\" srcset=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-15-885x1024.jpeg 885w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-15-259x300.jpeg 259w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-15-768x889.jpeg 768w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-15.jpeg 974w\" sizes=\"(max-width: 885px) 100vw, 885px\" \/><\/figure>\n\n\n\n<p><strong>Indica al agente d\u00f3nde buscar<\/strong><\/p>\n\n\n\n<p>A\u00f1ade al prompt del agente una frase como esta, adaptada a tu tienda:<\/p>\n\n\n\n<p>Los colores, las im\u00e1genes, los precios y la disponibilidad dependen del pa\u00eds del cliente y est\u00e1n guardados en los metaobjects de Shopify de la tienda, no en los productos. Cons\u00faltalos siempre con las herramientas de metaobject antes de responder, y no inventes nunca la informaci\u00f3n.<\/p>\n\n\n\n<p>Sin esta frase, el agente podr\u00eda responder bas\u00e1ndose solo en el producto.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Comprueba que funciona<\/h2>\n\n\n\n<p>Abre el <strong>Playground<\/strong> del agente y formula una pregunta cuya respuesta dependa de un metaobject, por ejemplo \u00ab\u00bfEn qu\u00e9 colores est\u00e1 disponible el sof\u00e1 Lario para Francia?\u00bb. El agente deber\u00eda responder solo con las entradas de ese pa\u00eds.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"944\" src=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-14-1024x944.jpeg\" alt=\"\" class=\"wp-image-13843\" srcset=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-14-1024x944.jpeg 1024w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-14-300x277.jpeg 300w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-14-768x708.jpeg 768w, https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-14.jpeg 1120w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>En nuestra tienda de prueba de staging, el agente respondi\u00f3 correctamente a estas cinco preguntas:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Pregunta<\/th><th>Respuesta del agente<\/th><\/tr><\/thead><tbody><tr><td>\u00bfEn qu\u00e9 colores est\u00e1 disponible el sof\u00e1 Lario para Francia?<\/td><td>Solo Grigio perla, 1.540 EUR<\/td><\/tr><tr><td>\u00bfEn qu\u00e9 colores est\u00e1 disponible el sof\u00e1 Lario para Italia?<\/td><td>Sabbia, Grigio perla, Blu notte<\/td><\/tr><tr><td>\u00bfSe vende el sof\u00e1 Taormina en Espa\u00f1a?<\/td><td>No, solo en Italia<\/td><\/tr><tr><td>\u00bfSe vende el sof\u00e1 Dolomiti en Espa\u00f1a?<\/td><td>No, solo en Italia y Francia<\/td><\/tr><tr><td>\u00bfEst\u00e1 disponible el sof\u00e1 Siena en Terracotta en Italia?<\/td><td>No, en Italia solo Cuoio naturale<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>Si algo no funciona<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Qu\u00e9 ves<\/th><th>Qu\u00e9 debes comprobar<\/th><\/tr><\/thead><tbody><tr><td>\u00abMissing required permissions\u00bb en las tres opciones<\/td><td>Falta uno de los cuatro scopes, o la tienda no ha aprobado la actualizaci\u00f3n de la app. Corr\u00edgelo y luego vuelve a guardar la integraci\u00f3n<\/td><\/tr><tr><td>Las opciones no est\u00e1n en la lista<\/td><td>Vuelve a guardar las credenciales de la integraci\u00f3n<\/td><\/tr><tr><td>El agente no encuentra un tipo de metaobject<\/td><td>El acceso al storefront est\u00e1 desactivado para esa definici\u00f3n en Shopify<\/td><\/tr><tr><td>El agente no encuentra una entrada<\/td><td>La entrada est\u00e1 en Draft, o su nombre no contiene las palabras de la pregunta<\/td><\/tr><tr><td>El agente ignora los metaobjects<\/td><td>A\u00f1ade la frase del prompt indicada arriba<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>Mensaje de lanzamiento externo (clientes) Asunto: Tu agente de IA ya puede leer los metaobjects de Shopify Tu agente de [&hellip;]<\/p>\n","protected":false},"author":21,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[46],"doc_tag":[],"class_list":["post-13804","docs","type-docs","status-publish","hentry","doc_category-como"],"year_month":"2026-11","word_count":2283,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Daniele Intermite","author_nicename":"daniele-intermite","author_url":"https:\/\/support.spoki.com\/es\/author\/daniele-intermite\/"},"doc_category_info":[{"term_name":"C\u00f3mo","term_url":"https:\/\/support.spoki.com\/es\/docs-category\/como\/"}],"doc_tag_info":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v26.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Metaobjects de Shopify para el agente de IA: mensajes de lanzamiento y gu\u00eda de configuraci\u00f3n - Supporto Spoki<\/title>\n<meta name=\"description\" content=\"Mensaje de lanzamiento externo (clientes) Asunto: Tu agente de IA ya puede leer los metaobjects de Shopify Tu agente de IA de Spoki ya puede responder con\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/\" \/>\n<meta property=\"og:locale\" content=\"es_ES\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Metaobjects de Shopify para el agente de IA: mensajes de lanzamiento y gu\u00eda de configuraci\u00f3n - Supporto Spoki\" \/>\n<meta property=\"og:description\" content=\"Mensaje de lanzamiento externo (clientes) Asunto: Tu agente de IA ya puede leer los metaobjects de Shopify Tu agente de IA de Spoki ya puede responder con\" \/>\n<meta property=\"og:url\" content=\"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/\" \/>\n<meta property=\"og:site_name\" content=\"Supporto Spoki\" \/>\n<meta property=\"article:modified_time\" content=\"2026-11-12T15:31:05+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11.jpeg\" \/>\n\t<meta property=\"og:image:width\" content=\"1088\" \/>\n\t<meta property=\"og:image:height\" content=\"600\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Tiempo de lectura\" \/>\n\t<meta name=\"twitter:data1\" content=\"13 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/\",\"url\":\"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/\",\"name\":\"Metaobjects de Shopify para el agente de IA: mensajes de lanzamiento y gu\u00eda de configuraci\u00f3n - Supporto Spoki\",\"isPartOf\":{\"@id\":\"https:\/\/support.spoki.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11-1024x565.jpeg\",\"datePublished\":\"2026-11-12T15:23:04+00:00\",\"dateModified\":\"2026-11-12T15:31:05+00:00\",\"description\":\"Mensaje de lanzamiento externo (clientes) Asunto: Tu agente de IA ya puede leer los metaobjects de Shopify Tu agente de IA de Spoki ya puede responder con\",\"breadcrumb\":{\"@id\":\"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/#breadcrumb\"},\"inLanguage\":\"es\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"es\",\"@id\":\"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/#primaryimage\",\"url\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11-1024x565.jpeg\",\"contentUrl\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11-1024x565.jpeg\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/support.spoki.com\/es\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Docs\",\"item\":\"https:\/\/support.spoki.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Metaobjects de Shopify para el agente de IA: mensajes de lanzamiento y gu\u00eda de configuraci\u00f3n\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/support.spoki.com\/#website\",\"url\":\"https:\/\/support.spoki.com\/\",\"name\":\"Supporto Spoki\",\"description\":\"Documentation for Spoki use\",\"publisher\":{\"@id\":\"https:\/\/support.spoki.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/support.spoki.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"es\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/support.spoki.com\/#organization\",\"name\":\"Supporto Spoki\",\"url\":\"https:\/\/support.spoki.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"es\",\"@id\":\"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg\",\"contentUrl\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg\",\"width\":2560,\"height\":761,\"caption\":\"Supporto Spoki\"},\"image\":{\"@id\":\"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.linkedin.com\/company\/spokiapp\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Metaobjects de Shopify para el agente de IA: mensajes de lanzamiento y gu\u00eda de configuraci\u00f3n - Supporto Spoki","description":"Mensaje de lanzamiento externo (clientes) Asunto: Tu agente de IA ya puede leer los metaobjects de Shopify Tu agente de IA de Spoki ya puede responder con","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/","og_locale":"es_ES","og_type":"article","og_title":"Metaobjects de Shopify para el agente de IA: mensajes de lanzamiento y gu\u00eda de configuraci\u00f3n - Supporto Spoki","og_description":"Mensaje de lanzamiento externo (clientes) Asunto: Tu agente de IA ya puede leer los metaobjects de Shopify Tu agente de IA de Spoki ya puede responder con","og_url":"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/","og_site_name":"Supporto Spoki","article_modified_time":"2026-11-12T15:31:05+00:00","og_image":[{"width":1088,"height":600,"url":"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11.jpeg","type":"image\/jpeg"}],"twitter_card":"summary_large_image","twitter_misc":{"Tiempo de lectura":"13 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/","url":"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/","name":"Metaobjects de Shopify para el agente de IA: mensajes de lanzamiento y gu\u00eda de configuraci\u00f3n - Supporto Spoki","isPartOf":{"@id":"https:\/\/support.spoki.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/#primaryimage"},"image":{"@id":"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/#primaryimage"},"thumbnailUrl":"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11-1024x565.jpeg","datePublished":"2026-11-12T15:23:04+00:00","dateModified":"2026-11-12T15:31:05+00:00","description":"Mensaje de lanzamiento externo (clientes) Asunto: Tu agente de IA ya puede leer los metaobjects de Shopify Tu agente de IA de Spoki ya puede responder con","breadcrumb":{"@id":"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/#breadcrumb"},"inLanguage":"es","potentialAction":[{"@type":"ReadAction","target":["https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/"]}]},{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/#primaryimage","url":"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11-1024x565.jpeg","contentUrl":"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/11\/image-11-1024x565.jpeg"},{"@type":"BreadcrumbList","@id":"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/support.spoki.com\/es\/"},{"@type":"ListItem","position":2,"name":"Docs","item":"https:\/\/support.spoki.com\/docs\/"},{"@type":"ListItem","position":3,"name":"Metaobjects de Shopify para el agente de IA: mensajes de lanzamiento y gu\u00eda de configuraci\u00f3n"}]},{"@type":"WebSite","@id":"https:\/\/support.spoki.com\/#website","url":"https:\/\/support.spoki.com\/","name":"Supporto Spoki","description":"Documentation for Spoki use","publisher":{"@id":"https:\/\/support.spoki.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/support.spoki.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"es"},{"@type":"Organization","@id":"https:\/\/support.spoki.com\/#organization","name":"Supporto Spoki","url":"https:\/\/support.spoki.com\/","logo":{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/","url":"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg","contentUrl":"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg","width":2560,"height":761,"caption":"Supporto Spoki"},"image":{"@id":"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.linkedin.com\/company\/spokiapp\/"]}]}},"spoki_translations":{"trid":5952,"translations":{"en":{"id":13778,"url":"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/","status":"publish","original":true},"it":{"id":13803,"url":"https:\/\/support.spoki.com\/docs\/how-to\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/","status":"publish","original":false},"es":{"id":13804,"url":"https:\/\/support.spoki.com\/es\/docs\/como\/shopify-metaobjects-for-the-ai-agent-release-messages-and-setup-guide\/","status":"publish","original":false}}},"_links":{"self":[{"href":"https:\/\/support.spoki.com\/es\/wp-json\/wp\/v2\/docs\/13804","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/support.spoki.com\/es\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/support.spoki.com\/es\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/support.spoki.com\/es\/wp-json\/wp\/v2\/users\/21"}],"replies":[{"embeddable":true,"href":"https:\/\/support.spoki.com\/es\/wp-json\/wp\/v2\/comments?post=13804"}],"version-history":[{"count":7,"href":"https:\/\/support.spoki.com\/es\/wp-json\/wp\/v2\/docs\/13804\/revisions"}],"predecessor-version":[{"id":13856,"href":"https:\/\/support.spoki.com\/es\/wp-json\/wp\/v2\/docs\/13804\/revisions\/13856"}],"wp:attachment":[{"href":"https:\/\/support.spoki.com\/es\/wp-json\/wp\/v2\/media?parent=13804"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/support.spoki.com\/es\/wp-json\/wp\/v2\/doc_category?post=13804"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/support.spoki.com\/es\/wp-json\/wp\/v2\/doc_tag?post=13804"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}