REST API

tawk.to REST API, temsilcileriniz adına görevleri otomatikleştirerek zamandan tasarruf etmenizi sağlar.


Bir tawk.to varlığının her bir Yöneticisi, tawk.to'dan üçüncü taraf bir sisteme veri göndermek için web kancalarımızı kullanabilir. Örneğin, bir bilet oluşturulduğunda bir elektronik tabloya veya proje yönetim panosuna yeni bir girdi eklemek için web kancalarını kullanabilirsiniz.


Web kancaları üç tür olay için oluşturulabilir:

  • Sohbet Başlangıcı
  • Sohbet Sonu
  • Bilet Oluşturuldu


REST API'miz, tawk.to'dan ek veri talep etmenize olanak tanır.


Not: REST API'yi kullanmak için bir geliştiriciye ihtiyacınız olacaktır veya kod yazabiliyor olmalısınız.

REST AP'yi kullanmaya başlamak

REST API'yi kullanmak için önce erişim talep etmeniz gerekir: 

https://www.tawk.to/rest-api-beta-access-request/


Talebiniz onaylandığında, kullanıcı adı ve şifre içeren belgelere erişmenizi sağlayan bir bağlantı alacaksınız.

REST API ile neler yapabilirsiniz?

Kaynakları almak, oluşturmak, güncellemek ve silmek için REST API'yi kullanabilirsiniz. İşte tawk.to'da REST API'yi kullanmanın yollarından birkaçı:


  • Müşterileriniz için otomatik olarak varlık oluşturun
  • Bir müşteriyi otomatik olarak bir varlığa davet edin
  • Bir konuşma geçmişini okuyun.
  • Web kancalarını yönetin
  • Otomatik olarak yeni bir sekme oluşturun
  • Bilgi Tabanınızı yönetin
  • Yeni bir Bilgi Tabanı makalesi oluşturun
  • Bir varlık için Bilgi Tabanı makalelerini ve kategorilerini listeleyin
  • Varlığınız için yeni bir sohbet aracı'ı oluşturun veya varolanı silin.
  • Araç kartı ekleyin,kaldırın veya varolanları güncelleyin
  • Biletlerin, sohbetlerin veya varlık üyelerinin filtrelenmiş bir listesini alın
  • Belirli sohbet istatistiklerini alın
  • Bir varlığın sohbet istatistiklerini temsilci, etiket, departman, tarih ve daha fazlasına göre filtreleyin.

İstekte bulunma

API, tamamı https://api.tawk.to/v1/YONTEM biçimindeki HTTP RPC tarzı yöntemlerden oluşur.


Tüm yöntemler HTTPS kullanılarak çağrılmalıdır. Argümanlar, bir POST isteğinin gövdesinde iletilebilir. Yanıt, yanıtın başarılı veya başarısız olduğunu gösteren, üst düzey bir boole özelliği içeren bir JSON nesnesi içerecektir. Hata sonuçları için error özelliği, makine tarafından okunabilen kısa bir hata kodu içerecektir.


Tüm istekler için kimlik doğrulaması yapmalısınız ve tüm istekler HTTPS üzerinden yapılmalıdır.

Kimlik doğrulama

API anahtarı

Bir API anahtarı kullanıyorsanız, isteklerin kimliği HTTP Temel Kimlik Doğrulaması aracılığıyla doğrulanır.


REST API'ye beta erişimi istemek için destek ekibimizle iletişime geçin. Etkinleştirildikten sonra, bir REST API anahtarı almak için lütfen aşağıdaki adımları izleyin:


1. tawk.to Panelinizde oturum açın

2. Sağ üst köşedeki Profil Fotoğrafınızı seçin

3. Açılır menüden Profili Düzenle'ye tıklayın

4. REST API Anahtarları’nı seçin

5. Yeni bir anahtar almak için Anahtar Oluştur'a tıklayın

OAuth2

OAuth2 kullanıyorsanız, OAuth2 akışını izleyerek bir erişim tokenı almanız gerekir.


Şu anda iki yetkilendirme akışını destekliyoruz: bir yetkilendirme kodu ve Implicit Grant flow


Yetkilendirme kodun kullanırken, önce kodu almanız gerekir. Ardından, onu bir erişim tokenı ve bir yenileme tokenı ile değiştireceksiniz. Değişim, müşteri gizli anahtarınızı girmenizi gerektirir ve sunucu tarafında yapılmalıdır. Müşteri sırrı gizli tutulmalıdır. Müşteri sırrınızı e-posta, yerel uygulamalar, JavaScript veya genel kod depoları aracılığıyla dağıtmayın. Erişim tokenının geçerliliğini uzatmak için bir yenileme tokenı kullanabilirsiniz.


Implicit Grant flow kullanırken, kısa ömürlü ve genişletilemeyen erişim tokenları alabilirsiniz. Bir müşteri, kimlik bilgilerinin gizliliğini koruyamıyorsa (örneğin, yerel uygulamalarla çalışırken, istemci tarafı JavaScript, vb.) Implicit Grant flow kullanılmalıdır.

Beta erişimi iste

REST API'sine erişim talebinde bulunun: REST API'ye beta erişimi alın


JavaScript API Belgelerimizi tawk.to Geliştirici Platformunda görüntüleyin.

Bu makale size yardımcı oldu mu?

113 kişi içerisinden 78 kişi bu makaleyi beğendi