Nasıl Yardımcı Olabiliriz?

Giden Entegrasyon

Giden Entegrasyonu:
Whatsapp > CRM ve diğer sistemleriniz

Bu makaleyi geliştiricinizle paylaşın veya sisteminizi Whatsapp ile entegre etmek için Zapier'i kullanın

Kurulum

TimelinesAI, bir çalışma alanındaki bağlı herhangi bir whatsapp hesabında yeni bir mesaj alındığında veya gönderildiğinde harici bir sistemi bilgilendirmeye izin verir. Bu, Whatsapp Mobil Uygulaması aracılığıyla veya Timelines içinden gönderilen whatsapp mesajlarını içerir.

Bu tür bir entegrasyon genellikle Zapier gibi bir aracı hizmet aracılığıyla kullanılır ve burada bir web kancasının her etkinleştirilmesi görev kotası kullanımına sayılır.

Görev kotasının kullanımını daha verimli hale getirmek için TimelinesAI, seçilen süre boyunca belirli bir sohbette gönderilen veya alınan birden fazla mesajı bir araya getirme olanağı sağlar. Mesajlar web kancası aracılığıyla tek bir "paket" olarak gönderilir. Size kolaylık sağlamak için, bu tür bir "paket", mesajların önceden biçimlendirilmiş toplamını (ve TimelinesAI'deki konuşmalardaki noktaya bir bağlantı) içeren bir alan içerir, ancak web kancasıyla sağlanan verileri kullanarak kendi biçimlendirmenizi uygulayabilirsiniz.

Ekran Görüntüsü 2021 11 23 12 06 26
Bir web kancası aracılığıyla gönderilen mesajlar demeti

Outbound Webhooks kullanarak entegrasyonu kurmak için:

  1. Şu adrese gidin Webhooks TimelinesAI hesabınızdaki menü
  2. Giden sekmesini seçin.

Ekran Görüntüsü 2021 11 23 saat 11.47.21

Size aşağıdaki ayarlar sunulacaktır:

  • Toplama Ayrıntılılığı - mesajlar seçime göre (her 1 / 6 / 12 / 24 saatte bir) web kancası kullanılarak toplanacak ve gönderilecek veya zaman çizelgelerinde göründükleri anda gönderilecektir ("Toplama yapma)
  • Webhook URL' si - burada bildirilmesi gereken gerçek URL'yi girmeniz gerekir.
  • Webhook etkin - entegrasyonu durdurmak istiyorsanız webhook'u devre dışı bırakabilirsiniz.

Bir Web kancası etkinleştirildiğinde ve bazı mesajlar gönderildiğinde, bir etkinlik günlüğü görüntülenecektir (en son 10 eyleme kadar).

Hatalar ve sorun giderme

Entegrasyonun doğru çalıştığından emin olmak için, alıcı uçta art arda 10'dan fazla hatayla karşılaşılırsa (geçersiz URL'den 200 olmayan yanıt koduna kadar herhangi bir hata), sistem entegrasyonu otomatik olarak devre dışı bırakacaktır. Böyle bir durumda, çalışma alanı sahibi bir e-posta bildirimi alacaktır.

Bir hatayı gidermeniz gerektiğinde, gönderilen verilerin ve alınan yanıtın tüm ayrıntılarıyla birlikte en son 100 isteğin gösterileceği ayrıntılı bir günlük indirebilirsiniz (bağlantı sayfanın altında kullanılabilir hale gelecektir).

Veri formatı

Veriler, JSON formatında HTTP POST isteği aracılığıyla bir Webhook'un URL'sine gönderilecektir. Veriler, aşağıda açıklandığı gibi Toplama Granülaritesi ayarına bağlı olarak 2 farklı formatta sağlanır.

Her X saatte bir toplama

Mesajlar bir "paket" halinde toplanacaktır. Aşağıdaki veriler mevcut olacaktır:

  • "whatsapp hesabı" - mesajın alındığı veya gönderildiği whatsapp hesabının (ve hesaba bağlı olan çalışma alanı ekip arkadaşının) ayrıntıları
    • "phone" - WA hesabının telefon numarası
    • "full_name" - WA hesap sahibinin Zaman Çizelgeleri'nde kayıtlı tam adı
    • "email" - WA hesap sahibinin Zaman Çizelgeleri'nde kayıtlı olan e-postası
  • "sohbet" - mesajın gönderildiği veya alındığı sohbetin (doğrudan sohbet veya grup) ayrıntıları
    • "full_name" - sohbet adı (Zaman Çizelgelerinde göründüğü gibi)
    • "responsible_name" - bu sohbete sorumlu olarak atanmış bir ekip arkadaşının adı
    • "responsible_email" - bu sohbete sorumlu olarak atanmış bir ekip arkadaşının e-postası
    • "chat_url" - TimelinesUI'de sohbete erişilebilecek URL
    • "chat_id" - TimelinesUI'deki sohbetin kimliği (sohbet URL'si oluşturmak için veya gelen web kancaları ile kullanılabilir)
    • "is_new_chat" - bu sohbet yeni oluşturulmuşsa true, aksi takdirde false
    • "is_group" - bu sohbet doğrudan bir sohbet ise true, aksi takdirde false
    • "phone" - sohbetin telefon numarası (grup sohbeti için boş)
  • "messages" - her mesaj nesnesinin aşağıdaki alanları içerdiği bir mesaj listesi
    • "yön" - "alındı" veya "gönderildi" olabilir
    • "timestamp" - UTC zaman diliminde bir mesajın zaman damgası
    • "message_id" - kullanımda değil
    • "message_uid" - mesaj ayrıntılarını ve durum güncellemelerini yüklemek için Genel API ile kullanılabilen mesajın dahili benzersiz kimliği (ayrıntılara buradan bakın)
    • "sender" - bir mesajın göndericisinin (sohbet katılımcısı) ayrıntıları
      • "full_name" - Zaman Çizelgeleri'nde bir sohbetin başlığı veya takım arkadaşının adı (Zaman Çizelgeleri içinden gönderiliyorsa)
      • "phone" - gönderenin telefon numarası (veya grup sohbeti için boş)
    • "alıcı" - bir mesajın göndericisinin (sohbet katılımcısı) ayrıntıları
      • "full_name" - Zaman Çizelgeleri'nde bir sohbetin başlığı veya takım arkadaşının adı
      • "phone" - alıcının telefon numarası (veya grup sohbeti için boş)
    • "text" - mesaj metni (düz metin)
    • "attachment" - aşağıdaki alanları içeren, mesaj ekini tanımlayan bir nesne
      • "temporary_download_url" - 15 dakika boyunca geçerli olan geçici bir indirme URL'si
      • "filename" - dosyanın adı
      • "size" - bayt cinsinden dosya boyutu
      • "mimetype" - dosyanın mime türü
  • "first_message_timestamp" - paketteki en eski mesajın UTC zaman dilimindeki zaman damgası
  • "last_message_timestamp" - paketteki en son mesajın UTC zaman dilimindeki zaman damgası
  • "toplama" - Zaman Çizelgelerindeki ilk mesaja doğrudan bağlantı da dahil olmak üzere, notlar için bir içerik olarak CRM'ler veya benzer sistemlerle kullanıma uygun, HTML formatında toplu mesaj metni.

Örnek

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

Birleştirmeyin

Her mesaj, kullanılabilir hale gelir gelmez ayrı ayrı gönderilir. Hiçbir "demetleme" gerçekleşmez. Aşağıdaki veriler mevcut olacaktır:

  • "whatsapp hesabı" - mesajın alındığı veya gönderildiği whatsapp hesabının (ve hesaba bağlı olan çalışma alanı ekip arkadaşının) ayrıntıları
    • "phone" - WA hesabının telefon numarası
    • "full_name" - WA hesap sahibinin Zaman Çizelgeleri'nde kayıtlı tam adı
    • "email" - WA hesap sahibinin Zaman Çizelgeleri'nde kayıtlı olan e-postası
  • "sohbet" - mesajın gönderildiği veya alındığı sohbetin (doğrudan sohbet veya grup) ayrıntıları
    • "full_name" - sohbet adı (Zaman Çizelgelerinde göründüğü gibi)
    • "responsible_name" - bu sohbete sorumlu olarak atanmış bir ekip arkadaşının adı
    • "responsible_email" - bu sohbete sorumlu olarak atanmış bir ekip arkadaşının e-postası
    • "chat_url" - TimelinesUI'de sohbete erişilebilecek URL
    • "chat_id" - TimelinesUI'deki sohbetin kimliği (sohbet URL'si oluşturmak için veya gelen web kancaları ile kullanılabilir)
    • "is_new_chat" - bu sohbet yeni oluşturulmuşsa true, aksi takdirde false
    • "is_group" - bu sohbet doğrudan bir sohbet ise true, aksi takdirde false
    • "phone" - sohbetin telefon numarası (grup sohbeti için boş)
  • "mesaj" - mesajın ayrıntıları
    • "yön" - "alındı" veya "gönderildi" olabilir
    • "timestamp" - UTC zaman diliminde bir mesajın zaman damgası
    • "message_id" - mesajın dahili benzersiz kimliği
    • "sender" - bir mesajın göndericisinin (sohbet katılımcısı) ayrıntıları
      • "full_name" - Zaman Çizelgeleri'nde bir sohbetin başlığı veya takım arkadaşının adı (Zaman Çizelgeleri içinden gönderiliyorsa)
      • "phone" - gönderenin telefon numarası (veya grup sohbeti için boş)
    • "alıcı" - bir mesajın göndericisinin (sohbet katılımcısı) ayrıntıları
      • "full_name" - Zaman Çizelgeleri'nde bir sohbetin başlığı veya takım arkadaşının adı
      • "phone" - alıcının telefon numarası (veya grup sohbeti için boş)
    • "text" - mesaj metni (düz metin)
    • "attachment" - aşağıdaki alanları içeren, mesaj ekini tanımlayan bir nesne
      • "temporary_download_url" - 15 dakika boyunca geçerli olan geçici bir indirme URL'si
      • "filename" - dosyanın adı
      • "size" - bayt cinsinden dosya boyutu
      • "mimetype" - dosyanın mime türü

Örnek

{
    "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"
            }
        }
}
İçindekiler