الأخطاء واستكشاف الأخطاء وإصلاحها

لضمان التشغيل الصحيح للتكامل ، إذا تمت مصادفة أكثر من 10 أخطاء متتالية من الطرف المتلقي (أي خطأ ، يتراوح من عنوان URL غير صالح إلى رمز استجابة ليس 200) ، فسيقوم النظام تلقائيا بتعطيل التكامل. في مثل هذه الحالة ، سيتلقى مالك مساحة العمل إشعارا بالبريد الإلكتروني.

في حال كنت بحاجة إلى استكشاف خطأ وإصلاحها ، يمكنك تنزيل سجل مفصل (سيصبح الرابط متاحا في أسفل الصفحة) ، حيث سيظهر ما يصل إلى 100 طلب حديث مع جميع تفاصيل البيانات المرسلة والاستجابة المستلمة.

تنسيق البيانات

سيتم إرسال البيانات إلى عنوان URL الخاص بخطاف الويب عن طريق طلب HTTP POST ، بتنسيق JSON. يتم توفير البيانات في 2 تنسيقات مختلفة ، اعتمادا على إعداد دقة التجميع ، كما هو موضح أدناه.

التجميع كل X ساعة

سيتم تجميع الرسائل في "حزمة". ستتوفر البيانات التالية:

• "حساب WhatsApp" - تفاصيل حساب WhatsApp (وزميل Workspace ، الذي ربط الحساب) ، والذي تم من خلاله استلام الرسالة أو إرسالها
  • "الهاتف" - رقم هاتف حساب WA
  • "full_name" - الاسم الكامل لمالك حساب WA ، كما هو مسجل في الجداول الزمنية
  • "البريد الإلكتروني" - البريد الإلكتروني لمالك حساب WA ، كما هو مسجل في الجداول الزمنية
• "الدردشة" – تفاصيل الدردشة (الدردشة المباشرة أو المجموعة) ، التي تم إرسال الرسالة أو استلامها فيها
  • "full_name" - اسم الدردشة (كما يظهر في الخطوط الزمنية)
  • "responsible_name" - اسم زميل في الفريق تم تعيينه كمسؤول عن هذه الدردشة
  • "responsible_email" - البريد الإلكتروني لزميل في الفريق تم تعيينه كمسؤول عن هذه الدردشة
  • "chat_url" - عنوان URL الذي يمكن من خلاله الوصول إلى الدردشة في TimelinesUI
  • "chat_id" - معرف الدردشة في TimelinesUI (يمكن استخدامه لإنشاء عنوان URL للدردشة أو مع خطافات الويب الواردة)
  • "is_new_chat" - صحيح ، إذا تم إنشاء هذه الدردشة للتو ، فخطأ بخلاف ذلك
  • "is_group" - صحيح ، إذا كانت هذه الدردشة دردشة مباشرة ، فخطأ بخلاف ذلك
  • "الهاتف" - رقم هاتف الدردشة (فارغ للدردشة الجماعية)
• "الرسائل" - قائمة بالرسائل ، حيث يحتوي كل كائن رسالة على الحقول التالية
  • "الاتجاه" - يمكن "استلامه" أو "إرساله"
  • "الطابع الزمني" - الطابع الزمني للرسالة، بالتوقيت العالمي المنسق (UTC)
  • "message_id" - غير مستخدم
  • "message_uid" - معرف فريد داخلي للرسالة يمكن استخدامه مع واجهة برمجة التطبيقات العامة لتحميل تفاصيل الرسالة وتحديثات الحالة (انظر التفاصيل هنا)
  • "المرسل" - تفاصيل المرسل (مشارك الدردشة) للرسالة
    • "full_name" - عنوان الدردشة أو اسم زميل في الفريق في الجداول الزمنية (إذا تم إرساله من داخل الجداول الزمنية)
    • "الهاتف" - رقم هاتف المرسل (أو فارغ للدردشة الجماعية)
  • "المستلم" - تفاصيل المرسل (مشارك الدردشة) للرسالة
    • "full_name" - عنوان الدردشة أو اسم زميل في الفريق في الجداول الزمنية
    • "الهاتف" - رقم هاتف المستلم (أو فارغ للدردشة الجماعية)
  • "النص" - نص الرسالة (نص عادي)
  • "مرفق" - كائن يصف مرفق الرسالة ، بما في ذلك الحقول التالية
    • "temporary_download_url" – عنوان URL مؤقت للتنزيل ، صالح لمدة 15 دقيقة
    • "اسم الملف" - اسم الملف
    • "الحجم" – حجم الملف، بالبايت
    • "mimetype" - نوع التمثيل الصامت للملف
• "first_message_timestamp" - الطابع الزمني لأقرب رسالة في الحزمة ، بالتوقيت العالمي المنسق
• "last_message_timestamp" - الطابع الزمني لأحدث رسالة في الحزمة ، بالتوقيت العالمي المنسق
• "التجميع" - نص مجمع للرسالة ، بتنسيق HTML ، مناسب للاستخدام مع CRMs أو الأنظمة المماثلة كمحتوى للملاحظات ، بما في ذلك الرابط المباشر للرسالة الأولى في الجداول الزمنية.

مثل

{
    "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",
            "attachment": {
                "temporary_download_url": "https://acme.com/path",
                "filename": "someimage.png",
                "size": 128909,
                "mimetype": "image/png"
            }
        },
        {
            "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 (وزميل Workspace ، الذي ربط الحساب) ، والذي تم من خلاله استلام الرسالة أو إرسالها
  • "الهاتف" - رقم هاتف حساب WA
  • "full_name" - الاسم الكامل لمالك حساب WA ، كما هو مسجل في الجداول الزمنية
  • "البريد الإلكتروني" - البريد الإلكتروني لمالك حساب WA ، كما هو مسجل في الجداول الزمنية
• "الدردشة" – تفاصيل الدردشة (الدردشة المباشرة أو المجموعة) ، التي تم إرسال الرسالة أو استلامها فيها
  • "full_name" - اسم الدردشة (كما يظهر في الخطوط الزمنية)
  • "responsible_name" - اسم زميل في الفريق تم تعيينه كمسؤول عن هذه الدردشة
  • "responsible_email" - البريد الإلكتروني لزميل في الفريق تم تعيينه كمسؤول عن هذه الدردشة
  • "chat_url" - عنوان URL الذي يمكن من خلاله الوصول إلى الدردشة في TimelinesUI
  • "chat_id" - معرف الدردشة في TimelinesUI (يمكن استخدامه لإنشاء عنوان URL للدردشة أو مع خطافات الويب الواردة)
  • "is_new_chat" - صحيح ، إذا تم إنشاء هذه الدردشة للتو ، فخطأ بخلاف ذلك
  • "is_group" - صحيح ، إذا كانت هذه الدردشة دردشة مباشرة ، فخطأ بخلاف ذلك
  • "الهاتف" - رقم هاتف الدردشة (فارغ للدردشة الجماعية)
• "الرسالة" - تفاصيل الرسالة
  • "الاتجاه" - يمكن "استلامه" أو "إرساله"
  • "الطابع الزمني" - الطابع الزمني للرسالة، بالتوقيت العالمي المنسق (UTC)
  • "message_id" - معرف فريد داخلي للرسالة
  • "المرسل" - تفاصيل المرسل (مشارك الدردشة) للرسالة
    • "full_name" - عنوان الدردشة أو اسم زميل في الفريق في الجداول الزمنية (إذا تم إرساله من داخل الجداول الزمنية)
    • "الهاتف" - رقم هاتف المرسل (أو فارغ للدردشة الجماعية)
  • "المستلم" - تفاصيل المرسل (مشارك الدردشة) للرسالة
    • "full_name" - عنوان الدردشة أو اسم زميل في الفريق في الجداول الزمنية
    • "الهاتف" - رقم هاتف المستلم (أو فارغ للدردشة الجماعية)
  • "النص" - نص الرسالة (نص عادي)
  • "مرفق" - كائن يصف مرفق الرسالة ، بما في ذلك الحقول التالية
    • "temporary_download_url" – عنوان URL مؤقت للتنزيل ، صالح لمدة 15 دقيقة
    • "اسم الملف" - اسم الملف
    • "الحجم" – حجم الملف، بالبايت
    • "mimetype" - نوع التمثيل الصامت للملف

مثل

{
    "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",
            "attachment": {
                "temporary_download_url": "https://acme.com/path",
                "filename": "someimage.png",
                "size": 128909,
                "mimetype": "image/png"
            }
        }
}

المشرف