InícioDocumentação

Integração com Shopify

Adicione chatbots AI do ChatReact, formulários de contato e acordéons de FAQ à sua loja Shopify com o aplicativo oficial ChatReact para Shopify.

Instalação

  1. Instale o aplicativo ChatReact na Shopify App Store
  2. Abra o aplicativo no painel de administração da sua loja Shopify

Não é necessária uma conexão de conta separada — você vincula o aplicativo aos seus chatbots e formulários colando seus IDs a partir do painel do ChatReact.

Recursos

O aplicativo para Shopify fornece três tipos de widget:

WidgetDescriçãoLocalização
Chat WidgetChatbot AI com suporte de chat ao vivoEm todo o site ou em páginas específicas via App Embed
Form WidgetFormulários de contato com proteção contra spamInline via App Block no Theme Editor
FAQ WidgetExibição de FAQ em estilo acordeãoInline via App Block no Theme Editor

Configurando o Chat Widget

Configurar o chat widget leva duas etapas: criar uma atribuição de widget no app ChatReact e, em seguida, ativar o App Embed no seu tema.

Etapa 1: Criar uma Atribuição de Widget

  1. Abra o aplicativo ChatReact no seu admin do Shopify
  2. Na aba Chat Widget, clique em Add Assignment
  3. Insira seu ID do chatbot (encontrado no painel do ChatReact na aba Incorporar do seu chatbot)
  4. Clique em Save Assignment

Etapa 2: Ativar o App Embed

  1. Vá para Online Store → Themes → Edit theme
  2. Clique no ícone App embeds (peça de quebra-cabeça) na barra lateral inferior esquerda
  3. Ative ChatReact Chat Widget para ON
  4. Clique Save

Você só precisa ativar o App Embed uma vez. Depois disso, você gerencia totalmente onde o widget aparece a partir do app ChatReact.

O chat widget aparece em toda página coberta por uma das suas atribuições de widget.

Atribuições de Widget

Cada atribuição vincula um chatbot à sua vitrine. Existem dois tipos de atribuição:

  • Everywhere: O widget aparece em todas as páginas (padrão). Você pode opcionalmente adicionar Exclude URLs — um caminho por linha, com curingas * suportados (por exemplo /blogs/*)
  • Specific Page: O widget aparece somente no caminho de página que você inserir (por exemplo /pages/about)

Se uma página tiver sua própria atribuição Specific Page, esse chatbot será exibido lá em vez do chatbot Everywhere.

Adicionando Form e FAQ Widgets

Os widgets Form e FAQ são adicionados como App Blocks no Theme Editor:

  1. Vá para Online Store → Themes → Edit theme
  2. Navegue até a página onde deseja o widget
  3. Clique em Add block e pesquise por "ChatReact"
  4. Escolha ChatReact Form ou ChatReact FAQ
  5. Insira o Form ID ou o Chatbot ID nas configurações do bloco

Incorporação Manual (Liquid)

Se preferir editar os templates diretamente, você também pode adicionar os widgets a qualquer template 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>

Estilização do Form Widget

Customize a aparência do formulário no Theme Editor:

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

Estilização do FAQ Widget

SettingOptions
CategoriasOptional 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

Gerenciando Widgets

O app ChatReact no seu admin do Shopify fornece três abas:

  1. Chat Widget — Crie e gerencie as atribuições de widget que controlam quais páginas exibem o chat widget
  2. Formulários — Instruções passo a passo de incorporação, o snippet manual em Liquid e onde encontrar seu Form ID
  3. FAQ Widget — Instruções de incorporação para o widget de FAQ e onde encontrar seu Chatbot ID

A seleção de Form e FAQ é feita no Theme Editor: insira o Form ID ou o Chatbot ID nas configurações do bloco.

Suporte de Idioma

O aplicativo suporta todos os 24 idiomas da UE:

  • O chat widget detecta automaticamente o idioma do navegador de cada visitante e o compara com os idiomas suportados pelo seu chatbot, revertendo para o idioma principal do chatbot quando necessário
  • Os blocos Form e FAQ têm cada um sua própria configuração Idioma no Theme Editor — ela é padrão para Auto-detect e pode ser substituída por bloco

Desinstalação

Quando você desinstala o aplicativo ChatReact, todas as configurações de widget e dados armazenados são automaticamente limpos da sua loja Shopify.


Próximos Passos