Ana içeriğe atla
Flowella REST API, programlı olarak WhatsApp mesajları göndermenizi, kişileri ve devre dışı bırakmaları yönetmenizi, şablonları listelemenizi ve toplu olarak göndermenizi ve analizleri çekmenizi sağlar. Bu sayfa, bir uç noktayı çağırmadan önce bilmeniz gereken her şeyi kapsar. Tam uç nokta referansı API referansı kenar çubuğunda bulunur (OpenAPI spec’dan otomatik olarak oluşturulur).

​
Temel URL

https://app.flowella.io
Tüm v1 uç noktaları /api/v1 altındadır.

​
Kimlik Doğrulama

Her istek, Authorization başlığında bir API anahtarına ihtiyaç duyar: 
Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx
Anahtarlar kuruluş kapsamlıdır - tek bir Flowella kuruluşu üzerinde hareket ederler ve bu kuruluştaki bir Yöneticinin izinlerini devralırlar.
Anahtarlara parola gibi davranın. Onları asla kaynak kontrolüne işlemeyin, asla sohbete veya paylaşılan belgelere yapıştırmayın ve takım arkadaşları kuruluştan ayrıldığında onları döndürün. Döndürme adımları için Ayarlar → API anahtarları bölümüne bakın.

​
Anahtar oluşturma

API anahtarlarını yönetmek için Owner veya Admin rolüne ihtiyacınız vardır.
  1. Flowella uygulamasında Ayarlar → API anahtarları bölümüne gidin.
  2. Anahtar oluştur** seçeneğine tıklayın ve ona akılda kalıcı bir isim verin.
  3. Anahtarı bir kez kopyalayın - yalnızca oluşturma sırasında gösterilir.
Anahtarlara parola gibi davranın: asla kaynak kontrolüne işlemeyin, asla sohbete yapıştırmayın ve ekip arkadaşları kuruluştan ayrıldığında anahtarları rotasyona tabi tutun.

​
Bir anahtarın doğrulanması

Bir anahtarın geçerli olduğunu doğrulamak için ping uç noktasına basın: 
curl https://app.flowella.io/api/v1/ping \
  -H "Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx"
200 OK ile { "ok": true, "organizationId": "…" } kimliğinizin doğrulandığı anlamına gelir.

​
Hatalar

Tüm hatalar tutarlı bir zarf içinde geri gelir: 
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}
HTTP durumuNe zaman göreceksiniz
400Doğrulama başarısız oldu, hatalı biçimlendirilmiş gövde veya yukarı akış Meta reddi
401Eksik veya geçersiz API anahtarı
402Ödeme gerekli - aboneliğiniz eylemi kapsamıyor
403Yasak - örneğin, devre dışı bırakılmış bir kişiye gönderiliyor veya Meta bağlı değil
404İstenen kanal veya kaynak mevcut değil
429Hız sınırlı - yavaşla
error.code alanı sabittir ve programlı olarak açılması güvenlidir. error.message insan tarafından okunabilir ve değişebilir.

​
Oran sınırları

API anahtarları kuruluş başına oranla sınırlıdır. Sınırı aşarsanız RATE_LIMITED kodlu bir 429 ve Too many requests mesajı alırsınız. Geri çekilin ve üstel gecikmeyle yeniden deneyin. Büyük toplu gönderimler yapıyorsanız, throttlePerHour parametresiyle birlikte POST /api/v1/templates/send seçeneğini tercih edin - Flowella sunucu tarafında gaz kelebeği uygular, böylece istekleri kendiniz hızlandırmanız gerekmez.

​
Sayfalandırma

Liste uç noktaları (/conversations, /contacts, /templates) imleç sayfalama kullanır:
  • limit (1-100, varsayılan 25) ve isteğe bağlı bir cursor iletin.
  • Yanıt, items ve daha fazla sonuç olduğunda bir nextCursor içerir.
  • Bir sonraki sayfayı almak için nextCursor’yi cursor parametresi olarak geri iletin.
  • nextCursor kayıp olduğunda, sonuna ulaştınız demektir.
curl "https://app.flowella.io/api/v1/conversations?limit=50" \
  -H "Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx"

​
Tarih ve saat

Tüm zaman damgaları UTC’de ISO 8601 dizeleridir (örneğin 2025-01-15T14:30:00.000Z). API’nin tarihleri kabul ettiği durumlarda, hem yalnızca tarih (2025-01-15) hem de tam ISO 8601 sunucu tarafında zorlanır.

​
Telefon numaraları

Telefon numaralarını mümkünse E.164 biçiminde (+15551234567) iletin. Flowella yaygın varyasyonları sunucu tarafında normalleştirecektir, ancak E.164 en güvenlisidir.

​
Kanallar

Birçok uç nokta bir whatsappChannelId kabul eder. Kuruluşunuzun tek bir kanalı varsa ve siz bunu atlarsanız, Flowella varsayılan kanalınızı kullanır. Birden fazla kanalınız varsa, yanlış göndericiden göndermekten kaçınmak için kimliği açıkça iletin. Tam URL modeli ve kanal değiştirme için, Çoklu kanal bölümüne bakın.

​
OpenAPI spec

Makine tarafından okunabilir spesifikasyon şu adreste bulunmaktadır: 
/api-reference/openapi.json
Postman, Insomnia veya tercih ettiğiniz kod oluşturucuya bırakın.
Bir entegrasyon mu oluşturuyorsunuz? Durum için yoklama yapmak yerine olaylara tepki vermek için bu sayfayı Webhooks ile eşleştirin.