Mga error at pag troubleshoot

Upang matiyak ang tamang operasyon ng pagsasama, kung higit sa 10 magkakasunod na error mula sa dulo ng pagtanggap ay makakatagpo (anumang error, mula sa hindi wastong URL sa code ng tugon na hindi 200), awtomatikong hindi paganahin ng system ang pagsasama. Sa naturang kaso, ang may ari ng workspace ay makakatanggap ng isang abiso sa email.

Sa kaso na kailangan mong i troubleshoot ang isang error, maaari kang mag download ng isang detalyadong log (ang link ay magiging magagamit sa ibaba ng pahina), kung saan hanggang sa 100 pinakahuling mga kahilingan ay magpapakita sa lahat ng mga detalye ng data na ipinadala at ang tugon na natanggap.

Format ng data

Ang data ay ipapadala sa URL ng isang Webhook sa pamamagitan ng paraan ng kahilingan sa HTTP POST, sa format ng JSON. Ang data ay ibinigay sa 2 iba't ibang mga format, depende sa setting ng Aggregation Granularity, tulad ng inilarawan sa ibaba.

Aggregate tuwing X hours

Ang mga mensahe ay pinagsama sama sa isang "bundle". Ang mga sumusunod na data ay magagamit:

• "WhatsApp account" – ang mga detalye ng WhatsApp account (at workspace teammate, na nagkonekta sa account), kung saan ang mensahe ay natanggap o ipinadala
  • "telepono" – numero ng telepono ng WA account
  • "full_name" – ang buong pangalan ng may-ari ng WA account, tulad ng nakarehistro sa Timelines
  • "email" – ang email ng may-ari ng WA account, tulad ng nakarehistro sa Timelines
• "chat" – ang mga detalye ng chat (direktang chat o grupo), kung saan ipinadala o natanggap ang mensahe
  • "full_name" – ang pangalan ng chat (tulad ng makikita sa Timelines)
  • "responsible_name" – ang pangalan ng isang teammate na nakatalaga bilang responsable sa chat na ito
  • "responsible_email" – ang email ng isang teammate na nakatalaga bilang responsable sa chat na ito
  • "chat_url" – ang URL, kung saan ang chat ay maaaring ma-access sa TimelinesUI
  • "chat_id" – ang ID ng chat sa TimelinesUI (maaaring gamitin upang bumuo ng chat URL o may inbound webhooks)
  • "is_new_chat" – totoo, kung ang chat na ito ay nilikha lamang, mali kung hindi man
  • "is_group" – totoo, kung ang chat na ito ay isang direktang chat, mali kung hindi man
  • "telepono" – numero ng telepono ng chat (walang laman para sa group chat)
• "Mga mensahe" – isang listahan ng mga mensahe, kung saan ang bawat mensahe object ay naglalaman ng mga sumusunod na patlang
  • "direksyon" – maaaring "tanggapin" o "ipadala"
  • "timestamp" – timestamp ng isang mensahe, sa UTC timezone
  • "message_id" – panloob na natatanging ID ng mensahe
  • "sender" – mga detalye ng isang nagpadala (kalahok ng chat) ng isang mensahe
    • "full_name" – pamagat ng pangalan ng chat o teammate sa Timelines (kung ipinadala mula sa Timelines)
    • "telepono" – numero ng telepono ng nagpadala (o walang laman para sa group chat)
  • "tatanggap" – mga detalye ng isang nagpadala (kalahok ng chat) ng isang mensahe
    • "full_name" – pamagat ng pangalan ng isang chat o teammate sa Timelines
    • "telepono" – numero ng telepono ng tatanggap (o walang laman para sa group chat)
  • "text" – text ng mensahe (plaintext)
• "first_message_timestamp" – timestamp ng pinakaunang mensahe sa bundle, sa UTC timezone
• "last_message_timestamp" – timestamp ng pinakahuling mensahe sa bundle, sa UTC timezone
• "aggregation" – pinagsama samang teksto ng mensahe, sa HTML format, na angkop para gamitin sa CRMs o katulad na mga sistema bilang isang nilalaman para sa mga tala, kabilang ang direktang link sa unang mensahe sa Timelines.

Halimbawa

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

Huwag mag aggregate

Ang bawat mensahe ay ipinadala nang isa isa, sa lalong madaling panahon ito ay magagamit. Walang "bundling" na nagaganap. Ang mga sumusunod na data ay magagamit:

• "WhatsApp account" – ang mga detalye ng WhatsApp account (at workspace teammate, na nagkonekta sa account), kung saan ang mensahe ay natanggap o ipinadala
  • "telepono" – numero ng telepono ng WA account
  • "full_name" – ang buong pangalan ng may-ari ng WA account, tulad ng nakarehistro sa Timelines
  • "email" – ang email ng may-ari ng WA account, tulad ng nakarehistro sa Timelines
• "chat" – ang mga detalye ng chat (direktang chat o grupo), kung saan ipinadala o natanggap ang mensahe
  • "full_name" – ang pangalan ng chat (tulad ng makikita sa Timelines)
  • "responsible_name" – ang pangalan ng isang teammate na nakatalaga bilang responsable sa chat na ito
  • "responsible_email" – ang email ng isang teammate na nakatalaga bilang responsable sa chat na ito
  • "chat_url" – ang URL, kung saan ang chat ay maaaring ma-access sa TimelinesUI
  • "chat_id" – ang ID ng chat sa TimelinesUI (maaaring gamitin upang bumuo ng chat URL o may inbound webhooks)
  • "is_new_chat" – totoo, kung ang chat na ito ay nilikha lamang, mali kung hindi man
  • "is_group" – totoo, kung ang chat na ito ay isang direktang chat, mali kung hindi man
  • "telepono" – numero ng telepono ng chat (walang laman para sa group chat)
• "mensahe" – ang mga detalye ng mensahe
  • "direksyon" – maaaring "tanggapin" o "ipadala"
  • "timestamp" – timestamp ng isang mensahe, sa UTC timezone
  • "message_id" – panloob na natatanging ID ng mensahe
  • "sender" – mga detalye ng isang nagpadala (kalahok ng chat) ng isang mensahe
    • "full_name" – pamagat ng pangalan ng chat o teammate sa Timelines (kung ipinadala mula sa Timelines)
    • "telepono" – numero ng telepono ng nagpadala (o walang laman para sa group chat)
  • "tatanggap" – mga detalye ng isang nagpadala (kalahok ng chat) ng isang mensahe
    • "full_name" – pamagat ng pangalan ng isang chat o teammate sa Timelines
    • "telepono" – numero ng telepono ng tatanggap (o walang laman para sa group chat)
  • "text" – text ng mensahe (plaintext)

Halimbawa

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