שגיאות ופתרון בעיות

כדי להבטיח פעולה נכונה של האינטגרציה, אם ייתקלו ביותר מ -10 שגיאות רצופות מהקצה המקבל (כל שגיאה, החל מכתובת URL לא חוקית לקוד תגובה שאינו 200), המערכת תשבית את האינטגרציה באופן אוטומטי. במקרה כזה, הבעלים של סביבת העבודה יקבל הודעה בדוא"ל.

במקרה שתצטרך לפתור שגיאה, תוכל להוריד יומן מפורט (הקישור יהיה זמין בתחתית הדף), שבו יופיעו עד 100 בקשות אחרונות עם כל פרטי הנתונים שנשלחו והתגובה שהתקבלה.

תבנית נתונים

הנתונים יישלחו לכתובת URL של Webhook באמצעות בקשת HTTP POST, בפורמט JSON. הנתונים מסופקים בשתי תבניות שונות, בהתאם להגדרת גרעיניות הצבירה, כמתואר להלן.

צבירה כל X שעות

הודעות יצטברו ל"חבילה". הנתונים הבאים יהיו זמינים:

• "חשבון WhatsApp" – פרטי חשבון WhatsApp (ו-Workspace Teammate, שחיבר את החשבון), דרכו התקבלה או נשלחה ההודעה
  • "טלפון" – מספר הטלפון של חשבון WA
  • "full_name" – שמו המלא של בעל חשבון WA, כפי שנרשם ב-Timelines
  • "דוא"ל" – כתובת הדוא"ל של בעל חשבון WA, כפי שנרשם ב-Timelines
• "צ'אט" – פרטי הצ'אט (צ'אט ישיר או קבוצה), בו נשלחה או התקבלה ההודעה
  • "full_name" – שם הצ'אט (כפי שמופיע ב-Timelines)
  • "responsible_name" – שמו של חבר צוות שהוקצה כאחראי לצ'אט זה
  • "responsible_email" – הדוא"ל של חבר צוות שהוקצה כאחראי לצ'אט זה
  • "chat_url" – כתובת האתר, שבה ניתן לגשת לצ'אט ב- TimelinesUI
  • "chat_id" – מזהה הצ'אט ב- TimelinesUI (ניתן להשתמש בו לבניית כתובת URL של הצ'אט או עם webhooks נכנסים)
  • "is_new_chat" – נכון, אם הצ'אט הזה נוצר זה עתה, שקר אחרת
  • "is_group" – נכון, אם הצ'אט הזה הוא צ'אט ישיר, שקר אחרת
  • "טלפון" – מספר הטלפון של הצ'אט (ריק לצ'אט קבוצתי)
• "הודעות" – רשימת הודעות, כאשר כל אובייקט הודעה מכיל את השדות הבאים
  • "כיוון" – ניתן "לקבל" או "לשלוח"
  • "חותמת זמן" – חותמת זמן של הודעה, באזור זמן 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 (ו-Workspace Teammate, שחיבר את החשבון), דרכו התקבלה או נשלחה ההודעה
  • "טלפון" – מספר הטלפון של חשבון WA
  • "full_name" – שמו המלא של בעל חשבון WA, כפי שנרשם ב-Timelines
  • "דוא"ל" – כתובת הדוא"ל של בעל חשבון WA, כפי שנרשם ב-Timelines
• "צ'אט" – פרטי הצ'אט (צ'אט ישיר או קבוצה), בו נשלחה או התקבלה ההודעה
  • "full_name" – שם הצ'אט (כפי שמופיע ב-Timelines)
  • "responsible_name" – שמו של חבר צוות שהוקצה כאחראי לצ'אט זה
  • "responsible_email" – הדוא"ל של חבר צוות שהוקצה כאחראי לצ'אט זה
  • "chat_url" – כתובת האתר, שבה ניתן לגשת לצ'אט ב- TimelinesUI
  • "chat_id" – מזהה הצ'אט ב- TimelinesUI (ניתן להשתמש בו לבניית כתובת URL של הצ'אט או עם webhooks נכנסים)
  • "is_new_chat" – נכון, אם הצ'אט הזה נוצר זה עתה, שקר אחרת
  • "is_group" – נכון, אם הצ'אט הזה הוא צ'אט ישיר, שקר אחרת
  • "טלפון" – מספר הטלפון של הצ'אט (ריק לצ'אט קבוצתי)
• "הודעה" – פרטי ההודעה
  • "כיוון" – ניתן "לקבל" או "לשלוח"
  • "חותמת זמן" – חותמת זמן של הודעה, באזור זמן 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"
        }
}

מנהל מערכת