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
- Instale la app ChatReact desde Shopify App Store
- 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:
| Widget | Description | Placement |
|---|---|---|
| Chat Widget | AI chatbot con soporte de chat en vivo | En todo el sitio o páginas específicas mediante App Embed |
| Form Widget | Formularios de contacto con protección contra spam | En línea mediante App Block en Theme Editor |
| FAQ Widget | Visualización de FAQ en estilo acordeón | En 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
- Abra la app ChatReact en su administración de Shopify
- En la pestaña Chat Widget, haga clic en Add Assignment
- Ingrese su ID del chatbot (se encuentra en el panel de ChatReact en la pestaña Integración de su chatbot)
- Haga clic en Save Assignment
Step 2: Enable the App Embed
- Vaya a Online Store → Themes → Edit theme
- Haga clic en el icono App embeds (pieza de rompecabezas) en la barra lateral inferior izquierda
- Active ChatReact Chat Widget a ON
- 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:
- Vaya a Online Store → Themes → Edit theme
- Navegue a la página donde desea el widget
- Haga clic en Add block y busque "ChatReact"
- Elija ChatReact Form o ChatReact FAQ
- 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:
| Setting | Options |
|---|---|
| Alignment | Left, Center, Right |
| Max Width | 200–1200px |
| Font Size | 12–28px |
| Margin Bottom | 0–120px |
| Idioma | Auto-detect (default) or one of 24 languages |
FAQ Widget Styling
| Setting | Options |
|---|---|
| Categorías | Optional comma-separated category slugs (e.g. general,pricing) to show only selected FAQ categories |
| Font Size | 12–28px |
| Margin Bottom | 0–120px |
| Idioma | Auto-detect (default) or one of 24 languages |
Managing Widgets
La app ChatReact en su administración de Shopify ofrece tres pestañas:
- Chat Widget — Cree y administre las asignaciones de widget que controlan en qué páginas se muestra el chat widget
- Formularios — Instrucciones paso a paso para incrustar, el fragmento Liquid manual y dónde encontrar su Form ID
- 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.