กลับไปที่แดชบอร์ด

เอกสาร

เรียนรู้วิธีใช้ Asyntai

ฟีเจอร์
การรวบรวมข้อมูลเว็บไซต์ ช่องว่างความรู้ การ์ดสินค้า การ์ดสินค้าแบบไดนามิก Dynamic Images บริบทผู้ใช้ การติดตามแบบเรียลไทม์ Human Takeover การยกระดับ การแจ้งเตือน AI รายงานประจำวัน ฟีดข้อมูลแบบเรียลไทม์ ฟีดข้อมูลแบบเรียลไทม์ Max สมาชิกในทีม การลงชื่อเข้าใช้ครั้งเดียว รวมรูปภาพ การมองเห็นรูปภาพ วิดเจ็ตแปลภาษา การปรับให้เข้ากับท้องถิ่น ลูกค้าเป้าหมาย การจับลูกค้าเป้าหมายอัจฉริยะ ตั๋วสนับสนุน การจอง การฝัง ยกเว้นหน้า IP ที่ถูกบล็อก โมเดลที่ฉลาดกว่า เปิดใช้งานการคิดวิเคราะห์ คำแนะนำการตอบกลับ ข้อความติดตามผล เสียงเป็นข้อความ ดาวน์โหลดบันทึกการสนทนา แชทแบบฝังตัว

วิธีเพิ่มแชทบอท AI Asyntai ลงใน CrafterCMS

คู่มือทีละขั้นตอนสำหรับเว็บไซต์ CrafterCMS

รับโค้ดฝัง

ขั้นตอนที่ 1: รับโค้ดฝังตัวของคุณ

ก่อนอื่น ไปที่แดชบอร์ด Asyntai ของคุณและเลื่อนลงไปที่ส่วน "Embed Code" คัดลอกโค้ดฝังตัวเฉพาะของคุณซึ่งจะมีลักษณะดังนี้:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

หมายเหตุ: โค้ดด้านบนเป็นเพียงตัวอย่าง คุณต้องคัดลอกโค้ดฝังตัวเฉพาะของคุณจากแดชบอร์ดเนื่องจากมี widget ID ส่วนตัวของคุณ

ขั้นตอนที่ 2: เพิ่มลงในเทมเพลต FreeMarker (แนะนำ)

CrafterCMS ใช้เทมเพลต FreeMarker (.ftl) สำหรับเรนเดอร์หน้าเว็บ วิธีที่ง่ายที่สุดในการเพิ่มแชทบอทในทุกหน้าคือการแก้ไขเทมเพลตหน้าหลักของคุณ:

  1. ใน Crafter Studio ไปที่ Site Dashboard > Content Types หรือไปที่เทมเพลต
  2. เปิดเทมเพลตหน้าหลักของคุณ (เช่น /templates/web/pages/home.ftl หรือเลย์เอาต์หลัก)
  3. ค้นหาแท็กปิด </body>
  4. วางโค้ดฝัง Asyntai ของคุณก่อนแท็ก </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. บันทึกไฟล์และเผยแพร่ผ่าน Crafter Studio

เคล็ดลับ: การเพิ่มสคริปต์ก่อนแท็กปิด </body> ช่วยให้โหลดหลังจากเนื้อหาหน้าเว็บ ซึ่งแนะนำสำหรับวิดเจ็ตแชทและจะไม่ทำให้หน้าเว็บโหลดช้าลง

วิธีทางเลือกที่ 1: การใช้ Crafter Template Components

เพื่อการจัดระเบียบที่ดีขึ้น ให้สร้างเทมเพลตคอมโพเนนต์เฉพาะสำหรับวิดเจ็ตแชทบอท:

  1. ใน Crafter Studio สร้างไฟล์เทมเพลตใหม่ที่ /templates/web/components/asyntai-widget.ftl
  2. เพิ่มเนื้อหาต่อไปนี้ลงในเทมเพลตคอมโพเนนต์:
    <!-- Asyntai AI Chatbot Component --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  3. รวมไว้ในเทมเพลตเลย์เอาต์หลักของคุณโดยใช้คำสั่ง include ของ FreeMarker:
    <#include "/templates/web/components/asyntai-widget.ftl" />
  4. หรือหากใช้ระบบเรนเดอร์คอมโพเนนต์ของ Crafter ให้ใช้:
    <@renderComponent component=contentModel.asyntaiWidget />
  5. บันทึกทั้งสองไฟล์และเผยแพร่ผ่าน Crafter Studio

หมายเหตุ: การใช้เทมเพลตคอมโพเนนต์แยกต่างหากทำให้ง่ายต่อการเปิดหรือปิดแชทบอทในเว็บไซต์ทั้งหมดของคุณโดยคอมเมนต์บรรทัด include เดียว

วิธีทางเลือกที่ 2: การใช้การตั้งค่า Head/Scripts ของ Crafter

CrafterCMS อนุญาตให้คุณแทรกสคริปต์ทั่วทั้งเว็บไซต์ผ่านการตั้งค่าเว็บไซต์:

  1. ใน Crafter Studio ไปที่ Site Config > Configuration
  2. เปิดไฟล์ Engine Site Configuration (site-config.xml)
  3. เพิ่มการตั้งค่าการแทรกสคริปต์แบบกำหนดเอง:
    <site> <!-- Existing configuration... --> <!-- Custom Scripts --> <scripts> <script> <src>https://asyntai.com/static/js/chat-widget.js</src> <async>true</async> <data-asyntai-id>YOUR_WIDGET_ID</data-asyntai-id> </script> </scripts> </site>
  4. หรือแก้ไขเลย์เอาต์ FreeMarker หลักของคุณเพื่ออ่านจากการตั้งค่าเว็บไซต์และแทรกสคริปต์แบบไดนามิก:
    <#if siteConfig.getString("scripts.script.src", "")?has_content> <script async src="${siteConfig.getString("scripts.script.src")}" data-asyntai-id="${siteConfig.getString("scripts.script.data-asyntai-id")}"></script> </#if>
  5. บันทึกและเผยแพร่การเปลี่ยนแปลงการตั้งค่า

เคล็ดลับ: การใช้การตั้งค่าเว็บไซต์ช่วยให้คุณจัดการวิดเจ็ตแชทบอทโดยไม่ต้องแก้ไขไฟล์เทมเพลตโดยตรง ทำให้ง่ายต่อการอัปเดตหรือลบในภายหลัง

วิธีทางเลือกที่ 3: การใช้ Groovy Controller

CrafterCMS รองรับสคริปต์ Groovy สำหรับลอจิกฝั่งเซิร์ฟเวอร์ คุณสามารถใช้ controller เพื่อเพิ่มสคริปต์แชทบอทแบบไดนามิก:

  1. สร้างสคริปต์ Groovy ใน /scripts/pages/ (เช่น /scripts/pages/home.groovy หรือ controller ทั่วทั้งเว็บไซต์ของคุณ)
  2. เพิ่มโค้ดต่อไปนี้เพื่อแทรก URL สคริปต์ลงในโมเดลเทมเพลต:
    // /scripts/pages/home.groovy import org.craftercms.engine.service.context.SiteContext def siteContext = SiteContext.current // Add Asyntai chatbot configuration to the model model.asyntaiEnabled = true model.asyntaiWidgetId = "YOUR_WIDGET_ID" model.asyntaiScriptSrc = "https://asyntai.com/static/js/chat-widget.js"
  3. จากนั้นอ้างอิงตัวแปรโมเดลในเทมเพลต FreeMarker ของคุณ:
    <#if model.asyntaiEnabled?? && model.asyntaiEnabled> <script async src="${model.asyntaiScriptSrc}" data-asyntai-id="${model.asyntaiWidgetId}"></script> </#if>
  4. บันทึกทั้งสคริปต์ Groovy และไฟล์เทมเพลต
  5. เผยแพร่การเปลี่ยนแปลงผ่าน Crafter Studio

หมายเหตุ: วิธี Groovy controller มีประโยชน์เมื่อคุณต้องการลอจิกแบบมีเงื่อนไข (เช่น เปิดใช้งานแชทบอทเฉพาะบทบาทผู้ใช้หรือประเภทหน้าบางอย่าง) หรือเมื่อคุณต้องการดึงค่าการตั้งค่าจากแหล่งภายนอก

ขั้นตอนที่ 3: เผยแพร่และตรวจสอบ

หลังจากทำการเปลี่ยนแปลง ให้เผยแพร่ผ่าน Crafter Studio:

  1. ใน Crafter Studio ไปที่ Site Dashboard
  2. ตรวจสอบการเปลี่ยนแปลงของคุณในส่วน My Recent Activity หรือ Pending Approval
  3. คลิก Publish เพื่อเผยแพร่การเปลี่ยนแปลงไปยังเว็บไซต์ของคุณ
  4. เยี่ยมชมเว็บไซต์ CrafterCMS ของคุณในแท็บเบราว์เซอร์ใหม่หรือหน้าต่างส่วนตัว
  5. คุณควรเห็นปุ่มวิดเจ็ตแชทที่มุมล่างขวา
  6. คลิกเพื่อให้แน่ใจว่าเปิดและทำงานได้อย่างถูกต้อง

ไม่เห็นวิดเจ็ต? ตรวจสอบให้แน่ใจว่าคุณได้เผยแพร่การเปลี่ยนแปลงผ่าน Crafter Studio ตรวจสอบว่าคุณกำลังแก้ไขไฟล์เทมเพลตที่ถูกต้องที่หน้าเว็บของคุณใช้ ล้างแคชเบราว์เซอร์หรือดูในหน้าต่างส่วนตัว หากใช้การแคชของ Crafter ให้ล้างแคช Engine จากแดชบอร์ด Crafter Studio

ตำแหน่งเทมเพลต: ตำแหน่งเทมเพลต CrafterCMS อาจแตกต่างกันขึ้นอยู่กับโครงสร้างโปรเจกต์ของคุณ ตำแหน่งทั่วไป ได้แก่ /templates/web/pages/ สำหรับเทมเพลตหน้า, /templates/web/components/ สำหรับเทมเพลตคอมโพเนนต์ และ /templates/web/ สำหรับเทมเพลตเลย์เอาต์ ตรวจสอบเทมเพลตที่มีอยู่เพื่อค้นหาว่าแท็ก </body> ถูกกำหนดไว้ที่ใด