InicioDocumentación

Shopify Integration

Agregue chatbots AI de ChatReact, formularios de contacto y acordeones de FAQ a su tienda Shopify con la aplicación oficial ChatReact para Shopify.

Installation

  1. Instale la app ChatReact desde Shopify App Store
  2. Abra la app en el panel de administración de Shopify

No se necesita una conexión de cuenta separada: vincula la app a sus chatbots y formularios pegando sus IDs desde el panel de ChatReact.

Features

La app de Shopify proporciona tres tipos de widget:

WidgetDescriptionPlacement
Chat WidgetAI chatbot con soporte de chat en vivoEn todo el sitio o páginas específicas mediante App Embed
Form WidgetFormularios de contacto con protección contra spamEn línea mediante App Block en Theme Editor
FAQ WidgetVisualización de FAQ en estilo acordeónEn línea mediante App Block en Theme Editor

Setting Up the Chat Widget

Configurar el chat widget requiere dos pasos: crear una asignación de widget en la app ChatReact y luego activar el App Embed en su tema.

Step 1: Create a Widget Assignment

  1. Abra la app ChatReact en su administración de Shopify
  2. En la pestaña Chat Widget, haga clic en Add Assignment
  3. Ingrese su ID del chatbot (se encuentra en el panel de ChatReact en la pestaña Integración de su chatbot)
  4. Haga clic en Save Assignment

Step 2: Enable the App Embed

  1. Vaya a Online Store → Themes → Edit theme
  2. Haga clic en el icono App embeds (pieza de rompecabezas) en la barra lateral inferior izquierda
  3. Active ChatReact Chat Widget a ON
  4. Haga clic en Guardar

Solo necesita activar el App Embed una vez. Después de eso, usted gestiona dónde aparece el widget completamente desde la app ChatReact.

El chat widget aparece en cada página cubierta por una de sus asignaciones de widget.

Widget Assignments

Cada asignación vincula un chatbot con su tienda. Hay dos tipos de asignación:

  • Everywhere: El widget aparece en todas las páginas (por defecto). Opcionalmente puede agregar Exclude URLs — una ruta por línea, con comodines * soportados (p. ej. /blogs/*)
  • Specific Page: El widget solo aparece en la ruta de página que indique (p. ej. /pages/about)

Si una página tiene su propia asignación Specific Page, ese chatbot se mostrará allí en lugar del chatbot de Everywhere.

Adding Form and FAQ Widgets

Los widgets de Form y FAQ se añaden como App Blocks en el Theme Editor:

  1. Vaya a Online Store → Themes → Edit theme
  2. Navegue a la página donde desea el widget
  3. Haga clic en Add block y busque "ChatReact"
  4. Elija ChatReact Form o ChatReact FAQ
  5. Ingrese el Form ID o Chatbot ID en la configuración del bloque

Manual Embed (Liquid)

Si prefiere editar las plantillas directamente, también puede agregar los widgets a cualquier plantilla Liquid:

<!-- Form widget -->
<div id="chatreact-form"></div>
<script src="https://www.chatreact.ai/embed/form.js"
  data-form-id="YOUR_FORM_ID"
  data-container="chatreact-form"
  async></script>
<!-- FAQ widget -->
<div id="chatreact-faq"></div>
<script src="https://www.chatreact.ai/embed/faq-widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-container="chatreact-faq"
  async></script>

Form Widget Styling

Personalice la apariencia del formulario en el Theme Editor:

SettingOptions
AlignmentLeft, Center, Right
Max Width200–1200px
Font Size12–28px
Margin Bottom0–120px
IdiomaAuto-detect (default) or one of 24 languages

FAQ Widget Styling

SettingOptions
CategoríasOptional comma-separated category slugs (e.g. general,pricing) to show only selected FAQ categories
Font Size12–28px
Margin Bottom0–120px
IdiomaAuto-detect (default) or one of 24 languages

Managing Widgets

La app ChatReact en su administración de Shopify ofrece tres pestañas:

  1. Chat Widget — Cree y administre las asignaciones de widget que controlan en qué páginas se muestra el chat widget
  2. Formularios — Instrucciones paso a paso para incrustar, el fragmento Liquid manual y dónde encontrar su Form ID
  3. FAQ Widget — Instrucciones de incrustación para el widget FAQ y dónde encontrar su Chatbot ID

La selección de Form y FAQ ocurre en el Theme Editor: ingrese el Form ID o Chatbot ID en la configuración del bloque.

Language Support

La app soporta los 24 idiomas de la UE:

  • El chat widget detecta automáticamente el idioma del navegador de cada visitante y lo compara con los idiomas que soporta su chatbot, retrocediendo al idioma principal del chatbot si no hay coincidencia
  • Los bloques Form y FAQ tienen cada uno su propia configuración Idioma en el Theme Editor — por defecto está en Auto-detect y puede sobrescribirse por bloque

Uninstalling

Cuando desinstale la app ChatReact, todas las configuraciones de widgets y los datos almacenados se limpian automáticamente de su tienda Shopify.


Next Steps