Kesalahan dan pemecahan masalah

Untuk memastikan operasi integrasi yang benar, jika lebih dari 10 kesalahan berturut-turut dari sisi penerima akan ditemukan (kesalahan apa pun, mulai dari URL yang tidak valid hingga kode respons yang bukan 200), sistem akan secara otomatis menonaktifkan integrasi. Dalam hal ini, pemilik ruang kerja akan menerima notifikasi melalui email.

Jika Anda perlu memecahkan masalah kesalahan, Anda dapat mengunduh log terperinci (tautan akan tersedia di bagian bawah halaman), di mana hingga 100 permintaan terbaru akan muncul dengan semua detail data yang dikirim dan respons yang diterima.

Format data

Data akan dikirim ke URL Webhook melalui permintaan HTTP POST, dalam format JSON. Data disediakan dalam 2 format yang berbeda, tergantung pada pengaturan Aggregation Granularity, seperti yang dijelaskan di bawah ini.

Agregat setiap X jam

Pesan akan dikumpulkan menjadi sebuah "bundel". Data berikut akan tersedia:

• "akun whatsapp" - rincian akun whatsapp (dan rekan tim ruang kerja, yang menghubungkan akun tersebut), yang digunakan untuk menerima atau mengirim pesan
  • "telepon" - nomor telepon akun WA
  • "nama_lengkap" - nama lengkap pemilik akun WA, seperti yang terdaftar di Linimasa
  • "email" - email pemilik akun WA, seperti yang terdaftar di Linimasa
• "obrolan" - detail obrolan (obrolan langsung atau grup), tempat pesan dikirim atau diterima
  • "nama_lengkap" - nama obrolan (seperti yang muncul di Linimasa)
  • "nama_penanggung_jawab" - nama rekan satu tim yang ditugaskan sebagai penanggung jawab untuk obrolan ini
  • "responsible_email" - email rekan satu tim yang ditugaskan sebagai penanggung jawab untuk obrolan ini
  • "chat_url" - URL tempat obrolan dapat diakses di TimelinesUI
  • "chat_id" - ID obrolan di TimelinesUI (dapat digunakan untuk membuat URL obrolan atau dengan inbound webhook)
  • "is_new_chat" - benar, jika obrolan ini baru saja dibuat, salah jika tidak
  • "is_group" - benar, jika obrolan ini adalah obrolan langsung, sebaliknya salah
  • "telepon" - nomor telepon obrolan (kosong untuk obrolan grup)
• "pesan" - daftar pesan, di mana setiap objek pesan berisi bidang-bidang berikut
  • "arah" - dapat "diterima" atau "dikirim"
  • "timestamp" - cap waktu pesan, dalam zona waktu UTC
  • "message_id" - ID unik internal pesan
  • "pengirim" - rincian pengirim (peserta obrolan) dari sebuah pesan
    • "nama_lengkap" - judul obrolan atau nama rekan tim di Timeline (jika dikirim dari dalam Timeline)
    • "telepon" - nomor telepon pengirim (atau kosongkan untuk obrolan grup)
  • "penerima" - rincian pengirim (peserta obrolan) dari sebuah pesan
    • "nama_lengkap" - judul obrolan atau nama rekan tim di Timeline
    • "telepon" - nomor telepon penerima (atau kosongkan untuk obrolan grup)
  • "text" - teks pesan (plaintext)
• "first_message_timestamp" - stempel waktu dari pesan paling awal dalam bundel, dalam zona waktu UTC
• "last_message_timestamp" - stempel waktu dari pesan terakhir dalam bundel, dalam zona waktu UTC
• "agregasi" - teks pesan yang dikumpulkan, dalam format HTML, cocok untuk digunakan dengan CRM atau sistem serupa sebagai konten catatan, termasuk tautan langsung ke pesan pertama di Timeline.

Contoh

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

Jangan menggabungkan

Setiap pesan dikirim satu per satu, segera setelah tersedia. Tidak ada "bundling" yang terjadi. Data berikut akan tersedia:

• "akun whatsapp" - rincian akun whatsapp (dan rekan tim ruang kerja, yang menghubungkan akun tersebut), yang digunakan untuk menerima atau mengirim pesan
  • "telepon" - nomor telepon akun WA
  • "nama_lengkap" - nama lengkap pemilik akun WA, seperti yang terdaftar di Linimasa
  • "email" - email pemilik akun WA, seperti yang terdaftar di Linimasa
• "obrolan" - detail obrolan (obrolan langsung atau grup), tempat pesan dikirim atau diterima
  • "nama_lengkap" - nama obrolan (seperti yang muncul di Linimasa)
  • "nama_penanggung_jawab" - nama rekan satu tim yang ditugaskan sebagai penanggung jawab untuk obrolan ini
  • "responsible_email" - email rekan satu tim yang ditugaskan sebagai penanggung jawab untuk obrolan ini
  • "chat_url" - URL tempat obrolan dapat diakses di TimelinesUI
  • "chat_id" - ID obrolan di TimelinesUI (dapat digunakan untuk membuat URL obrolan atau dengan inbound webhook)
  • "is_new_chat" - benar, jika obrolan ini baru saja dibuat, salah jika tidak
  • "is_group" - benar, jika obrolan ini adalah obrolan langsung, sebaliknya salah
  • "telepon" - nomor telepon obrolan (kosong untuk obrolan grup)
• "pesan" - rincian pesan
  • "arah" - dapat "diterima" atau "dikirim"
  • "timestamp" - cap waktu pesan, dalam zona waktu UTC
  • "message_id" - ID unik internal pesan
  • "pengirim" - rincian pengirim (peserta obrolan) dari sebuah pesan
    • "nama_lengkap" - judul obrolan atau nama rekan tim di Timeline (jika dikirim dari dalam Timeline)
    • "telepon" - nomor telepon pengirim (atau kosongkan untuk obrolan grup)
  • "penerima" - rincian pengirim (peserta obrolan) dari sebuah pesan
    • "nama_lengkap" - judul obrolan atau nama rekan tim di Timeline
    • "telepon" - nomor telepon penerima (atau kosongkan untuk obrolan grup)
  • "text" - teks pesan (plaintext)

Contoh

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

admin