Flowella'yı temel alarak kendi kodunuzu yazın.
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. Webhook’lara abone olarak mesajlara, teslimatlara, abonelik iptallerine, kişilere ve şablon değişikliklerine anında tepki verin; bunu, herhangi bir sorgulama yapmanıza gerek kalmadan gerçekleştirin.
HubSpot Marketplace’te 5/5 puan aldı (yeni sekmede açılır)
- Ana URL
- api.flowella.io/v1
- Kimlik Doğrulama
- flo_ ile başlayan bir taşıyıcı anahtarı
- Webhook olayları
- 12, her biri HMAC-SHA256 ile imzalanmış
- Teslimat
- 3 deneme, 10 saniyelik mola
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 ve Flowella, bir olay meydana gelir gelmez imzalanmış webhook olaylarını uç noktanıza gönderir; böylece siz, sürekli sorgulama yapmak yerine olaylara anında tepki verebilirsiniz. Bir şablon gönderin, ardından olayları takip edin.
Göz açıp kapayıncaya kadar sıraya girdi. Olaylar şöyle gelişti:
İsteği gönderin, ardından gelen olayları izleyin. Göz açıp kapayıncaya kadar sıraya girdi. Olaylar şöyle gelişti: Aynı anahtar, aynı iş. Kimse iki kez alamaz. Yanıtta kelimeler değil, kimlik numaraları yer alır. Cevap yok mu? Toplamda üç kez deneyeceğim, sonra vazgeçeceğim.
POSThttps://api.flowella.io/v1/templates/send
Başlıklar
- Authorization
Bearer flo_••••••••••••API anahtarınız, gizlenmiş- Content-Type
application/json- Idempotency-Key
renewal-2026-10-16-1Bu anahtarı yedi gün içinde yinelemek aynı işi döndürür.
Gövde
{
"templateId": "cltemplate00000001",
"whatsappChannelId": "clchannel000000001",
"recipients": [
{
"phone": "+447700900123",
"bodyParameters": ["Sam"]
}
]
}
{
"templateId": "cltemplate00000001",
"whatsappChannelId": "clchannel000000001",
"recipients": [
{
"phone": "+447700900123",
"bodyParameters": ["Maximiliana-Wolfgang"]
}
]
}
{
"id": "v1ts-3f9a07c2b1d4e6a8",
"status": "accepted"
}
{
"id": "v1ts-3f9a07c2b1d4e6a8",
"status": "accepted"
}
Kuyrukta. Flowella arka planda gönderir.
Kuyrukta. Flowella arka planda gönderir. Aynı anahtar, aynı iş: hiçbir şey iki kez gönderilmedi. Kabul edildi, ancak Maximiliana-Wolfgang bu kanalda aboneliğini sonlandırdı, bu yüzden Flowella göndermeyecek.Bugün
Teslimatlar
POSThttps://example.com/webhooks/flowella
- Content-Type
application/json- X-Flowella-Signature
5c2e91…a07f3bGeçerli
{
"id": "evt_9a4f1d06c3e84b27a5d9e2b70c6f8d14",
"type": "message.read",
"created_at": "2026-10-16T09:14:21.000Z",
"payload_version": "1",
"data": { … }
}
{
"id": "evt_5b0e2c7d91f64a38b2c6d0e4f7a19c53",
"type": "message.delivered",
"created_at": "2026-10-16T09:14:03.000Z",
"payload_version": "1",
"data": { … }
}
data içinde: mesajın messageId değeri.
data içinde yok: telefon numarası ve mesaj metni.
data içinde: messageId, conversationId, contactId, direction, type ve metaMessageId.
data içinde yok: telefon numarası ve mesaj metni.
data içinde: mesajın messageId değeri.
data içinde: telefon numarası ve neden.
Flowella, 2xx kodlu bir yanıt gelmesi için en fazla 10 saniye bekler ve her bir gönderimi, 1 ve 2 saniye aralıklarla en fazla 3 kez dener.
message.sent, message.delivered ve message.read uç noktanıza ulaştı; her biri imzalı.
İsterseniz adı değiştirin, ardından isteği gönderin. İstek gönderiliyor. 202 Accepted: Flowella gönderimi kuyruğa aldı ve hemen bir iş kimliği döndürdü. message.sent, message.delivered ve message.read uç noktanıza ulaştı; her biri imzalı. Aynı Idempotency-Key, bu yüzden Flowella aynı işi döndürdü ve hiçbir şeyi iki kez göndermedi. Maximiliana-Wolfgang adlı kişinin yanıtı message.received olarak geldi: kimlikler, yön ve tür; sözcükler değil. STOP, Maximiliana-Wolfgang adlı kişinin aboneliğini sonlandırdı: önce message.received, ardından telefon numarası ve nedenle birlikte optout.created geldi. Uç noktanız yanıt vermiyor, bu yüzden Flowella 1 saniye sonra, ardından 2 saniye sonra yeniden dener. Flowella 3 denemeden sonra durdu. Uç noktanızı yeniden açın, ardından yeni bir anahtarla gönderin. Uç noktanız yanıt verdi, bu yüzden teslimat yeniden denemede gerçekleşti. 202 Accepted, ancak Maximiliana-Wolfgang STOP ile aboneliğini sonlandırdı, bu yüzden Flowella şablonu göndermeyecek.12 etkinlikten herhangi birine kaydolun.
Ayarlar > Webhook'lar bölümünden ihtiyacınız olan olayları seçin. Her bir olay, kendine özgü bir kimlik numarası, türü, gerçekleşme zamanı ve verileriyle birlikte imzalı bir POST isteği olarak gelir.
Mesajlar
message.received- Bir kişiden gelen bir WhatsApp mesajı ulaşıyor
message.sent- Flowella mesajınızı kabul etti ve Meta’ya iletti
message.delivered- Meta, alıcının cihazına teslimatın gerçekleştiğini doğruladı
message.read- Alıcı mesajı açtı
message.failed- Meta, mesaj için bir hata döndürdü
Sohbetler
conversation.opened- Bir sohbet "açık" durumuna geçti
conversation.closed- Bir sohbet sonlandırıldı
Vazgeçme seçenekleri
optout.created- Bir kişi bir kanaldan aboneliğini iptal etti
Şablonlar
template.status_updated- Meta, bir şablonun durumunu değiştirdi: onaylandı, reddedildi, askıya alındı veya devre dışı bırakıldı
İletişim Bilgileri
contact.created- Bir kişi kaydedildi
contact.updated- Bir kişi bilgisi güncellendi
contact.deleted- Bir kişi silindi
Ayrıca webhook.test; bu, yalnızca “Test Gönder” düğmesine bastığınızda gönderilir.
Gönderin, yönetin ve raporlayın.
api.flowella.io/v1 adresinde bulunan, taşıyıcı anahtarlı kimlik doğrulamaya sahip ve öngörülebilir davranış sergileyen, kullanımı kolay bir v1 REST API.
-
Mesajlar ve şablonlar gönderin
WhatsApp metin mesajı gönderin ya da tek bir istekle birden fazla alıcıya bir şablonu sıraya alın. throttlePerHour parametresini ekleyin; Flowella, büyük ölçekli gönderim işlemini sizin için düzenler.
-
İletişim ve abonelikten çıkma
Kişileri oluşturun veya güncelleyin, kişiler arasında gezinin ve bir kanalda bir kişinin WhatsApp'tan çıkma tercihini ayarlayın veya kaldırın.
-
Sohbetler ve analizler
Sohbetleri ve şablonları listeleyin ve giden mesaj analizlerini kendi raporlamanıza aktarın.
-
Kontrol ettiğiniz tuşlar
Sahipler ve yöneticiler, Ayarlar bölümündeki API anahtarları altından anahtarlar oluşturur. Her anahtarın adı flo_ ile başlar, yalnızca bir kez görüntülenir ve gerekli kapsamlarla sınırlandırılabilir.
-
Tekrar denemek güvenlidir
Bir şablon gönderimi ile bir Idempotency-Key gönderildiğinde ve yedi gün içinde tekrarlandığında aynı iş geri döndüğünden, zaman aşımı durumunda hiç kimseye iki kez mesaj gönderilmez.
-
Önce kodsuz, gerektiğinde kodla
HubSpot iş akışları, kod yazmaya gerek kalmadan halihazırda her bir kişi için en fazla 20 değişken içeren şablonlar gönderebiliyor. Tek kullanımlık kodlar ve kişiye özel bağlantı düğmeleri gibi gönderilemeyen öğeler için API’yi kullanın.
Müşterilerimizin sözleriyle.
Aynı gün yapılan başvuruları %160 artırarak ve WhatsApp yanıt oranlarını %90'a yükselterek öğrenci kazanımımızı kökten değiştiren olağanüstü bir etkileşim platformu.
Peter HudsonKabul, Marka ve Müşteri İnovasyonu Direktörü
Kusursuz otomasyon ve önemli ölçüde daha yüksek tamamlanma oranları ile WhatsApp üzerinden kişiselleştirilmiş etkileşim sağlayan, sektörde çığır açan bir bağış kampanyası aracı.
Lawrence Tribe-EndtTicari Direktör, Countryside Alliance
Açık cevaplar.
Geliştiricilerin sorduğu sorular. Sorunuz burada yoksa, bizimle iletişime geçin.
API referansını okuyunAPI ve webhook'lar
Kimlik doğrulamasını nasıl yaparım?
Yetkilendirme başlığında kuruluş kapsamlı bir taşıyıcı anahtar bulunur. Sahipler ve Yöneticiler, Ayarlar > API anahtarları bölümünden anahtarlar oluşturur. Her anahtarın adı flo_ ile başlar ve yalnızca bir kez görüntülenir; bu nedenle anahtarı güvenli bir şekilde saklayın ve ekip arkadaşlarınız ayrıldığında anahtarı yenileyin.
API ne yapabilir?
WhatsApp mesajları ve şablonları (tek kullanımlık kodlar ve kişi başına bağlantı düğmeleri dahil) gönderin, kişiler oluşturun ve güncelleyin, abonelik iptallerini ayarlayın veya kaldırın, sohbetleri ve şablonları listeleyin ve giden mesaj analizlerini alın. Uç nokta listesi, doğrudan Postman’a veya bir kod oluşturucuya aktarılabilen OpenAPI spesifikasyonundan alınmaktadır.
Tek kullanımlık kodlar veya kişi başına bağlantı düğmeleri gönderebilir miyim?
Evet, API aracılığıyla ve sadece bu yolla. “Kodu kopyala” düğmesi her gönderimde kendi koduna ihtiyaç duyar ve kişi başına bir bağlantı düğmesi oluşturma işlevi yalnızca API tarafından sağlanır: HubSpot iş akışından gönderildiğinde, herkes şablonun tek yedek bağlantısını alır. HubSpot'tan kişi başına bir bağlantı göndermek için, bunu bir gövde değişkenine yerleştirin; WhatsApp bu bağlantıyı tıklanabilir hale getirir. Kodlar en fazla 15 karakter uzunluğunda olabilir ve 15 saniye içinde aynı numaraya aynı şablonun gönderilmesi engellenir. scheduledAt ayarını yapmadığınız sürece, API 202 yanıtını verir ve gönderimi tek seferde gerçekleştirir.
İlk görüşmemden önce neleri bilmem gerekir?
Temel URL https://api.flowella.io/v1 şeklindedir. Listelerde 1 ile 100 arasında bir sınırla imleç tabanlı sayfalandırma kullanılır; hatalar, sabit bir kod içeren tek bir zarfı paylaşır ve her kuruluş için hız sınırlaması uygulanır; çok hızlı hareket ederseniz 429 hatası ve Retry-After başlığı gönderilir. Telefon numaralarını E.164 biçiminde iletin.
Büyük toplu gönderimler yapabilir miyim?
Evet. POST /v1/templates/send komutu, gönderimi kuyruğa alır ve bir iş kimliği içeren 202 Accepted yanıtını verir. throttlePerHour parametresini ekleyin; Flowella, sunucu tarafında gönderimi düzenler. Bir Idempotency-Key ekleyin; yedi gün içinde tekrarlanan bir istek, yeniden gönderim yapmak yerine aynı işi döndürür.
Bir web kancasının gerçek olduğunu nasıl doğrularım?
Her iletim, imzalama gizli anahtarınızla oluşturulan ham gövdenin HMAC-SHA256 onaltılık özeti olan X-Flowella-Signature'ı içerir. Herhangi bir JSON ayrıştırma işleminden önce ham baytlar üzerinden aynı özeti hesaplayın ve karşılaştırın. Gizli anahtar değiştirme işlemi sırasında, X-Flowella-Signature-Previous, eski gizli anahtarla oluşturulan özeti içerir.
Uç noktam kapalıysa ne olur?
Flowella, 2xx kodlu bir yanıt gelene kadar en fazla 10 saniye bekler ve her gönderimi, 1 ve 2 saniye aralıklarla en fazla 3 kez dener; bu nedenle hızlı bir şekilde yanıt verin ve işinizi daha sonra halledin. Ayarlar bölümündeki Webhooks sayfasında, her bir uç noktanın son gönderimleri listelenir.
Mükerrerlerin işlenmesini nasıl önleyebilirim?
Bir yeniden deneme, aynı olayı iki kez iletebilir. Her iletimde en üst düzeyde olayın kimliği bulunur ve bu kimlik her yeniden denemede aynıdır; bu nedenle, işlediğiniz kimliklerin kısa süreli bir kaydını tutun ve tekrarları hiçbir işlem yapılmamış gibi değerlendirin.
message.received, mesaj metnini içerir mi?
Hayır. Mesaj, sohbet ve kişi kimliklerini, yön ve türü içerir; ancak telefon numarası veya metin içermez ve API’da tek bir mesajı okumaya yönelik bir çağrı yoktur. optout.created ise telefon numarasını ve nedeni içerir.
Aynı motoru temel alarak, kendi tarzınızda geliştirin.
Önce kod yazmaya gerek olmayan araçlarla başlayın, ardından sisteminizin daha fazlasına ihtiyaç duyduğunda API ve webhook’lara geçin. Flowella’nın kurulumu yaklaşık 30 dakika sürer; 14 günlük ücretsiz deneme süresi vardır ve kredi kartı bilgisi gerekmez.
Flowella demosuna kaydolun · Teams üzerinden 30 dakika