Ana içeriğe atla
Developer hub, Flowella REST API üzerinde geliştirme yapmak için ihtiyacınız olanları bir araya getirir. API adresini, son API isteklerinin günlüğünü, kuruluş genelindeki API sandbox anahtarını, hızlı başlangıçları ve API belgelerine bağlantıları gösterir. Açmak için Settings bölümüne gidin, ardından Developer grubunda Developer hub seçeneğini seçin.

​
Kimler kullanabilir

​
API base URL

Bu kart REST API’nin adresini gösterir. Kart /api/v1 ile biten bir adres gösterse bile entegrasyonunuzda temel URL olarak https://api.flowella.io/v1 kullanın. Nedeni için Temel URL bölümüne bakın.

​
Recent API requests

Bu kart, kuruluşunuza API anahtarları veya OAuth erişim belirteçleriyle yapılan en son 25 API isteğini en yeniden başlayarak listeler. Flowella’nın çalıştırmadan önce reddettiği istekler listelenmez. Bunlar arasında eksik veya geçersiz belirteç, eksik kapsam, desteklenmeyen bir API-Version başlığı içeren ya da hız sınırını aşan istekler bulunur. Bir istekle bağlantılı her şeyi (neden olduğu olaylar, işler ve webhook teslimatları gibi) görmek için Request id ile GET /v1/requests/{requestId} çağrısı yapın. account:read kapsamı gerekir. Bkz. İstek kimlikleri.

​
API sandbox

API sandbox kartında, WhatsApp’a hiçbir şey göndermeden test yapmak için kuruluş genelinde bir anahtar bulunur. Rozet, sandbox açıkken Active, kapalıyken Off gösterir. Sandbox guide, uygulamadaki sandbox kılavuzunu açar. Sandbox’ı açmak için bir Owner veya Admin kartın altındaki onay kutusunu işaretler. Sandbox’ı kapatmak için işareti kaldırın. Değişiklik tüm kuruluşa hemen uygulanır. Ayarı { "enabled": true } veya { "enabled": false } gövdesini kullanarak GET /v1/sandbox ve PATCH /v1/sandbox ile de okuyabilir ve değiştirebilirsiniz. Her ikisi de sandbox:manage kapsamını gerektirir.
API sandbox, API çağrılarından fazlasını etkiler. Açıkken uygulamadaki Toplu gönderim ve HubSpot iş akışlarındaki Send WhatsApp Template eylemi de kişilere ulaşmayı durdurur. Gelen kutusundan gönderilen yanıtlar ile Send WhatsApp Message ve Send WhatsApp Reply HubSpot eylemleri yine gerçekten gönderilir. Test etmeyi bitirir bitirmez sandbox’ı kapatın.

​
API sandbox ve sandbox anahtarları

Sandbox’ı kullanmanın iki yolu vardır. Kuruluş genelindeki API sandbox her isteği kapsarken, bir sandbox anahtarı yalnızca o anahtarla yapılan istekleri kapsar.

​
Sandbox’ta neler değişir

Sandbox bir isteği kapsadığında:
  • POST /v1/messages mesajı konuşmada saklar ve metaMessageId değeri null olarak "sandbox": true döndürür. WhatsApp’a hiçbir şey ulaşmaz ve message.sent webhook’u tetiklenmez.
  • POST /v1/templates/{id}/submit ile şablon gönderimi Meta’ya ulaşmaz. Şablonu hemen onaylar veya şablon adı reject_ içeriyorsa reddeder. Örneği yalnızca bir web adresi olan bir medya başlığı 400 INVALID_TEMPLATE_COMPONENTS ile reddedilir. Karar API’de ve olay akışında görünür, ancak uygulamadaki Templates sayfası değişmez.
  • Sandbox gerçek kuruluşunuzda çalışır. Testler sırasında oluşturulan kişiler, konuşmalar ve mesajlar diğerleri gibi saklanır ve uygulamada görünür.

​
Sandbox test araçları

Bu uç noktalar etkinlik simüle etmenize yardımcı olur. sandbox:manage kapsamını gerektirirler ve sandbox açık olsun ya da olmasın çalışırlar, bu nedenle bunları yalnızca test verileriyle kullanın. Test araçları yalnızca olay akışına (GET /v1/events) yazar. Webhook göndermez veya mesajın kendisini değiştirmez.

​
Quickstarts

Quickstarts kartı adım adım kılavuzlara bağlantı verir. Her biri yeni bir sekmede Markdown dosyası olarak açılır.

​
İlgili

API'ye giriş

Kimlik doğrulama, kapsamlar, hız sınırları ve hatalar.

API anahtarları

Canlı ve sandbox anahtarları oluşturun.

Geliştirici uygulamaları

Bir OAuth uygulaması kaydedin ve yüklü uygulamaları yönetin.

Webhook başvurusu

Olay türleri, yükler ve imza kontrolleri.
Son değiştirilme tarihi 24 Ekim 2026