API & WEB KİTAPLARI

Flowella'yı temel alarak, programlama yoluyla geliştirin.

Kod yazmaya gerek olmayan araçlar bir konuyu kapsamadığında, Flowella REST API'si ve giden webhook'lar devreye girer. WhatsApp mesajları göndermek, kişileri ve abonelik iptallerini yönetmek ve analiz verilerini almak için API'yi çağırın. Mesajlara, teslimatlara, abonelik iptallerine ve şablon değişikliklerine gerçek zamanlı olarak yanıt vermek için webhook'lara abone olun; bu işlem için sürekli kontrol etmeye gerek yoktur.

Uygulamanızın bir şablon göndermek için Flowella REST API'sini çağırmasını ve Flowella'nın message.received ve message.delivered gibi imzalı webhook olaylarını uç noktanıza geri göndermesini gösteren bir diyagram
Birbirine nasıl uyuyor

Arayın, bırakın sizi geri arasın.

İki yön, tek motor. Uygulamanız, işlemleri gerçekleştirmek için REST API’yi çağırır: şablon gönderme, kişi bilgilerini güncelleme, analiz verilerini alma gibi. Diğer yönde ise, Flowella bir olay meydana gelir gelmez imzalanmış webhook olaylarını uç noktanıza gönderir; böylece sürekli sorgulama yapmak yerine anında tepki verebilirsiniz. Bu iki unsur bir araya geldiğinde, aynı WhatsApp ve HubSpot motoru üzerine yığınınızın ihtiyaç duyduğu her şeyi oluşturmanıza olanak tanır.

REST API

Gönder, yönet ve raporla

Bearer anahtarı kimlik doğrulamasına sahip ve öngörülebilir davranış gösteren, kullanımı kolay bir v1 REST API.

REST API sürümü v1 olup, https://app.flowella.io/api/v1 adresinde bulunur. Her istek, Yetkilendirme başlığında kuruluş kapsamlı bir taşıyıcı anahtar içerir; bu anahtar, Ayarlar > API anahtarları bölümünden bir Sahip veya Yönetici tarafından oluşturulur ve yalnızca bir kez görüntülenir. Liste uç noktaları, bir ile yüz arasında bir sınırla imleç sayfalandırması kullanır, hatalar sabit bir kod alanı içeren tutarlı bir zarf içinde geri döner ve istekler, çok hızlı gittiğinizde 429 ile kuruluş başına hız sınırlamasına tabidir. Telefon numaraları en iyi şekilde E.164 biçiminde iletilir ve makine tarafından okunabilir bir OpenAPI spesifikasyonu doğrudan Postman'a veya bir kod üretecine düşer.

Büyük toplu gönderimler için, şablon gönderme uç noktası saat başına sınırlama parametresini kabul eder, böylece Flowella sunucu tarafında teslimatı hızlandırır ve istekleri kendiniz hızlandırmanıza gerek kalmaz.

Giden web kancaları

Olaylara gerçek zamanlı olarak tepki ver

İlgilendiğiniz etkinliklere abone olun; olaylar gerçekleştiğinde Flowella size imzalı bir veri gönderir.

OlayTetiklendiğinde
message.receivedBir kişiden gelen WhatsApp mesajı geldiğinde
message.sentFlowella, giden mesajınızı kabul etti ve Meta'ya gönderdi
message.deliveredMeta, alıcının cihazına teslimatı onayladı
message.readAlıcı mesajı açtı
message.failedMeta, mesaj için bir hata döndürdü
konuşma.açıldı / kapatıldıBir sohbetin durumu değişti
optout.createdBir kişi bir kanaldan çıkmıştır
şablon.durum_güncellendiMeta bir şablonun durumunu değiştirdi

Her istek, ham gövdenin HMAC-SHA256 onaltılık özetiyle imzalanır, bu nedenle işleme almadan önce imzayı doğrulayın. Flowella, 2xx yanıtı için en fazla on saniye bekler, geri çekilme ile en fazla üç kez yeniden dener ve on ardışık başarısızlıktan sonra bir uç noktayı otomatik olarak devre dışı bırakır. Yeniden denemeler bir olayı tekrarlayabileceğinden, olay kimliğini idempotans anahtarı olarak kullanın ve yinelenenleri hiçbir işlem yapılmamış gibi değerlendirin.

Hangisi ne zaman kullanılmalı

Önce kodsuz, gerektiğinde kodla.

API, ürünü genişletir. Kod gerektirmeden halihazırda çalışan bileşenlerin yerini almaz.

Yerleşik araçlar

Yaygın işler için buradan başlayın.

Ekiplerin ihtiyaç duyduğu şeylerin çoğu, şablon gönderme, Akış yanıtlarını yakalama, otomasyonu tetikleme, API'ye dokunmadan zaten karşılanmaktadır. Yalnızca bunun ötesinde bir şeye ihtiyacınız olduğunda koda ulaşın.

  • Formdan Akışa, yerel HubSpot senkronizasyonu
  • İş akışı eylemleri ve gelen kutusu
  • Yazılacak kod yok
Acme Insurance Business · online
Hi Anna 👋 just checking — are you still keen to renew your policy this year? 09:14
ohh hi yeah maybe? remind me what plan I'm on? 11:42
You're on the Standard plan. Happy to send the renewal link? 11:43
actually can we chat tomorrow? today is mad 11:46
Of course — what time works? 11:47
idk friday maybe? 😅 14:08
KOD YOK EN HIZLI EN ÇOK TAKIM
API ve web kancaları

Daha fazlasına ihtiyacınız olduğunda kodlara ulaşın.

WhatsApp'ı özel bir sisteme bağlamanız, yerel bağlayıcısı olmayan bir araçla senkronize etmeniz veya kendi arka ucunuzdaki olaylara tepki vermeniz gerektiğinde, API ve web kancaları size tam kontrol sağlar.

  • Özel uygulamalar ve ısmarlama entegrasyonlar
  • Yoklama yapmadan olaylara tepki verme
  • Sunucu tarafı kısıtlama ile toplu gönderimler
Cancel Renew with Acme
Hi Anna — pick the plan that suits you. We'll auto-renew and send your receipt here in WhatsApp.
  • 30 seconds · Card on file
  • With · Membership team
  • Receipt sent here after renewal

Choose your plan

  • Quarterly · £15
  • Monthly · £6
Confirm renewal

Powered by Flowella · Secure renewal

PROGRAMATİK GERÇEK ZAMANLI ESNEK
SSS

Açık cevaplar.

Geliştiricilerin sorduğu sorular.

Kimlik doğrulamasını nasıl yaparım?

Bir Sahip veya Yönetici tarafından Ayarlar > API anahtarları bölümünden oluşturulan, kuruluş kapsamındaki bir taşıyıcı anahtardır. Bu anahtar, oluşturulduğunda yalnızca bir kez görüntülenir; bu nedenle güvenli bir şekilde saklayın ve ekip arkadaşlarınız ayrıldığında anahtarı yenisiyle değiştirin.

API ne yapabilir?

WhatsApp mesajları ve şablonları gönderin, kişileri ve abonelik iptallerini yönetin, şablonları listeleyin ve toplu olarak gönderin, ayrıca analiz verilerini alın. Tam uç nokta listesi, OpenAPI spesifikasyonundan otomatik olarak oluşturulur.

Büyük toplu gönderimler yapabilir miyim?

Evet. Şablonların gönderme uç noktasını "saat başına sınırlama" parametresiyle kullanın; Flowella bu sınırlamayı sunucu tarafında uygular, böylece zamanlama veya isabet oranı sınırlarını kendiniz yönetmenize gerek kalmaz.

Bir web kancasının gerçek olduğunu nasıl doğrularım?

Her webhook, ham istek gövdesinin HMAC-SHA256 özetiyle imzalanır. İmza anahtarınızla aynı özeti hesaplayın ve karşılaştırın; bunu, herhangi bir JSON ayrıştırma işleminden önce ham baytlar üzerinde imza atarak yapın.

Uç noktam kapalıysa ne olur?

Flowella, geri çekilme mekanizmasıyla en fazla üç kez yeniden deneme yapar ve on kez üst üste başarısızlık durumunda uç noktayı otomatik olarak devre dışı bırakır. Uç noktanız düzeltildikten sonra, Ayarlar > Webhook'lar bölümünden yeniden etkinleştirin.

Mükerrerlerin işlenmesini nasıl önleyebilirim?

Olay kimliğini idempotans anahtarı olarak kullanın, işlenmiş anahtarların kısa süreli önbelleğini tutun ve tekrarları hiçbir işlem yapmayan komutlar olarak değerlendirin. Yeniden denemeler, aynı olayın birden fazla kez gelebileceği anlamına gelir.

Bilgi tabanı

Geliştirici belgelerini okuyun

Bu sayfadaki tüm içerik, eksiksiz kaynakça ve kod örnekleriyle birlikte belgelerde yer almaktadır.

Geliştirici kılavuzunun tamamı bilgi bankasında yer almaktadır.

API tanıtımı, temel URL, kimlik doğrulama, hatalar, sayfalandırma, hız sınırları ve OpenAPI spesifikasyonunu kapsamaktadır.

Giden webhook'lar, kod örnekleriyle birlikte webhook yapılandırmasını, tam olay listesini, imza doğrulamasını, yeniden denemeleri ve idempotensi kapsar.

API belgelerini açın →

Sonraki adım

Aynı motoru temel alarak, kendi tarzınızda geliştirin.

Flo, Flowella maskotu