Fehler und Fehlersuche

Um den ordnungsgemäßen Betrieb der Integration zu gewährleisten, wird das System die Integration automatisch deaktivieren, wenn mehr als 10 aufeinanderfolgende Fehler auf der Empfängerseite auftreten (jeder Fehler, von einer ungültigen URL bis zu einem Antwortcode ungleich 200). In diesem Fall erhält der Arbeitsbereichseigentümer eine E-Mail-Benachrichtigung.

Für den Fall, dass Sie einen Fehler beheben müssen, können Sie ein detailliertes Protokoll herunterladen (der Link wird unten auf der Seite verfügbar), in dem bis zu 100 der letzten Anfragen mit allen Details zu den gesendeten Daten und der erhaltenen Antwort angezeigt werden.

Format der Daten

Die Daten werden mittels einer HTTP POST-Anfrage im JSON-Format an die URL eines Webhooks gesendet. Die Daten werden in 2 verschiedenen Formaten bereitgestellt, je nach Einstellung der Aggregationsgranularität, wie unten beschrieben.

Aggregat alle X Stunden

Die Nachrichten werden zu einem "Bündel" zusammengefasst. Die folgenden Daten werden verfügbar sein:

• "Whatsapp-Konto" - die Details des Whatsapp-Kontos (und des Workspace-Teammitglieds, das das Konto verbunden hat), über das die Nachricht empfangen oder gesendet wurde
  • "Telefon" - die Telefonnummer des WA-Kontos
  • "full_name" - der vollständige Name des Inhabers des WA-Kontos, wie er in Timelines registriert ist
  • "E-Mail" - die in Timelines registrierte E-Mail des WA-Kontoinhabers
• "Chat" - die Details des Chats (direkter Chat oder Gruppe), in dem die Nachricht gesendet oder empfangen wurde
  • "full_name" - der Chatname (wie er in Timelines erscheint)
  • "responsible_name" - der Name eines Teamkollegen, der als Verantwortlicher für diesen Chat zugewiesen ist
  • "responsible_email" - die E-Mail eines Teammitglieds, das als Verantwortlicher für diesen Chat zugewiesen ist
  • "chat_url" - die URL, unter der der Chat in TimelinesUI aufgerufen werden kann
  • "chat_id" - die ID des Chats in TimelinesUI (kann verwendet werden, um die Chat-URL zu erstellen oder mit eingehenden Webhooks)
  • "is_new_chat" - true, wenn dieser Chat gerade erstellt wurde, sonst false
  • "is_group" - true, wenn dieser Chat ein direkter Chat ist, sonst false
  • "Telefon" - Telefonnummer des Chats (leer für Gruppenchats)
• "messages" - eine Liste von Nachrichten, wobei jedes Nachrichtenobjekt die folgenden Felder enthält
  • "Richtung" - kann "empfangen" oder "gesendet" sein
  • "timestamp" - Zeitstempel einer Nachricht, in der Zeitzone UTC
  • "message_id" - interne eindeutige ID der Nachricht
  • "Absender" - Angaben zum Absender (Chat-Teilnehmer) einer Nachricht
    • "full_name" - Titel eines Chats oder der Name eines Mitspielers in den Timelines (wenn aus den Timelines gesendet)
    • "phone" - Telefonnummer des Absenders (oder leer für Gruppenchat)
  • "Empfänger" - Angaben zum Absender (Chat-Teilnehmer) einer Nachricht
    • "full_name" - Titel eines Chats oder Name eines Mitspielers in Timelines
    • "phone" - Telefonnummer des Empfängers (oder leer für Gruppenchat)
  • "text" - Text der Nachricht (Klartext)
• "first_message_timestamp" - Zeitstempel der frühesten Nachricht im Bündel, in UTC-Zeitzone
• "last_message_timestamp" - Zeitstempel der letzten Nachricht im Paket, in UTC-Zeitzone
• "Aggregation" - zusammengefasster Text der Nachricht im HTML-Format, geeignet für die Verwendung mit CRM- oder ähnlichen Systemen als Inhalt für Notizen, einschließlich des direkten Links zur ersten Nachricht in Timelines.

Beispiel

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

Nicht aggregieren

Jede Nachricht wird einzeln verschickt, sobald sie verfügbar ist. Es findet keine "Bündelung" statt. Die folgenden Daten werden verfügbar sein:

• "Whatsapp-Konto" - die Details des Whatsapp-Kontos (und des Workspace-Teammitglieds, das das Konto verbunden hat), über das die Nachricht empfangen oder gesendet wurde
  • "Telefon" - die Telefonnummer des WA-Kontos
  • "full_name" - der vollständige Name des Inhabers des WA-Kontos, wie er in Timelines registriert ist
  • "E-Mail" - die in Timelines registrierte E-Mail des WA-Kontoinhabers
• "Chat" - die Details des Chats (direkter Chat oder Gruppe), in dem die Nachricht gesendet oder empfangen wurde
  • "full_name" - der Chatname (wie er in Timelines erscheint)
  • "responsible_name" - der Name eines Teamkollegen, der als Verantwortlicher für diesen Chat zugewiesen ist
  • "responsible_email" - die E-Mail eines Teammitglieds, das als Verantwortlicher für diesen Chat zugewiesen ist
  • "chat_url" - die URL, unter der der Chat in TimelinesUI aufgerufen werden kann
  • "chat_id" - die ID des Chats in TimelinesUI (kann verwendet werden, um die Chat-URL zu erstellen oder mit eingehenden Webhooks)
  • "is_new_chat" - true, wenn dieser Chat gerade erstellt wurde, sonst false
  • "is_group" - true, wenn dieser Chat ein direkter Chat ist, sonst false
  • "Telefon" - Telefonnummer des Chats (leer für Gruppenchats)
• "Nachricht" - die Details der Nachricht
  • "Richtung" - kann "empfangen" oder "gesendet" sein
  • "timestamp" - Zeitstempel einer Nachricht, in der Zeitzone UTC
  • "message_id" - interne eindeutige ID der Nachricht
  • "Absender" - Angaben zum Absender (Chat-Teilnehmer) einer Nachricht
    • "full_name" - Titel eines Chats oder der Name eines Mitspielers in den Timelines (wenn aus den Timelines gesendet)
    • "phone" - Telefonnummer des Absenders (oder leer für Gruppenchat)
  • "Empfänger" - Angaben zum Absender (Chat-Teilnehmer) einer Nachricht
    • "full_name" - Titel eines Chats oder Name eines Mitspielers in Timelines
    • "phone" - Telefonnummer des Empfängers (oder leer für Gruppenchat)
  • "text" - Text der Nachricht (Klartext)

Beispiel

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