Erori și depanare

Pentru a asigura funcționarea corectă a integrării, în cazul în care vor fi întâlnite mai mult de 10 erori consecutive de la partea de recepție (orice eroare, de la URL invalidă până la codul de răspuns care nu este 200), sistemul va dezactiva automat integrarea. În acest caz, proprietarul spațiului de lucru va primi o notificare prin e-mail.

În cazul în care aveți nevoie să depanați o eroare, puteți descărca un jurnal detaliat (link-ul va fi disponibil în partea de jos a paginii), unde vor apărea până la 100 de cereri recente, cu toate detaliile datelor trimise și ale răspunsului primit.

Formatul datelor

Datele vor fi trimise la adresa URL a unui Webhook prin intermediul unei cereri HTTP POST, în format JSON. Datele sunt furnizate în 2 formate diferite, în funcție de setarea Aggregation Granularity (Granularitate de agregare), așa cum este descris mai jos.

Agregate la fiecare X ore

Mesajele vor fi agregate într-un "pachet". Vor fi disponibile următoarele date:

• "cont whatsapp" - detaliile contului whatsapp (și ale colegului de echipă din spațiul de lucru, care a conectat contul), prin intermediul căruia a fost primit sau trimis mesajul.
  • "phone" - numărul de telefon al contului WA
  • "full_name" - numele complet al proprietarului contului WA, așa cum este înregistrat în Timelines
  • "email" - adresa de e-mail a proprietarului contului WA, așa cum este înregistrată în Timelines
• "chat" - detaliile chat-ului (chat direct sau grup), în care a fost trimis sau primit mesajul.
  • "full_name" - numele de chat (așa cum apare în Timelines)
  • "nume_responsabil" - numele unui coechipier care este atribuit ca responsabil pentru acest chat.
  • "responsible_email" - adresa de e-mail a unui coechipier care este atribuit ca responsabil pentru acest chat.
  • "chat_url" - URL-ul la care poate fi accesat chat-ul în TimelinesUI
  • "chat_id" - ID-ul chat-ului în TimelinesUI (poate fi utilizat pentru a construi URL-ul chat-ului sau cu webhooks de intrare)
  • "is_new_chat" - true, dacă acest chat tocmai a fost creat, altfel false
  • "is_group" - adevărat, dacă acest chat este un chat direct, fals în caz contrar
  • "phone" - numărul de telefon al chat-ului (gol pentru chat-ul de grup)
• "mesaje" - o listă de mesaje, în care fiecare obiect mesaj conține următoarele câmpuri
  • "direcție" - poate fi "primit" sau "trimis".
  • "timestamp" - marca temporală a unui mesaj, în fusul orar UTC
  • "message_id" - neutilizat
  • "message_uid" - ID-ul unic intern al mesajului care poate fi folosit cu API-ul public pentru a încărca detaliile mesajului și actualizările de stare (vezi detalii aici).
  • "expeditor" - detaliile unui expeditor (participant la chat) al unui mesaj
    • "full_name" - titlul unui chat sau numele coechipierului din Timelines (dacă este trimis din Timelines)
    • "phone" - numărul de telefon al expeditorului (sau gol pentru chat de grup)
  • "destinatar" - detaliile unui expeditor (participant la chat) al unui mesaj
    • "full_name" - titlul unui chat sau numele unui coechipier în Timeline
    • "phone" - numărul de telefon al destinatarului (sau gol pentru chat de grup)
  • "text" - textul mesajului (plainxt)
  • "atașament" - un obiect care descrie atașamentul mesajului, incluzând următoarele câmpuri
    • "temporary_download_url" - un URL de descărcare temporară, valabil timp de 15 minute
    • "filename" - numele fișierului
    • "size" - dimensiunea fișierului, în bytes
    • "mimetype" - tipul mime al fișierului
• "first_message_timestamp" - marca temporală a primului mesaj din pachet, în fusul orar UTC
• "last_message_timestamp" - marca temporală a celui mai recent mesaj din pachet, în fusul orar UTC
• "agregare" - textul agregat al mesajului, în format HTML, potrivit pentru utilizarea cu CRM sau cu sisteme similare ca conținut pentru note, inclusiv linkul direct către primul mesaj din Timeline.

Exemplu

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

Nu adăugați

Fiecare mesaj este trimis individual, de îndată ce este disponibil. Nu are loc nicio "grupare". Următoarele date vor fi disponibile:

• "cont whatsapp" - detaliile contului whatsapp (și ale colegului de echipă din spațiul de lucru, care a conectat contul), prin intermediul căruia a fost primit sau trimis mesajul.
  • "phone" - numărul de telefon al contului WA
  • "full_name" - numele complet al proprietarului contului WA, așa cum este înregistrat în Timelines
  • "email" - adresa de e-mail a proprietarului contului WA, așa cum este înregistrată în Timelines
• "chat" - detaliile chat-ului (chat direct sau grup), în care a fost trimis sau primit mesajul.
  • "full_name" - numele de chat (așa cum apare în Timelines)
  • "nume_responsabil" - numele unui coechipier care este atribuit ca responsabil pentru acest chat.
  • "responsible_email" - adresa de e-mail a unui coechipier care este atribuit ca responsabil pentru acest chat.
  • "chat_url" - URL-ul la care poate fi accesat chat-ul în TimelinesUI
  • "chat_id" - ID-ul chat-ului în TimelinesUI (poate fi utilizat pentru a construi URL-ul chat-ului sau cu webhooks de intrare)
  • "is_new_chat" - true, dacă acest chat tocmai a fost creat, altfel false
  • "is_group" - adevărat, dacă acest chat este un chat direct, fals în caz contrar
  • "phone" - numărul de telefon al chat-ului (gol pentru chat-ul de grup)
• "mesaj" - detaliile mesajului
  • "direcție" - poate fi "primit" sau "trimis".
  • "timestamp" - marca temporală a unui mesaj, în fusul orar UTC
  • "message_id" - ID-ul unic intern al mesajului
  • "expeditor" - detaliile unui expeditor (participant la chat) al unui mesaj
    • "full_name" - titlul unui chat sau numele coechipierului din Timelines (dacă este trimis din Timelines)
    • "phone" - numărul de telefon al expeditorului (sau gol pentru chat de grup)
  • "destinatar" - detaliile unui expeditor (participant la chat) al unui mesaj
    • "full_name" - titlul unui chat sau numele unui coechipier în Timeline
    • "phone" - numărul de telefon al destinatarului (sau gol pentru chat de grup)
  • "text" - textul mesajului (plainxt)
  • "atașament" - un obiect care descrie atașamentul mesajului, incluzând următoarele câmpuri
    • "temporary_download_url" - un URL de descărcare temporară, valabil timp de 15 minute
    • "filename" - numele fișierului
    • "size" - dimensiunea fișierului, în bytes
    • "mimetype" - tipul mime al fișierului

Exemplu

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