การรวมขาออก

การรวมขาออก:
Whatsapp > CRM และระบบอื่น ๆ ของคุณ

แบ่งปันบทความนี้กับนักพัฒนาของคุณหรือใช้ Zapier เพื่อรวมระบบของคุณกับ Whatsapp

ตั้ง ค่า

TimelinesAI อนุญาตให้แจ้งเตือนระบบภายนอกเมื่อได้รับหรือส่งข้อความใหม่ในบัญชี whatsapp ที่เชื่อมต่อในพื้นที่ทํางาน ซึ่งรวมถึงข้อความ whatsapp ที่ส่งผ่านแอพมือถือ Whatsapp หรือจากภายในไทม์ไลน์

บ่อยครั้งที่การรวมดังกล่าวถูกใช้ผ่านบริการตัวกลางบางอย่างเช่น Zapier ซึ่งการเปิดใช้งาน Webhook แต่ละครั้งจะนับรวมการใช้โควต้างาน

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

ภาพหน้าจอ 2021 11 23 ที่ 12 06 26
กลุ่มข้อความที่ส่งผ่าน Webhook

ในการตั้งค่าการรวมโดยใช้ Webhooks ขาออก:

  1. ไปที่เมนู Webhooks ในบัญชี TimelinesAI ของคุณ
  2. เลือกแท็บขาออก

ภาพหน้าจอ 2021 11 23 ที่ 11.47.21

คุณจะได้รับการตั้งค่าต่อไปนี้:

  • ความละเอียดการรวม - ข้อความจะถูกรวบรวมและส่งโดยใช้ Webhook ตามการเลือก (ทุก 1 / 6 / 12 / 24 ชั่วโมง) หรือจะถูกส่งทันทีที่ปรากฏในไทม์ไลน์ ("ไม่รวม)
  • Webhook URL - ที่นี่คุณต้องป้อน URL จริงที่ต้องได้รับแจ้ง
  • เปิดใช้งาน Webhook - คุณสามารถปิดใช้งาน Webhook ได้หากคุณต้องการหยุดการรวม

เมื่อเปิดใช้งาน Webhook และส่งข้อความบางข้อความบันทึกกิจกรรมจะปรากฏขึ้น (การดําเนินการล่าสุดสูงสุด 10 รายการ)

หมายเหตุ: ขณะนี้รองรับเฉพาะข้อความตัวอักษรและอีโมจิเท่านั้น ข้อความที่มีไฟล์แนบจะถูกข้ามไป

ข้อผิดพลาดและการแก้ไขปัญหา

เพื่อให้แน่ใจว่าการทํางานที่ถูกต้องของการรวมจะพบข้อผิดพลาดติดต่อกันมากกว่า 10 ครั้งจากจุดสิ้นสุดการรับ (ข้อผิดพลาดใด ๆ ตั้งแต่ URL ที่ไม่ถูกต้องไปจนถึงรหัสตอบกลับที่ไม่ใช่ 200) ระบบจะปิดใช้งานการรวมโดยอัตโนมัติ ในกรณีเช่นนี้เจ้าของพื้นที่ทํางานจะได้รับการแจ้งเตือนทางอีเมล

ในกรณีที่คุณต้องการแก้ไขข้อผิดพลาดคุณสามารถดาวน์โหลดบันทึกโดยละเอียด (ลิงก์จะอยู่ที่ด้านล่างของหน้า) ซึ่งคําขอล่าสุดสูงสุด 100 รายการจะปรากฏขึ้นพร้อมรายละเอียดทั้งหมดของข้อมูลที่ส่งและการตอบกลับที่ได้รับ

รูปแบบข้อมูล

ข้อมูลจะถูกส่งไปยัง URL ของ Webhook โดยใช้คําขอ HTTP POST ในรูปแบบ JSON ข้อมูลมีให้ใน 2 รูปแบบที่แตกต่างกันขึ้นอยู่กับการตั้งค่าความละเอียดการรวมตามที่อธิบายไว้ด้านล่าง

รวมทุก X ชั่วโมง

ข้อความจะถูกรวมเป็น "กลุ่ม" ข้อมูลต่อไปนี้จะพร้อมใช้งาน:

  • "บัญชี WhatsApp" – รายละเอียดของบัญชี WhatsApp (และเพื่อนร่วมทีมพื้นที่ทํางานที่เชื่อมต่อบัญชี) ซึ่งได้รับหรือส่งข้อความ
    • "โทรศัพท์" – หมายเลขโทรศัพท์ของบัญชี WA
    • "full_name" – ชื่อเต็มของเจ้าของบัญชี WA ตามที่ได้ลงทะเบียนไว้ในไทม์ไลน์
    • "อีเมล" – อีเมลของเจ้าของบัญชี WA ตามที่ลงทะเบียนไว้ในไทม์ไลน์
  • "แชท" – รายละเอียดของการแชท (แชทโดยตรงหรือกลุ่ม) ซึ่งข้อความถูกส่งหรือรับ
    • "full_name" – ชื่อแชท (ตามที่ปรากฏในไทม์ไลน์)
    • "responsible_name" – ชื่อของเพื่อนร่วมทีมที่ได้รับมอบหมายให้รับผิดชอบการแชทนี้
    • "responsible_email" – อีเมลของเพื่อนร่วมทีมที่ได้รับมอบหมายให้รับผิดชอบการแชทนี้
    • " chat_url" - URL ที่สามารถเข้าถึงการแชทได้ใน TimelinesUI
    • "chat_id" – รหัสของการแชทใน TimelinesUI (สามารถใช้เพื่อสร้าง URL แชทหรือกับ Webhooks ขาเข้า)
    • "is_new_chat" - จริงถ้าการแชทนี้เพิ่งสร้างขึ้นเท็จเป็นอย่างอื่น
    • "is_group" - จริงถ้าการแชทนี้เป็นการแชทโดยตรงเท็จเป็นอย่างอื่น
    • " โทรศัพท์" - หมายเลขโทรศัพท์ของแชท (ว่างเปล่าสําหรับการแชทเป็นกลุ่ม)
  • "ข้อความ" - รายการข้อความโดยที่วัตถุข้อความแต่ละรายการมีฟิลด์ต่อไปนี้
    • "ทิศทาง" – สามารถ "รับ" หรือ "ส่ง"
    • "timestamp" – การประทับเวลาของข้อความในเขตเวลา UTC
    • "message_id" – รหัสเฉพาะภายในของข้อความ
    • "ผู้ส่ง" – รายละเอียดของผู้ส่ง (ผู้เข้าร่วมแชท) ของข้อความ
      • "full_name" – ชื่อแชทหรือชื่อเพื่อนร่วมทีมในไทม์ไลน์ (หากส่งจากภายในไทม์ไลน์)
      • "โทรศัพท์" – หมายเลขโทรศัพท์ของผู้ส่ง (หรือว่างเปล่าสําหรับการแชทเป็นกลุ่ม)
    • "ผู้รับ" – รายละเอียดของผู้ส่ง (ผู้เข้าร่วมแชท) ของข้อความ
      • "full_name" – ชื่อแชทหรือชื่อเพื่อนร่วมทีมในไทม์ไลน์
      • "โทรศัพท์" – หมายเลขโทรศัพท์ของผู้รับ (หรือว่างเปล่าสําหรับการแชทเป็นกลุ่ม)
    • "ข้อความ" – ข้อความ (ข้อความธรรมดา)
  • "first_message_timestamp" – การประทับเวลาของข้อความแรกสุดในชุดรวมในเขตเวลา UTC
  • "last_message_timestamp" – การประทับเวลาของข้อความล่าสุดในชุดรวมในเขตเวลา UTC
  • "การรวม" – ข้อความรวมของข้อความในรูปแบบ HTML เหมาะสําหรับใช้กับ CRM หรือระบบที่คล้ายกันเป็นเนื้อหาสําหรับบันทึกย่อ รวมถึงลิงก์โดยตรงไปยังข้อความแรกในไทม์ไลน์

ตัวอย่าง

{
    "whatsapp_account" :
    {
        "full_name" : "Amnon Haha",
        "email" : "Amnon@acme.com",
        "phone" : "+972500000000"
    },
    "chat": 
    {
        "full_name": "John Doe>",
        "responsible_name": "Amnon",
        "responsible_email": "Amnon@acme.com",
        "chat_url" : "https://app.timelines.ai/chat/10010001/messages/",
        "chat_id" : "10010001",
        "is_new_chat" : true,
        "is_group": false, 
        "phone": "+97254000000"
    },
    "messages" :
    [
        {
            "direction": "sent", 
            "timestamp": "2021-02-24T16:25:29+0000",
            "message_id": "ddfskhsd76dsfs6dsd5skjsdhf",
            "sender": {
                "full_name": "John Doe",
                "phone": "+972540000000"
            },
            "recipient": {
                "full_name": "Jane Smith",
                "phone": "+972550000000"
            },
            "text": "lorem ipsum"
        },
        {
            "direction": "received", 
            "timestamp": "2021-02-24T16:30:29+0000",
            "message_id": "ddfskhsd76dsfs6dsd5skjsdhf",
            "sender": {
                "full_name": "John Doe",
                "phone": "+972540000000"
            },
            "recipient": {
                "full_name": "Jane Smith",
                "phone": "+972550000000"
            },
            "text": "lorem ipsum"
        }
    ],
    "first_message_timestamp" : "2021-02-24T16:25:29+0000",
    "last_message_timestamp" : "2021-02-24T16:30:29+0000",
    "aggregation":
        "from John Doe on 2021-02-24 16:25: Hi! How are you?<br/>from Jane Smith on 2021-02-24 16:30: I am fine, how are you?<br/>Click <a href='https://app.timelines.ai/permalink/77a28d55-5345-5435-8c72-3a7bcad8ded9/'>here</h> to open the conversation in TimelinesAI"
}

อย่ารวม

แต่ละข้อความจะถูกส่งเป็นรายบุคคลทันทีที่พร้อมใช้งาน ไม่มีการ "มัด" เกิดขึ้น ข้อมูลต่อไปนี้จะพร้อมใช้งาน:

  • "บัญชี WhatsApp" – รายละเอียดของบัญชี WhatsApp (และเพื่อนร่วมทีมพื้นที่ทํางานที่เชื่อมต่อบัญชี) ซึ่งได้รับหรือส่งข้อความ
    • "โทรศัพท์" – หมายเลขโทรศัพท์ของบัญชี WA
    • "full_name" – ชื่อเต็มของเจ้าของบัญชี WA ตามที่ได้ลงทะเบียนไว้ในไทม์ไลน์
    • "อีเมล" – อีเมลของเจ้าของบัญชี WA ตามที่ลงทะเบียนไว้ในไทม์ไลน์
  • "แชท" – รายละเอียดของการแชท (แชทโดยตรงหรือกลุ่ม) ซึ่งข้อความถูกส่งหรือรับ
    • "full_name" – ชื่อแชท (ตามที่ปรากฏในไทม์ไลน์)
    • "responsible_name" – ชื่อของเพื่อนร่วมทีมที่ได้รับมอบหมายให้รับผิดชอบการแชทนี้
    • "responsible_email" – อีเมลของเพื่อนร่วมทีมที่ได้รับมอบหมายให้รับผิดชอบการแชทนี้
    • " chat_url" - URL ที่สามารถเข้าถึงการแชทได้ใน TimelinesUI
    • "chat_id" – รหัสของการแชทใน TimelinesUI (สามารถใช้เพื่อสร้าง URL แชทหรือกับ Webhooks ขาเข้า)
    • "is_new_chat" - จริงถ้าการแชทนี้เพิ่งสร้างขึ้นเท็จเป็นอย่างอื่น
    • "is_group" - จริงถ้าการแชทนี้เป็นการแชทโดยตรงเท็จเป็นอย่างอื่น
    • " โทรศัพท์" - หมายเลขโทรศัพท์ของแชท (ว่างเปล่าสําหรับการแชทเป็นกลุ่ม)
  • "message" – รายละเอียดของข้อความ
    • "ทิศทาง" – สามารถ "รับ" หรือ "ส่ง"
    • "timestamp" – การประทับเวลาของข้อความในเขตเวลา UTC
    • "message_id" – รหัสเฉพาะภายในของข้อความ
    • "ผู้ส่ง" – รายละเอียดของผู้ส่ง (ผู้เข้าร่วมแชท) ของข้อความ
      • "full_name" – ชื่อแชทหรือชื่อเพื่อนร่วมทีมในไทม์ไลน์ (หากส่งจากภายในไทม์ไลน์)
      • "โทรศัพท์" – หมายเลขโทรศัพท์ของผู้ส่ง (หรือว่างเปล่าสําหรับการแชทเป็นกลุ่ม)
    • "ผู้รับ" – รายละเอียดของผู้ส่ง (ผู้เข้าร่วมแชท) ของข้อความ
      • "full_name" – ชื่อแชทหรือชื่อเพื่อนร่วมทีมในไทม์ไลน์
      • "โทรศัพท์" – หมายเลขโทรศัพท์ของผู้รับ (หรือว่างเปล่าสําหรับการแชทเป็นกลุ่ม)
    • "ข้อความ" – ข้อความ (ข้อความธรรมดา)

ตัวอย่าง

{
    "whatsapp_account" :
    {
        "full_name" : "Amnon Haha",
        "email" : "Amnon@acme.com",
        "phone" : "+972500000000"
    },
    "chat": 
    {
        "full_name": "John Doe>",
        "responsible_name": "Amnon",
        "responsible_email": "Amnon@acme.com",
        "chat_url" : "https://app.timelines.ai/chat/10010001/messages/",
        "chat_id" : "10010001",
        "is_new_chat" : true,
        "is_group": false, 
        "phone": "+97251111111"
    },
    "message" :
       {
            "direction": "sent", 
            "timestamp": "2021-02-24T06:25:29+0000",
            "message_id": "ddfskhsd76dsfs6dsd5skjsdhf",
            "sender": {
                "full_name": "John Doe",
                "phone": "+972540000000"
            },
            "recipient": {
                "full_name": "Jane Smith",
                "phone": "+972550000000"
            },
            "text": "lorem ipsum"
        }
}
สารบัญ