Nasıl Yardımcı Olabiliriz?

Gelen Webhook Entegrasyonu

Üzerinde Oluşturuldu

TimelinesAI, halihazırda kullandığınız araçlardaki olaylara veya eylemlere yanıt olarak WhatsApp mesajları göndermeyi otomatikleştirmenize olanak tanır: CRM, Destek, İşe Alım sistemleri vb.

"Mesaj gönder" Olayı

TimelinesAI'ye belirli bir kişiye (bir grup olabilir) bir mesaj (dosya eki olan veya olmayan) gönderme talimatı vermek mümkündür. Çalışma alanınızda birden fazla WhatsApp hesabı bağlıysa, mesajın gönderilmesi için kullanılacak belirli bir WhatsApp hesabını belirtmek de mümkündür.

Entegrasyonu kurmak için, bir çalışma alanı sahibi "Entegrasyonlar / Gelen Web Kancaları" ekranına gitmeli ve yeni URL oluşturmalıdır. Harici sistem bu URL'ye belirli formatta (aşağıdaki ayrıntılara bakın) mesaj göndermelidir.

Sınırlamalar

  • Maksimum ek boyutu 2 MB'dir.
  • Alıcının telefon numarası formatının veya WhatsApp bağlantısının anında doğrulanması söz konusu değildir. Mesajların gönderilme / okunma durumunu doğrulamak için Zaman Çizelgeleri kullanıcı arayüzüne gidin.

Gelen Web Kancaları ile Dosya Gönderme

Dosya Gönderme: Doğrudan İndirme vs Dosya Barındırma Hizmetleri

Dosyaları Doğrudan İndirme Bağlantılarını kullanarak göndermek zorunludur. Bu, alıcının dosyayı gerçekten almasını sağlar.

Oysa doğrudan indirme bağlantısı sağlayabilmesi için bir dosya barındırma hizmeti kullanılmalıdır. Böyle bir bağlantı en iyi gizli/özel tarama yoluyla test edilir; bağlantıyı arama çubuğuna yapıştırarak. Dosya indirme işlemi hemen başlarsa bağlantı kabul edilebilir. Bunun yerine herhangi bir web sayfası görüntüleniyorsa, bağlantı dosya göndermek için kullanılamaz.

Dosya Barındırma Hizmeti bağlantılarında durum, dosyaların indirilememesidir. Bunun yerine indirilen ve gönderilen şey, "bozuk" bir dosyaya yol açabilecek bir paylaşım web sayfasıdır.

Bu da mesajınızı etkileyecektir çünkü alıcılar gönderdiğiniz medyaya erişemeyecek ve dosyalar kullanılamaz hale gelecektir. Bu nedenle, doğrudan indirme bağlantıları gönderdiğinizden emin olmanız çok önemlidir, çünkü bu, dosyaya herhangi bir sorun yaşamadan erişmelerini sağlayacaktır.

Bu testi, test numaralarınızdan birine bir web kancası mesajı göndererek de çalıştırabilirsiniz. Burada incelediklerimize dayanarak dosyanın nasıl davranacağını belirleyebileceksiniz; eke tıkladıktan sonra "Dosya Bozuk", "Uyumsuz Dosya"; veya "X belgesi yüklenemedi" gibi bir hata mesajı alırsanız, bu bir Dosya Barındırma Hizmeti Bağlantısıdır ve Doğrudan İndirme Bağlantısı ile değiştirilmelidir.

Kredi Kullanımı

  • Bir mesaj göndermek, mesaj gönderme kotasından 1 kredi tüketir.
  • Boş olmayan metin ve ek içeren bir mesaj göndermek, mesaj gönderme kotasından 2 kredi tüketir.
  • Bir mesaj gönderilemiyorsa (geçersiz veya WhatsApp numarasına bağlı değil, WhatsApp sunucu hatası), mesaj gönderme kotası geri yüklenir (genellikle birkaç saat içinde).

Mesaj gönderme hızı

  • Mesajlar, her iki mesaj arasında yaklaşık 2 saniyelik rastgele gecikme ile gönderilecektir (WhatsApp spam algılama mekanizmalarından kaçınmak için).
  • Web kancalarını 2 saniyeden daha az sıklıkta etkinleştirirseniz, mesajlar sıraya alınır ve gecikmeli olarak gönderilir. Kuyruğa alınan her mesaj bir mesaj gönderme kredisi tüketecektir, bu nedenle kuyruğa alınan mesajların sayısı mevcut kotayı aşamaz.

Web kancası yapılandırması ve eylemleri

  • "Webhook enabled" - webhook'u tamamen kaldırmadan devre dışı bırakmaya izin verir
  • "Yeni URL oluştur" - bildirimleri kabul edecek yeni bir benzersiz URL oluşturacaktır. Önceki URL artık kullanılamayacaktır.
  • "Son gönderme denemeleri" - son web kancası etkinleştirme denemelerinin durumu
  • "İndirme günlüğü" - son 100 etkinleştirme denemesinin ayrıntılı bir gün lüğü, biçimlendirme sorunlarını gidermeye yardımcı olur.

Web kancası istek biçimi

Web kancası, POST isteği aracılığıyla JSON biçimindeki verileri kabul eder.

  • "action" (zorunlu) - şu anda yalnızca bir olası değer "send" desteklenmektedir
  • "text" (zorunlu)- gönderilecek düz metin UTF-8 kodlu mesaj ("\n" satır ayırıcısı dışında işaretleme desteklenmez), dosya belirtilmişse boş bırakılabilir.
  • "file_url" (isteğe bağlı) - indirilecek ve ek olarak gönderilecek bir dosyanın herkes tarafından erişilebilir URL'si.
  • "file_name" (isteğe bağlı) - ek için bir ad (URL belirtilmişse sağlanmalıdır).

Alıcı, aşağıdaki parametrelerden biri sağlanarak belirtilebilir:

  • "chat_id" - TimelinesAI'de göründüğü gibi sohbetin kimliği (sohbet sayfasının URL'sinde veya giden web kancasının yükünde bulunabilir). Bu, bir gruba mesaj göndermeyi destekler.
  • "jid" - kişi veya grubu belirten bir WhatsApp JID'si
  • "telefon" - uluslararası telefon numarası standardına göre biçimlendirilmiş bir telefon numarası, yani:
    [+][ülke kodu][alan kodu][yerel telefon numarası] (örneğin: +14151231234)
  • "chat_name" - TimelinesAI'de göründüğü gibi sohbetin tam adı

Çalışma alanında birden fazla WhatsApp hesabı bağlıysa, kullanılacak WhatsApp hesabını belirtmek için aşağıdaki ek parametreyi kullanın:

  • "whatsapp account phone" (isteğe bağlı) - göndermek için kullanacağımız WhatsApp hesabını belirtir (telefon numarası olarak, uluslararası formatta). Atlanırsa, gönderme için çalışma alanındaki en son bağlanan etkin WhatsApp hesabı kullanılır. Not: "chat_id" parametresi belirtilirse, "whatsapp account phone" dikkate alınmayacaktır, çünkü her sohbet zaten belirli bir WhatsApp hesabına bağlıdır.

Web kancası yanıtı

Başarı durumunda (istek doğrulandı ve gönderilmek üzere kabul edildi), Webhook HTTP durumu 200 ve oluşturulan mesajın message_id'sini içeren JSON ile yanıt verecektir:

{
    "status": "success",
    "data": {
        "message_id": "wa_backend:3EB09FCC85FE99662E46"
    }
}

 

Hata durumunda, Web kancası HTTP durumu 40X ve hatanın ayrıntılarını içeren JSON ile yanıt verecektir, örneğin:

{
"status": 40X,
"data": {},
"message": "Webhook not found"
}

Örnekler

Örnek 1 - belirli bir WA hesabı üzerinden belirli bir telefon numarasına mesaj gönderme:

{
"action": "send",
"whatsapp account phone" : "+15105566777", 
"phone": "+14151231234", 
"text": "lorem ipsum"
}

Örnek 2 - id ile belirtilen bir sohbete (veya gruba) metin ve ek içeren bir mesaj gönderme:

{
"action": "send", 
"chat_id": "77234", 
"text": "lorem ipsum"
"file_url" : "https://150588669.v2.pressablecdn.com/logo.png",
"file_name" : "logo.png"
}
admin tarafından yazılan son gönderiler (tümünü gör)
İçindekiler