Widgeti manustamine
Lisage oma AI chatbot igale veebisaidile sekunditega meie lihtsa embed code'i abil.
Kiire alustamine
Lisage see kood enne </body> sulgemistähist:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
See ongi kõik! Teie chatbot on nüüd teie veebisaidil aktiivne.
Kuidas leida oma chatboti ID
- Minge oma chatboti sätetesse
- Minge Embed vahekaardile
- Kopeerige embed-kood (sisaldab teie ID-d)
Or find the ID in your dashboard URL:
/dashboard/company/chatbots/[CHATBOT_ID]
Widget Options
Kohandage widgetit andmeatribuutidega:
Põhilised valikud
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-position="bottom-right"
data-language="en"
async
></script>
| Atribuut | Väärtused | Vaikeväärtus |
|---|---|---|
data-position | bottom-right, bottom-left, inline | bottom-right |
data-language | Suvaline keelekood | Automaatselt tuvastatud |
data-open | true, false | false |
Kasutage data-position="inline", et manustada vestlusvidin otse lehele kohta, kuhu skript on paigutatud. Widget on alati avatud, ilma mulli ja sulgemisnuputa – ideaalne spetsiaalsete vestluslehekülgede või tugijaotiste jaoks.
Värvide ülekirjutamine
Ülekirjuta armatuurlaua seaded inline-värvidega:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-primary-color="#8B5CF6"
data-background-color="#0F172A"
data-text-color="#F1F5F9"
data-border-radius="24"
async
></script>
FAQ Widget
Kuva FAQ-id akordionina mis tahes lehel:
<div id="chatreact-faq"></div>
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-primary-color="#8B5CF6"
data-background-color="#0F172A"
data-text-color="#F1F5F9"
data-border-radius="24"
async
></script>
FAQ vidin kuvab teie chatbot'i avaldatud FAQ-sid.
FAQ Widget valikud
| Seade | Kirjeldus | Kust konfigureerida |
|---|---|---|
| Width | Valige 100% (kogu laius) või kohandatud pikslite laius (400–1200px) | Dashboard → FAQs → Settings |
| Sort Order | Kuvamisjärjestus: Date (uusim esmalt), Name (tähestikuline) või Custom (manuaalne lohistamine) | Dashboard → FAQs → Settings → Behavior |
| Category Filter | Kuvage ainult konkreetsed kategooriad vidinas | Embed-koodi data-categories atribuut |
Category Filter näide
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Mobiilne optimeerimine
Vestlusvidin on täielikult optimeeritud mobiilseadmete jaoks:
- Täislaiuses paigutus väikestel ekraanidel
- Ülespoole libisev animatsioon avamisel
- iOS klaviatuuri käsitlemine (vidin kohandub ekraaniklaviatuuriga)
- Safe-area tugi iPhone'i sälgu ja kodunäidiku jaoks
- Suuremad puutealad parema kasutatavuse jaoks
- Sisestusvälja fondisuurus hoiab ära iOS automaatse suurendamise
Platvormispetsiifilised juhised
WordPress
Soovitatav: Kasutage ametlikku ChatReact WordPress pistikprogrammi lihtsaimaks integratsiooniks Gutenbergi plokkide, Elementori vidinite ja lühikoodidega.
Alternatiiv: Manuaalne manustamine "Header/Footer Scripts" pistikprogrammi kaudu:
- Installige mõni "Header/Footer Scripts" plugin
- Lisage embed-kood footeri sektsiooni
- Salvesta ja avalda
Shopify
Soovitatav: ChatReact Shopify App
Installige ChatReact rakendus Shopify App Store'ist lihtsaimaks integratsiooniks:
- Installige ChatReact rakendus oma Shopify halduspaneelis
- Sisestage oma Chatbot ID rakenduse seadetesse
- Vestlusvidin ilmub automaatselt teie poe esikusele
- Hallake vidina määramisi leheküljeti või lubage see kõikjal
Rakendus toetab ka Form ja FAQ vidinaid App Blocks'idena Theme Editoris.
Alternatiiv: Manuaalne manustamine
- Minge Online Store → Themes → Edit Code
- Avage
theme.liquid - Lisage kood enne
</body> - Salvesta
Webflow
- Minge Project Settings → Custom Code
- Lisage Footer Code'i
- Avaldage sait
Next.js / React
Kasutage Script komponenti:
import Script from 'next/script';
export default function Layout({ children }) {
return (
<>
{children}
<Script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
strategy="lazyOnload"
/>
</>
);
}
Vue.js
Lisage see oma põhifaili App.vue või layout'i:
<script setup>
import { onMounted } from 'vue';
onMounted(() => {
const script = document.createElement('script');
script.src = 'https://www.chatreact.ai/embed/widget.js';
script.dataset.chatbotId = 'YOUR_CHATBOT_ID';
script.async = true;
document.body.appendChild(script);
});
</script>
JavaScript API
Suhelge vidinaga programmiliselt:
// Open the chat
ChatReact.open();
// Close the chat
ChatReact.close();
// Toggle open/closed
ChatReact.toggle();
// Send a message
ChatReact.sendMessage('Hello!');
// Set user data
ChatReact.setUser({
name: 'John Doe',
email: '[email protected]'
});
Testing
Preview Mode
Before embedding live:
- Use the Preview feature in your dashboard
- Test different scenarios
- Verify responses are accurate
Local Development
For local testing, use localhost URLs:
<script
src="http://localhost:3000/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Troubleshooting
Widget Not Appearing
- Check browser console for errors
- Verify chatbot ID is correct
- Ensure chatbot is active (not disabled)
- Check if ad blockers are interfering
Styling Conflicts
If your site's CSS conflicts:
- Widget uses shadow DOM for isolation
- Check z-index values
- Ensure no
!importantoverrides
Performance
The widget is designed for minimal impact:
- Lazy loaded
- < 50KB total size
- Non-blocking
- Cached aggressively