วิดเจ็ตแชทบนเว็บ

เริ่มต้นอย่างรวดเร็ว

1. 1 ในเวิร์กสเปซ เปิด การตั้งค่า → แชทบนเว็บ แล้วเปิดใช้งานวิดเจ็ต
2. 2 เพิ่มออริจินของแต่ละเว็บไซต์ที่จะโหลดวิดเจ็ตในส่วนออริจินที่อนุญาต
3. 3 คัดลอกสนิปเป็ตสำหรับฝัง แล้ววางไว้ก่อนแท็กปิด </body>

<script src="https://widget.rosettachat.app/widget.js" data-site="wgt_..." async></script>

ระบุตัวตนผู้เยี่ยมชมแบบเซ็นลายเซ็น (ไม่บังคับ)

หากผู้เยี่ยมชมล็อกอินอยู่แล้ว ให้พิสูจน์ตัวตนเพื่อให้เจ้าหน้าที่เห็นป้าย “ยืนยันแล้ว” และการสนทนามี external_user_id ที่คงที่ สร้างคีย์ลายเซ็นใน การตั้งค่า → แชทบนเว็บ จากนั้นเซ็นโทเค็นบนแบ็กเอนด์แล้วส่งผ่าน data-identity อย่าเปิดเผยคีย์ลับต่อเบราว์เซอร์

import crypto from 'node:crypto';

function signIdentity(secret, payload) {
  const b64 = Buffer.from(JSON.stringify(payload)).toString('base64url');
  const sig = crypto.createHmac('sha256', secret).update(b64).digest('hex');
  return `${b64}.${sig}`;
}

const token = signIdentity(process.env.ROSETTA_IDENTITY_SECRET, {
  external_user_id: user.id,
  name: user.name,
  email: user.email,
});

Webhook

สมัครรับ conversation.created, conversation.closed และ (เลือกได้) message.created การส่งแต่ละครั้งลงลายเซ็นด้วย X-Rosetta-Signature: t=<unix>,v1=<hmac_sha256("t.body", secret)> ตรวจสอบด้วยคีย์ลับที่แสดงครั้งเดียวตอนสร้าง Webhook

โหมดทดสอบ

ใช้สนิปเป็ตแบบแซนด์บ็อกซ์ (คีย์ทดสอบแยกต่างหาก) ระหว่างพัฒนา การสนทนาจะถูกทำเครื่องหมายเป็นการทดสอบ ไม่นับรวมการใช้งานซัพพอร์ต ซ่อนจากกล่องเริ่มต้น และถูกลบอัตโนมัติ