Conectar Shopify

Qué hace

Se instala en tu tienda Shopify y envía lo que la tienda sabe a una base de conocimiento. El asistente responde desde ahí y cita el producto o la página que usó.

Solo lee. Nada en esta app escribe en tu tienda.

Qué lee

Solo productos que estén a la venta. Un producto en Borrador, No listado o Archivado nunca se envía, y si uno que ya estaba sincronizado pasa a cualquiera de esos estados, se elimina de la base de conocimiento en vez de quedarse ahí. Lo mismo vale para una página que despublicas y una colección a la que le borras la descripción. Cualquier cosa que el asistente pudiera seguir ofreciendo después de que la diste de baja, la ofrecería al precio de ayer, para siempre.

Productos a la venta que no están en tu tienda online. Shopify tiene dos interruptores distintos: uno dice que un producto se puede vender, el otro dice que aparece en tu escaparate. Un producto con solo el primero activado es real y no tiene página, así que el enlace que el asistente le daría a quien compra no lleva a ninguna parte. Esos se dejan fuera.

Si tu tienda tiene alguno, la app te lo pregunta una vez, en su propia pantalla, y solo entonces. Responde "incluirlos" si vendes esos productos por otra vía -- mayorista, en persona, en un marketplace -- y aun así quieres que el asistente responda sobre ellos. Los describirá sin un enlace que funcione. Incluirlos nunca incluye un producto en Borrador: no estar en el escaparate y no estar terminado son cosas distintas.

No lee clientes ni pedidos. La app pide productos y contenido y nada más, así que quién compró qué nunca llega hasta nosotros.

Qué recibe quien compra

Un producto citado se muestra como producto, no como nota al pie: su foto, su nombre y un botón que lo abre en tu tienda. Funciona en todas las superficies -- el panel de chat, el buscador, la página completa -- y en tu propio Playground, así juzgas una respuesta como la verá una visita.

Tienen alguna tabla por menos de 700? La Hydrogen Snowboard cuesta 600.00 USD y hay stock. Viene en un solo tamaño y está en la colección Winter. (con la foto del producto y un enlace) Envían a Irlanda? Cuánto cuesta? Sí. El envío internacional cuesta 30.00 USD, y es gratis en pedidos de 20 kilogramos o más.

La segunda vale la pena mirarla: las tarifas de envío y sus condiciones se leen de tus perfiles de entrega, así que "¿sale gratis?" tiene respuesta antes que el carrito.

Conectarla

1. Instala la app en tu tienda.
2. Elige un plan. La app abre la propia página de planes de Shopify en tu panel. Todos los planes empiezan con una prueba gratis y se cobran en tu factura de Shopify: mira [Planes y facturación](#planes-y-facturacion). Hasta que eliges uno, la app muestra esa página y nada más.
3. Pega tu User ID y una clave de API. Los dos están en tu espacio, en Claves de API: el User ID arriba de esa página, y una clave que creas ahí con el permiso ingest:write. Se verifican antes de guardar nada, así que un valor equivocado falla enseguida. ¿Todavía no tienes cuenta? El enlace I do not have an account yet de la app crea una, ya facturada a través de Shopify.

Los dos tienen que ir juntos: una clave se empareja con el ID del miembro que la creó, que se muestra al lado de la clave en la lista y otra vez en el momento de crearla. Si entraste al espacio de trabajo, el ID de arriba de la página es el tuyo y una clave que crees ahí le corresponde.

1. Elige una base de conocimiento. Si tu espacio todavía no tiene ninguna, créala primero: la app te lo dice en vez de fallar más tarde.

La primera sincronización arranca sola al conectar. Para el resto hay un botón Sync now.

Cambiar la clave, o comprobar que sigue funcionando

Las dos cosas están en la tarjeta Connected de la app, y ninguna te obliga a desconectar antes:

• Re-check the saved key le pregunta a WelcomeAI si la clave guardada sigue funcionando, sigue siendo del User ID que diste y todavía puede escribir en la base de conocimiento que usa esta tienda. No guarda nada; te dice cuál de las tres cosas falla, si alguna falla.
• Change credentials abre los mismos dos campos que rellenaste al conectar. Los valores nuevos se verifican antes de guardar nada, así que los viejos siguen ahí hasta que los nuevos pasen. Elegir otra base de conocimiento no mueve lo ya sincronizado: esos documentos se quedan en la anterior hasta que desconectes.

Desinstalar, y volver

Desinstalar la app en Shopify borra todo lo que le diste: tu User ID, tu clave de API y la base de conocimiento. Si la instalas otra vez, te los vuelve a pedir. Tus datos de Shopify no se tocan, y los documentos que ya estaban en tu base de conocimiento siguen ahí.

La tienda en Fuentes conectadas

Una tienda conectada aparece como fuente en la pestaña Fuentes de la base de conocimiento, junto a un rastreo o un sitio WordPress. Pausa esa fuente para dejar de aceptar lo que envía la tienda sin desinstalar nada; bórrala para desvincular los documentos que escribió. Sus Ajustes solo tienen una dirección del sitio, y una tienda de Shopify nunca la necesita: la app envía cada producto con su dirección completa puesta.

Planes y facturación

La app se paga en tu factura de Shopify, nunca con una tarjeta aparte con nosotros. Shopify aloja la página donde se elige el plan, cobra el cargo junto con el resto de tu factura y se ocupa de las pruebas, el prorrateo y los reembolsos.

• Los mismos planes y precios que en welcomeai.dev: Starter, Pro y Business, mensual o anual, como figuran en nuestra página de precios. Cada uno empieza con 14 días de prueba gratis; Shopify lleva la cuenta de los días de prueba que usó cada tienda, así que reinstalar no empieza una nueva.
• Cambiar de plan. Abre la pestaña Plan and usage de la app y elige Change plan: abre la misma página de Shopify, donde subir o bajar es un clic y Shopify lo prorratea. El cambio llega a tu espacio en cuanto vuelves a la app, y en menos de una hora si no vuelves.
• Qué cubre el plan. El espacio al que se conecta tu tienda toma ese plan: sus límites, sus medidores de uso y sus funciones son exactamente los que el plan tiene en welcomeai.dev. Su página de Facturación dice que se factura a través de Shopify y enlaza a la página de planes en vez de ofrecer un pago.
• ¿Ya nos pagas directamente? Conectar una tienda pasa el espacio a tu factura de Shopify, y la suscripción que tenías con nosotros deja de renovarse al final del periodo que ya pagaste. No se cobra nada dos veces y no se pierde nada pagado.
• Trae tu propia clave todavía no está disponible en los planes facturados a través de Shopify.
• Dos tiendas, un espacio. Cada tienda elige su propio plan. El espacio toma el mayor de los dos, y una tienda sin plan no se sincroniza.
• Cuando un plan termina (cancelado, o pausado por Shopify porque la factura de la propia tienda está impaga) la tienda deja de sincronizarse y el chat deja de responder hasta que haya un plan activo otra vez. Todo lo que ya está en la base de conocimiento se queda donde está.

Desinstalar la app termina el plan, como hace Shopify con cualquier app. El espacio sigue siendo tuyo: pasa a solo lectura, y puedes seguir usándolo eligiendo un plan en su página de Facturación en WelcomeAI.

Pon el chat en tu escaparate

Sincronizar mete tu tienda en una base de conocimiento. No pone el chat en tu sitio: eso es un segundo paso, a propósito, y es un interruptor en vez de un fragmento de código:

La app te muestra la clave y un botón que abre tu editor de temas con el interruptor ya localizado. Si prefieres hacerlo a mano: Tienda online > Temas > Personalizar > Incrustaciones de aplicaciones, activa WelcomeAI chat y pega la clave. Empieza por wg_.

Al ser una incrustación de app y no código pegado, desinstalar la app se lleva el chat con ella. No queda nada en tu tema.

Todos los tipos de widget entran sin código

La incrustación puede pasar una clave y nada más, así que lleva los dos tipos que se colocan solos. Los otros cuatro entran como un bloque de app: un bloque WelcomeAI widget que añades a la sección que quieras en el editor de temas.

La pestaña Install de cada widget dice cuál de las dos vías te toca, abre el editor de temas con el bloque ya añadiéndose y te muestra la clave que hay que pegar en él. Lo mismo está en la pestaña Settings de la app, en Put the chat on your storefront.

Los dos le pertenecen a la app: desinstalarla se lleva el chat, la incrustación y cada bloque, y tu tema vuelve a estar exactamente como estaba. Nunca pegas código en un tema.

Mantenerlo al día

Productos y colecciones se resincronizan cuando Shopify avisa que cambiaron, en segundos.

Páginas, artículos, políticas y tarifas de envío no: Shopify no publica ningún webhook para ellos. Se actualizan cuando pulsas Sync now. Si acabas de reescribir tu política de devoluciones, púlsalo.

Preguntas

¿Por qué se factura a través de Shopify? Las apps de la Shopify App Store cobran a través de Shopify, y así todo lo de tu tienda está en una sola factura: Shopify la cobra junto con tus otras apps, la muestra en tu panel y se ocupa de los reembolsos y los pagos fallidos.

Ya le pago a WelcomeAI con tarjeta. ¿Pago dos veces? No. Cuando tu tienda se conecta, el espacio pasa a tu factura de Shopify y la suscripción con tarjeta deja de renovarse al final del periodo que ya pagaste.

¿Ralentiza mi tienda? La sincronización lee por la API de Shopify desde nuestros servidores y no toca tu escaparate. El chat es un script de 565 bytes que carga en async, así que no puede retrasar el pintado de una página, y no se carga nada más hasta que alguien lo abre.

¿Qué pasa con un producto que despublico? Se elimina de la base de conocimiento en la siguiente sincronización, que un cambio de producto dispara en segundos. Las respuestas cacheadas de esa base se descartan al mismo tiempo, así nadie recibe un precio viejo un minuto después.

¿Puedo elegir qué se sincroniza? Todavía no. La tienda entera va a la base que elijas, y después puedes borrar documentos desde la base.

Dice que el ID de usuario no pertenece a este espacio de trabajo. El ID y la clave tienen que salir del mismo espacio, y el ID tiene que ser miembro de él. Lo habitual es un ID copiado estando en otro lado. Abre Claves de API dentro del espacio al que pertenece la clave y saca los dos valores de ahí.

Dice que la clave fue emitida para otro miembro. La clave es real, pero la creó otra persona. Usa el ID que aparece al lado de esa clave, o crea tu propia clave y usa el par que te da.

Dice que la base no es una en la que esta clave pueda escribir. La clave está limitada a una sola base y elegiste otra. Crea una clave sin límite, o elige la base a la que pertenece.