คู่มือการย้ายระบบ

นำเข้าประวัติบทสนทนาของคุณ

กำลังย้ายมาจากเครื่องมือแชทหรือระบบเฮลป์เดสก์อื่นอยู่ใช่ไหม? ส่งออกประวัติของคุณเป็นไฟล์ CSV หรือไฟล์รูปแบบอื่น แล้วส่งให้ผู้ช่วย AI ของคุณ AI จะนำทุกบทสนทนาเข้ามาใน Sonny ผ่านเซิร์ฟเวอร์ MCP ของเรา ใช้ได้กับทุกเครื่องมือ เพราะ AI ของคุณเป็นผู้จับคู่ข้อมูลให้

ไม่มีอะไรถูกส่งออกไป

บทสนทนาที่นำเข้าคือประวัติ Sonny จะไม่ส่งอีเมลหรือข้อความถึงลูกค้า ไม่แจ้งเตือนทีมของคุณ ไม่เรียกเว็บฮุก ไม่รันการตอบกลับด้วย AI หรือกฎของกล่องข้อความ และไม่ส่งแบบสำรวจความพึงพอใจสำหรับบทสนทนาเหล่านี้ บทสนทนาจะเข้ามาในสถานะปิดแล้วและอ่านแล้ว กล่องข้อความของคุณจึงยังสงบเรียบร้อย

ก่อนเริ่มต้น

เชื่อมต่อ Sonny กับผู้ช่วย AI ของคุณแล้ว
เพิ่มเซิร์ฟเวอร์ MCP ของ Sonny ใน Claude, Cursor หรือแอป AI อื่น คู่มือ MCP ใช้เวลาประมาณหนึ่งนาที
ไฟล์ส่งออกจากเครื่องมือเดิมของคุณ
ไฟล์ส่งออกบทสนทนาและข้อความในรูปแบบ CSV, JSON หรือสเปรดชีต หากเครื่องมือเดิมเก็บไฟล์เป็นลิงก์ ให้เก็บคอลัมน์เหล่านั้นไว้ Sonny ดาวน์โหลดไฟล์จากลิงก์ได้
ช่องทางที่จะนำเข้า
แชทที่นำเข้าจะใช้เว็บไซต์ของช่องทาง และอีเมลที่นำเข้าจะใช้ที่อยู่อีเมลของช่องทาง AI ของคุณแสดงรายการช่องทางและถามคุณได้ว่าจะใช้ช่องทางไหน

ทีละขั้นตอน

  1. 01

    เชื่อมต่อ Sonny

    เชื่อมต่อเซิร์ฟเวอร์ MCP ของ Sonny กับผู้ช่วย AI ของคุณ แล้วเข้าสู่ระบบเวิร์กสเปซ หากคุณเชื่อมต่อไว้ก่อนวันนี้ ให้เชื่อมต่อใหม่เพื่อให้ AI เห็นเครื่องมือนำเข้าตัวใหม่

  2. 02

    ส่งไฟล์ส่งออกให้ AI

    แนบไฟล์หรือบอกตำแหน่งไฟล์ให้ AI ของคุณ และบอกว่าจะนำเข้าไปยังช่องทางไหน

  3. 03

    สั่งให้ AI นำเข้า

    ใช้พรอมต์ด้านล่างเป็นจุดเริ่มต้น AI ของคุณจะอ่านไฟล์ แปลงให้ตรงกับรูปแบบของ Sonny แล้วส่งเข้ามาเป็นชุด

  4. 04

    ตรวจสอบผลลัพธ์

    AI ของคุณจะรายงานสิ่งที่นำเข้าแล้วและปัญหาที่พบ เปิดบทสนทนาสักสองสามรายการใน Sonny เพื่อตรวจว่าแสดงถูกต้อง แล้วให้ AI นำเข้าส่วนที่เหลือให้เสร็จ

ตัวอย่างพรอมต์

เปลี่ยนชื่อคอลัมน์ให้ตรงกับไฟล์ของคุณ

prompt
นำเข้าบทสนทนาในไฟล์ export.csv ไปยังช่องทาง Sonny ของฉันชื่อ "Support" โดยใช้เครื่องมือ import_conversations
แต่ละแถวคือหนึ่งข้อความ จัดกลุ่มแถวตาม ticket_id ซึ่งเป็น externalId ของบทสนทนา และใช้ message_id เป็น externalId ของแต่ละข้อความ
ข้อความจากลูกค้าเป็น incoming คำตอบจากเจ้าหน้าที่เป็น outgoing และความคิดเห็นส่วนตัวเป็น note
ใช้ created_at เป็น sentAt (เวลาเป็น UTC) และใช้ attachment_url สำหรับไฟล์แนบ
นำเข้า 5 บทสนทนาก่อนเพื่อให้ฉันตรวจสอบใน Sonny จากนั้นนำเข้าส่วนที่เหลือเป็นชุดละ 20 บทสนทนา แล้วแสดงยอดรวมให้ฉันดู

ข้อมูลที่ย้ายมาได้

บทสนทนา
หัวเรื่อง สถานะ แท็ก และผู้รับผิดชอบ เป็นบทสนทนาแชทหรืออีเมลในช่องทางของคุณ
ข้อความ
ข้อความจากลูกค้า คำตอบจากทีม โน้ตภายใน และคำตอบจากแชทบอต พร้อมวันที่และเวลาเดิมของแต่ละข้อความ
ผู้ติดต่อ
จับคู่ด้วยที่อยู่อีเมล และสร้างใหม่หากยังไม่มี ผู้ติดต่อที่มีอยู่แล้วใน Sonny จะไม่ถูกเปลี่ยนแปลง
ไฟล์แนบ
รูปภาพ PDF เอกสาร สเปรดชีต และไฟล์ ZIP ขนาดสูงสุด 25MB จากลิงก์สาธารณะหรือส่งมาเป็นตัวไฟล์โดยตรง

รูปแบบการนำเข้า

AI ของคุณจะส่งบทสนทนาในรูปแบบนี้ คุณไม่ต้องเขียนเอง แต่การรู้ว่าแต่ละฟิลด์ทำอะไรจะช่วยได้

json
{
  "sourceId": "source_shop",
  "conversations": [
    {
      "externalId": "crisp-8812",
      "subject": "Delivery question",
      "contact": {
        "email": "ada@example.com",
        "name": "Ada"
      },
      "tags": [
        "Shipping"
      ],
      "messages": [
        {
          "externalId": "1",
          "direction": "incoming",
          "body": "Has my order shipped?",
          "sentAt": "2025-03-14T09:30:00Z"
        },
        {
          "externalId": "2",
          "direction": "outgoing",
          "body": "Yes, it left this morning.",
          "sentAt": "2025-03-14T09:41:00Z",
          "author": {
            "name": "Sam",
            "email": "sam@yourcompany.com"
          }
        },
        {
          "externalId": "3",
          "direction": "incoming",
          "body": "",
          "sentAt": "2025-03-14T09:45:00Z",
          "attachments": [
            {
              "url": "https://files.example.com/receipt.pdf"
            }
          ]
        }
      ]
    }
  ]
}
externalId
ID ของบทสนทนาในเครื่องมือเดิมของคุณ จำเป็นต้องมี การนำเข้า ID เดิมซ้ำจะเพิ่มเฉพาะข้อมูลใหม่เท่านั้น
messages
ข้อความในบทสนทนา แต่ละข้อความต้องมี direction (incoming, outgoing หรือ note), body และ sentAt
sentAt
เวลาที่ส่งข้อความ ในรูปแบบ ISO 8601 พร้อมเขตเวลา เช่น 2025-03-14T09:30:00Z
author
ผู้เขียนข้อความ อีเมลของสมาชิกทีมจะผูกคำตอบเข้ากับสมาชิกคนนั้นใน Sonny และ type bot ใช้ระบุคำตอบจากแชทบอต
contact
ที่อยู่อีเมลและชื่อของลูกค้า
status
open, pending หรือ closed ค่าเริ่มต้นคือ closed
channel
chat หรือ email ค่าเริ่มต้นคือ chat เมื่อช่องทางมีเว็บไซต์
attachments
ไฟล์ แต่ละไฟล์เป็น url แบบ https สาธารณะ หรือเป็น fileName, contentType และ dataBase64
tags
ชื่อแท็ก ระบบจะสร้างแท็กใหม่ให้คุณ
assigneeEmail
สมาชิกทีมที่จะมอบหมายบทสนทนาให้

ข้อควรรู้

  • รันซ้ำได้อย่างปลอดภัย หากการนำเข้าหยุดกลางคัน ให้รันอีกครั้ง ข้อความที่ย้ายมาแล้วจะถูกข้าม และไฟล์แนบที่ล้มเหลวจะถูกลองใหม่
  • การแบ่งชุด การเรียกแต่ละครั้งรับได้สูงสุด 50 บทสนทนา 1,000 ข้อความ และ 25 ไฟล์แนบ AI ของคุณจะแบ่งการนำเข้าขนาดใหญ่ให้เอง
  • ไม่มีที่อยู่อีเมล? บทสนทนายังคงนำเข้าได้ เพียงแต่ไม่มีผู้ติดต่อ ชื่อของลูกค้ายังคงแสดงอยู่บนข้อความของพวกเขา
  • สมาชิกทีม คำตอบจะผูกกับสมาชิกทีมเมื่ออีเมลของผู้เขียนตรงกับใครสักคนในเวิร์กสเปซของคุณ หากไม่ตรง จะใช้ชื่อจากเครื่องมือเดิมของคุณ
  • ใครนำเข้าได้ เจ้าของ ผู้ดูแลระบบ และเจ้าหน้าที่ คีย์ API ต้องมีสิทธิ์เขียนบทสนทนา ข้อความ และผู้ติดต่อ รวมถึงไฟล์แนบหากมีไฟล์

สำหรับนักพัฒนา

ไม่ได้ใช้ผู้ช่วย AI? ส่ง JSON เดียวกันไปที่ POST /api/v1/conversations/import ด้วยคีย์ API เอกสารอ้างอิง API มีสคีมาฉบับเต็ม

เอกสารที่เกี่ยวข้อง