ฝังวิดเจ็ตในเว็บไซต์ของคุณ

คุณสามารถใส่ผลิตภัณฑ์ลงในเว็บไซต์ของคุณเองด้วยแท็ก <script> มีวิดเจ็ตสองตัว และตัวไหนที่คุณต้องการขึ้นอยู่กับว่าผู้เยี่ยมชมควรมีการสนทนาหรือทำสิ่งเฉพาะเจาะจงหนึ่งอย่าง

	Chat widget	Workflow widget
สิ่งที่ผู้เยี่ยมชมได้รับ	การสนทนากับผู้ช่วย	การทำงานหนึ่งการทำงาน โดยมีข้อมูลเข้า
ฟอร์มโต้ตอบ	ใช่	ไม่ — แสดงผลลัพธ์เท่านั้น
สคริปต์	chat-widget.js	workflow-widget.js

ทั้งสองตัวเป็นอิสระ: ไม่มีเฟรมเวิร์กในหน้าเว็บของคุณ ไม่มีสไตล์ชีตให้รวม และไม่มีสิ่งที่ต้องสร้างขึ้น

เพิ่ม chat widget

<script src="https://app.example.com/chat-widget.js"></script>
<script>
  sapajaChat('init', {
    templateId: 'your-template-id',
    token: 'your-embed-token',
  });
</script>

คุณจะได้รับ template id และ token จาก workspace ที่เป็นเจ้าของเทมเพลตแชท token คือสิ่งที่อนุญาตให้วิดเจ็ตทำงาน และมันจะเชื่อมโยงกับรายการของไซต์ที่สามารถใช้งานได้ — token ที่ใช้จากโดเมนที่ไม่มีในรายการนั้นจะถูกปฏิเสธ ดังนั้น token ที่ถูกคัดลอกจึงไม่สามารถทำงานได้ที่อื่น

สิ่งที่ผู้เยี่ยมชมเห็น

คำตอบไม่ใช่ข้อความธรรมดา วิดเจ็ตสามารถแสดงพื้นผิวที่หลากหลายเหมือนกับการแชทในแอป — การ์ด, ตาราง, สถิติ, ป้าย, แผนภูมิและภาพ — ดังนั้นผลลัพธ์จึงปรากฏในรูปแบบที่อ่านได้มากกว่าที่เป็นบล็อก JSON

chat widget ยังสามารถแสดง ฟอร์มจริง เมื่อผู้ช่วยต้องการรายละเอียดก่อนที่จะทำสิ่งใด ผู้เยี่ยมชมจะได้รับฟิลด์ที่มีการทำเครื่องหมายและปุ่มส่ง แทนที่จะถูกขอให้พิมพ์ค่าลงในประโยค พฤติกรรมบางอย่างที่ควรรู้:

• การส่งที่ไม่สมบูรณ์จะกลับมาเป็นฟอร์มที่ถูกแก้ไข โดยมีฟิลด์ที่ขาดหายไปถูกทำเครื่องหมาย แทนที่จะเป็นข้อผิดพลาด
• หากการส่งไม่สามารถไปถึงเราได้ ฟอร์มจะยังคงแก้ไขได้และเสนอให้ลองใหม่ — ไม่มีการรายงานความสำเร็จที่ผิดพลาด
• ฟอร์มที่ส่งแล้วจะแสดงอยู่แต่จะถูกแช่แข็ง ทำเครื่องหมายว่าได้ส่งแล้ว เพื่อให้ผู้เยี่ยมชมสามารถดูสิ่งที่พวกเขาได้ส่งไป

workflow widget แสดงผลลัพธ์แต่ไม่มีฟอร์ม มันรวบรวมสิ่งที่ต้องการล่วงหน้า

ภาษาของผู้เยี่ยมชม

วิดเจ็ตจะพูดภาษาของผู้เยี่ยมชม ไม่ใช่ของคุณ มันจะระบุว่าควรใช้ภาษานี้ในลำดับนี้: ภาษาที่คุณตั้งค่า, จากนั้นเบราว์เซอร์ของผู้เยี่ยมชม, แล้วก็ภาษาอังกฤษ

sapajaChat('init', { templateId: '…', token: '…', locale: 'fr' });

ภาษาที่รองรับ: en, fr, es, th, zh และ zh-HK แท็กเบราว์เซอร์ปกติก็ใช้ได้ — fr-CA จะกลายเป็นภาษาฝรั่งเศส, zh-TW จะกลายเป็นภาษาจีนแบบดั้งเดิม อะไรก็ตามที่ไม่สามารถรู้ จะแปรไปเป็นภาษาอังกฤษแทนที่จะถูกล้มเหลว

นี่ครอบคลุมการควบคุมของวิดเจ็ตเอง และ ทุกอย่างที่ผู้ช่วยสร้างขึ้น: บรรทัดสถานะ, ข้อความเสร็จสิ้น, ป้ายผลลัพธ์และคำตอบเอง มันจะดำเนินการต่อข้อความต่อข้อความ ดังนั้นผู้เยี่ยมชมที่เปลี่ยนภาษาในระหว่างการสนทนาจะได้รับภาษาที่ยกมาใหม่จากข้อความถัดไป เนื้อหาที่ส่งไปแล้วจะไม่ถูกแปลใหม่ — การ์ดผลลัพธ์จะคงอยู่ในภาษาที่สร้างขึ้น

หากการสนทนาเริ่มด้วยงานที่ใช้เวลายาวนาน ภาษาจะเดินทางไปด้วย ดังนั้นข้อความเสร็จสิ้นจะมาถึงในภาษาที่ผู้เยี่ยมชมใช้ แม้ว่าจะเป็นชั่วโมงหลังจากนั้น

ข้อยกเว้นหนึ่งข้อ: ข้อความที่เขียนโดยผู้สร้าง workflow — คำอธิบายฟิลด์, ข้อความชี้แจง, และการแสดงผลแบบกำหนดเอง — จะปรากฏในรูปแบบที่พวกเขาเขียน นั่นคือเนื้อหาที่ถูกเขียนโดยผู้ใช้แทนที่จะเป็นสำเนาผลิตภัณฑ์ ดังนั้นมันจึงไม่ถูกแปล

การสร้างลูกค้าของคุณเองแทน

คุณไม่จำเป็นต้องใช้วิดเจ็ต คุณสามารถใช้งาน endpoints สำหรับการฝังในเอกสารที่ REST API reference ซึ่งจะใช้ค่า locale เดียวกันในแต่ละการเรียก — ส่งมันและคุณจะได้รับพฤติกรรมเดียวกัน หากไม่ส่งคุณจะได้รับภาษาอังกฤษ

หากบางสิ่งไม่ปรากฏ

• ไม่มีปุ่มไมโครโฟน เสียงต้องการการเชื่อมต่อที่ปลอดภัย บนหน้าที่ให้บริการผ่าน HTTP ธรรมดา เบราว์เซอร์จะไม่ให้สิทธิ์เข้าถึงไมโครโฟน ดังนั้นจึงไม่มีการควบคุมที่แสดง ให้บริการหน้าของคุณผ่าน HTTPS
• ส่วนประกอบไม่แสดง วิดเจ็ตจะเฉพาะแสดงประเภทของส่วนประกอบที่รู้จักและจะไม่แสดงบางสิ่งที่ไม่สามารถเข้าใจได้ ดังนั้นการแสดงผลที่มันไม่สามารถเข้าใจจะถูกข้ามไปแทนที่จะถูกแสดงเป็นความผิดพลาด
• วิดเจ็ตหยุดทำงาน หาก workspace ที่เป็นเจ้าของการฝังไม่มีการสมัครสมาชิกที่ใช้งานอยู่ วิดเจ็ตจะปฏิเสธอย่างสุภาพ แทนที่จะแสดงข้อความเกี่ยวกับการเรียกเก็บเงินต่อผู้เยี่ยมชมของคุณ