Σφάλματα και αντιμετώπιση προβλημάτων

Για να διασφαλιστεί η ορθή λειτουργία της ολοκλήρωσης, εάν παρουσιαστούν περισσότερα από 10 διαδοχικά σφάλματα από την πλευρά του παραλήπτη (οποιοδήποτε σφάλμα, από άκυρη διεύθυνση URL έως κωδικό απόκρισης που δεν είναι 200), το σύστημα θα απενεργοποιήσει αυτόματα την ολοκλήρωση. Στην περίπτωση αυτή, ο ιδιοκτήτης του χώρου εργασίας θα λάβει ειδοποίηση μέσω ηλεκτρονικού ταχυδρομείου.

Σε περίπτωση που χρειαστεί να αντιμετωπίσετε κάποιο σφάλμα, μπορείτε να κατεβάσετε ένα λεπτομερές αρχείο καταγραφής (ο σύνδεσμος θα είναι διαθέσιμος στο κάτω μέρος της σελίδας), όπου θα εμφανίζονται έως και 100 πιο πρόσφατες αιτήσεις με όλες τις λεπτομέρειες των δεδομένων που εστάλησαν και της απάντησης που ελήφθη.

Μορφή δεδομένων

Τα δεδομένα θα αποστέλλονται στη διεύθυνση URL ενός Webhook μέσω αίτησης HTTP POST, σε μορφή JSON. Τα δεδομένα παρέχονται σε 2 διαφορετικές μορφές, ανάλογα με τη ρύθμιση Aggregation Granularity, όπως περιγράφεται παρακάτω.

Συγκεντρωτικά κάθε Χ ώρες

Τα μηνύματα θα συγκεντρωθούν σε μια "δέσμη". Τα ακόλουθα δεδομένα θα είναι διαθέσιμα:

• "λογαριασμός whatsapp" - τα στοιχεία του λογαριασμού whatsapp (και του συνεργάτη του χώρου εργασίας, ο οποίος συνέδεσε το λογαριασμό), μέσω του οποίου ελήφθη ή εστάλη το μήνυμα.
  • "phone" - ο αριθμός τηλεφώνου του λογαριασμού WA
  • "full_name" - το πλήρες όνομα του ιδιοκτήτη του λογαριασμού WA, όπως έχει καταχωρηθεί στο Timelines
  • "email" - το email του ιδιοκτήτη του λογαριασμού WA, όπως έχει καταχωρηθεί στο Timelines
• "συνομιλία" - τα στοιχεία της συνομιλίας (απευθείας συνομιλία ή ομάδα), στην οποία εστάλη ή ελήφθη το μήνυμα
  • "full_name" - το όνομα της συνομιλίας (όπως εμφανίζεται στα Timelines)
  • "responsible_name" - το όνομα ενός συμπαίκτη που έχει οριστεί ως υπεύθυνος σε αυτή τη συνομιλία
  • "responsible_email" - το email ενός συμπαίκτη που έχει οριστεί ως υπεύθυνος σε αυτή τη συνομιλία
  • "chat_url" - η διεύθυνση URL, στην οποία μπορεί να γίνει πρόσβαση στη συνομιλία στο TimelinesUI
  • "chat_id" - το αναγνωριστικό της συνομιλίας στο TimelinesUI (μπορεί να χρησιμοποιηθεί για την κατασκευή URL συνομιλίας ή με εισερχόμενα webhooks)
  • "is_new_chat" - true, εάν αυτή η συνομιλία μόλις δημιουργήθηκε, false διαφορετικά
  • "is_group" - true, εάν αυτή η συνομιλία είναι άμεση συνομιλία, false διαφορετικά
  • "phone" - αριθμός τηλεφώνου της συνομιλίας (κενό για ομαδική συνομιλία)
• "messages" - ένας κατάλογος μηνυμάτων, όπου κάθε αντικείμενο μηνύματος περιέχει τα ακόλουθα πεδία
  • "κατεύθυνση" - μπορεί να είναι "λαμβάνεται" ή "αποστέλλεται".
  • "timestamp" - χρονική σφραγίδα ενός μηνύματος, σε ζώνη ώρας UTC
  • "message_id" - δεν χρησιμοποιείται
  • "message_uid" - εσωτερικό μοναδικό αναγνωριστικό του μηνύματος που μπορεί να χρησιμοποιηθεί με το δημόσιο API για να φορτώσει λεπτομέρειες του μηνύματος και ενημερώσεις κατάστασης (δείτε λεπτομέρειες εδώ)
  • "αποστολέας" - λεπτομέρειες ενός αποστολέα (συμμετέχων της συνομιλίας) ενός μηνύματος
    • "full_name" - τίτλος μιας συνομιλίας ή το όνομα ενός συμπαίκτη στο Timelines (εάν αποστέλλεται μέσα από το Timelines)
    • "phone" - αριθμός τηλεφώνου του αποστολέα (ή κενό για ομαδική συνομιλία)
  • "παραλήπτης" - λεπτομέρειες ενός αποστολέα (συμμετέχων της συνομιλίας) ενός μηνύματος
    • "full_name" - τίτλος μιας συνομιλίας ή το όνομα ενός συμπαίκτη στο Timelines
    • "phone" - αριθμός τηλεφώνου του παραλήπτη (ή κενό για ομαδική συνομιλία)
  • "text" - κείμενο μηνύματος (απλό κείμενο)
  • "attachment" - ένα αντικείμενο που περιγράφει την επισύναψη του μηνύματος, συμπεριλαμβανομένων των ακόλουθων πεδίων
    • "temporary_download_url" - μια προσωρινή διεύθυνση URL λήψης, που ισχύει για 15 λεπτά
    • "filename" - όνομα του αρχείου
    • "size" - μέγεθος του αρχείου, σε bytes
    • "mimetype" - τύπος mime του αρχείου
• "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",
            "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 (και του συνεργάτη του χώρου εργασίας, ο οποίος συνέδεσε το λογαριασμό), μέσω του οποίου ελήφθη ή εστάλη το μήνυμα.
  • "phone" - ο αριθμός τηλεφώνου του λογαριασμού WA
  • "full_name" - το πλήρες όνομα του ιδιοκτήτη του λογαριασμού WA, όπως έχει καταχωρηθεί στο Timelines
  • "email" - το email του ιδιοκτήτη του λογαριασμού WA, όπως έχει καταχωρηθεί στο Timelines
• "συνομιλία" - τα στοιχεία της συνομιλίας (απευθείας συνομιλία ή ομάδα), στην οποία εστάλη ή ελήφθη το μήνυμα
  • "full_name" - το όνομα της συνομιλίας (όπως εμφανίζεται στα Timelines)
  • "responsible_name" - το όνομα ενός συμπαίκτη που έχει οριστεί ως υπεύθυνος σε αυτή τη συνομιλία
  • "responsible_email" - το email ενός συμπαίκτη που έχει οριστεί ως υπεύθυνος σε αυτή τη συνομιλία
  • "chat_url" - η διεύθυνση URL, στην οποία μπορεί να γίνει πρόσβαση στη συνομιλία στο TimelinesUI
  • "chat_id" - το αναγνωριστικό της συνομιλίας στο TimelinesUI (μπορεί να χρησιμοποιηθεί για την κατασκευή URL συνομιλίας ή με εισερχόμενα webhooks)
  • "is_new_chat" - true, εάν αυτή η συνομιλία μόλις δημιουργήθηκε, false διαφορετικά
  • "is_group" - true, εάν αυτή η συνομιλία είναι άμεση συνομιλία, false διαφορετικά
  • "phone" - αριθμός τηλεφώνου της συνομιλίας (κενό για ομαδική συνομιλία)
• "message" - οι λεπτομέρειες του μηνύματος
  • "κατεύθυνση" - μπορεί να είναι "λαμβάνεται" ή "αποστέλλεται".
  • "timestamp" - χρονική σφραγίδα ενός μηνύματος, σε ζώνη ώρας UTC
  • "message_id" - εσωτερικό μοναδικό αναγνωριστικό του μηνύματος
  • "αποστολέας" - λεπτομέρειες ενός αποστολέα (συμμετέχων της συνομιλίας) ενός μηνύματος
    • "full_name" - τίτλος μιας συνομιλίας ή το όνομα ενός συμπαίκτη στο Timelines (εάν αποστέλλεται μέσα από το Timelines)
    • "phone" - αριθμός τηλεφώνου του αποστολέα (ή κενό για ομαδική συνομιλία)
  • "παραλήπτης" - λεπτομέρειες ενός αποστολέα (συμμετέχων της συνομιλίας) ενός μηνύματος
    • "full_name" - τίτλος μιας συνομιλίας ή το όνομα ενός συμπαίκτη στο Timelines
    • "phone" - αριθμός τηλεφώνου του παραλήπτη (ή κενό για ομαδική συνομιλία)
  • "text" - κείμενο μηνύματος (απλό κείμενο)
  • "attachment" - ένα αντικείμενο που περιγράφει την επισύναψη του μηνύματος, συμπεριλαμβανομένων των ακόλουθων πεδίων
    • "temporary_download_url" - μια προσωρινή διεύθυνση URL λήψης, που ισχύει για 15 λεπτά
    • "filename" - όνομα του αρχείου
    • "size" - μέγεθος του αρχείου, σε bytes
    • "mimetype" - τύπος mime του αρχείου

Παράδειγμα

{
    "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"
            }
        }
}

admin