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)
Oylama gerekmez Flowella’nın maskotu Flo, yüzen bir paneldeki prize büyük bir fişi takıyor
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.

Flo, renkli kabloları bir dağıtım panosuna takıyor
UygulamanızFlowella API’sini çağırır
Örnek veriler

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"]
    }
  ]
}
Flowella’nın yanıtı202 Accepted
{
  "id": "v1ts-3f9a07c2b1d4e6a8",
  "status": "accepted"
}

Kuyrukta. Flowella arka planda gönderir.

Acme Clubİşletme hesabı
Örnek veriler

Bugün

Merhaba Sam, Acme Club üyeliğiniz 31 Ekim'de yenilenecek. Hemen burada, WhatsApp üzerinden bir dakika içinde yenileme işlemini tamamlayın.
Uç noktanızFlowella’nın webhook’larını alır
Örnek veriler

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

data içinde: mesajın messageId değeri.

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ı.

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 Hudson Peter HudsonKabul, Marka ve Müşteri İnovasyonu DirektörüHubSpot Marketplace entegrasyonu Oaklands CollegeOaklands College

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-Endt Lawrence Tribe-EndtTicari Direktör, Countryside AllianceFlowella API üzerinden Customer.io Countryside Alliance

Açık cevaplar.

Geliştiricilerin sorduğu sorular. Sorunuz burada yoksa, bizimle iletişime geçin.

API referansını okuyun

API 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 anahtarlarını yönetme

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.

API tanıtımı

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.

Giden webhook'lar

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.

Flo, yumruğunu havaya kaldırmış ve elinde telefonuyla sevinçten zıplıyor

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