Geliştirici değişiklik günlüğü: API, webhook, OAuth ve MCP

Flow yaşam döngüsü

• GET /v1/flows/{id}, Flow’un Meta’daki durumunu (metaStatus), ekranlarını, alanlarını ve gönderme eylemini döndürür.
• POST /v1/flows/{id}/publish?dry_run=true bir Flow’u yayımlamadan kontrol eder.
• POST /v1/flows/{id}/deprecate bir Flow’u Meta’da kullanımdan kaldırır. Meta bunu geri alamaz. Şablonlar Flow’u hâlâ kullanıyorsa, force göndermediğiniz sürece Flowella bunu engeller.
• DELETE /v1/flows/{id}, bir HubSpot formundan oluşturulan Flow için 409 HUBSPOT_FLOW_MANAGED, bir şablon taslağı Flow’u hâlâ kullanırken 409 FLOW_REFERENCED_BY_TEMPLATES döndürür. Bir Flow’u silmek onu Meta’da asla silmez: orada kullanımdan kaldırmak için önce deprecate işlemini yapın. Kullanımdan kaldırılmış bir Flow’u yayımlamak 409 FLOW_DEPRECATED döndürür.
• Bir şablon oluşturduğunuzda bir Flow düğmesi, Meta Flow kimliği yerine flowellaFlowId ile bir Flowella Flow’unu gösterebilir.
• API üzerinden oluşturduğunuz Flow’lar MAIN_FORM giriş ekranıyla yayımlanır. Daha önce yayımladığınız Flow’lar çalışmaya devam eder. Bunları flowellaFlowId ile kullanmadan önce yeniden yayımlayın.

Webhook’lar

• Bir Flow’un Meta’daki durumu değiştiğinde, örneğin kullanımdan kaldırıldığında tetiklenen yeni flow.status_updated olayı. Settings → Webhooks içinde bu olaya abone olun. Olay türleri

Kimlik bilgileri

• GET /v1/ping, nasıl oturum açtığınızı, kapsamlarınızı ve uygulamalar için istemci kimliğini döndürür. Kimlik bilgilerinizi kontrol edin
• Yeniden oynatılan eşgüçlü yanıtlar Idempotent-Replayed: true başlığını içerir. Eşgüçlülük

MCP sunucusu

• Yapay zeka asistanları, API anahtarı olmadan oturum açarak Flowella MCP sunucusuna bağlanabilir. Kullanıcı bir kuruluş seçer ve Flowella onay ekranında Allow access seçeneğini seçer. Owner veya Admin olmayan üyelerin bağlantıları salt okunurdur. Geliştirici uygulamaları
• Installed apps artık AI assistants adını taşır ve bir Last token sütunu içerir. Yüklü uygulamaları inceleyin ve iptal edin

• Flowella MCP sunucusu. Model Context Protocol’ü destekleyen yapay zeka asistanları kanallarınızı, şablonlarınızı ve Flow’larınızı okuyabilir. Sunucu salt okunurdur ve bir kuruluş API anahtarı kullanır. API anahtarları
• GET /v1/flows/{id}, Flowella form kimliğini kabul eder. Bir HubSpot formundan oluşturulan bir Flow’un şemasını düzenlemek 409 döndürür: değişikliği HubSpot’ta yapın ve yeniden senkronize edin. Flowella REST API
• Flowella’da oluşturulan Flow’lar her gönderimi, Flow’un Settings sekmesinde ayarlanan webhook uç noktalarınızdan birine gönderebilir. Webhook’lar
• Geçersiz bir yönlendirme URI’si ile geliştirici uygulaması kaydetmek anlaşılır bir hata döndürür. Bir uygulama kaydedin

Uyumluluğu bozan değişiklikler

• API-Version yalnızca 2026-08-11 değerini kabul eder. Diğer tüm değerler 400 döndürür. Başlığı göndermeyin veya 2026-08-11 gönderin. Sürümleme
• Webhook uç noktaları herkese açık bir HTTPS URL’si gerektirir. Özel, loopback ve bulut meta veri adresleri kabul edilmez. Yükseltmeden önce her uç noktayı kontrol edin. Webhook uç noktası ekleme
• OAuth uygulamaları. Flowella OAuth üzerine kurulu bir uygulamayı yükseltmeden önce bu gereksinimleri gözden geçirin:
  • Kapsam içermeyen istekler salt okunur erişim alır ve bilinmeyen kapsamlar reddedilir.
  • Token, introspect ve revoke uç noktaları istemci kimlik doğrulaması gerektirir.
  • Yetkilendirme isteği state gerektirir.
  • Client credentials izinleri yenileme belirteci döndürmez.
  • Bir belirteci iptal etmek yalnızca o belirtecin ailesini iptal eder.
  Geliştirici uygulamaları

API

• Hata yanıtları, error içinde desteğe iletebileceğiniz bir requestId içerir. Hatalar
• Kişi oluşturmak 201, güncellemek 200 döndürür. Yinelenen bir externalId 409, silinmiş bir kişi 404 döndürür.

Webhook’lar

• Yeni contact.created, contact.updated ve contact.deleted olayları. Olay türleri
• Name (optional) ile her uç noktaya bir ad verin. Ad, listede URL’nin üzerinde görünür.
• Bir imzalama gizli anahtarını döndürdükten sonraki 24 saat boyunca Flowella her teslimatı eski gizli anahtarla da imzalar ve X-Flowella-Signature-Previous içinde gönderir, böylece olay kaybetmeden gizli anahtar değiştirebilirsiniz. Bir imzalama gizli anahtarını döndürme
• Yeniden teslim edilen bir olay, orijinal olay kimliğini ve zaman damgasını korur. API teslimat kayıtları korelasyon kimliğini, yanıt başlıklarını ve bir sonraki yeniden deneme zamanını içerir. Yinelenen olayları ayıklama
• Flowella başarısız olan bir uç noktayı duraklattığında kuruluş sahipleri tek bir bildirim alır. Yeniden denemeler ve bekleme

• https://api.flowella.io kullanın. https://api.flowella.io/v1/... adresine yapılan istekler JSON döndürür. OpenAPI belgesi dahil eski https://app.flowella.io/api/v1/... URL’leri kalıcı olarak API ana bilgisayarına yönlendirilir. Yönlendirmeye güvenmemek için temel URL’nizi güncelleyin. Temel URL
• OpenAPI belgesindeki ilk sunucu https://api.flowella.io olduğundan içe aktarılan koleksiyonlar doğru temel URL’yi çağırır. OpenAPI belirtimi
• API, geçersiz şablon bileşenlerini ve Meta’nın gönderim sınırlarını aşan şablonları Meta’ya ulaşmadan önce reddeder.
• Carousel şablonlarını API üzerinden oluşturup gönderebilirsiniz. Bir kart için medya iletmezseniz Flowella o kartın onaylı örneğini kullanır. Carousel şablonları
• Şablon değişkenleri için yedek değerler API gönderimlerinde de geçerlidir. Yedek değerler
• Developer hub, eksiksiz kılavuzlar ve bir Postman koleksiyonu içerir. Geliştirici merkezi

• Aynı şablonun API üzerinden tekrarlanan gönderimleri daha hızlı gider.
• Meta bir şablon yönetimi çağrısını kısıtladığında Flowella bunu hız sınırı olarak bildirir, böylece yeniden denemeleriniz doğru şekilde geri çekilir. Hız sınırları

• POST /v1/templates/send 202 döndürür. Flowella isteği kabul eder, hemen bir iş kimliği döndürür ve mesajları arka planda teslim eder, geçici WhatsApp hatalarını yeniden dener. Entegrasyonunuz 200 yanıtını kontrol ediyorsa "status": "accepted" ile 202 bekleyecek şekilde güncelleyin. Teslimatı şablonun Statistics sekmesinden izleyin. Toplu şablon gönderimleri
• Idempotency-Key. POST /v1/templates/send ile bir Idempotency-Key başlığı gönderin. Flowella aynı isteğin tekrarlarını yedi gün boyunca tanır ve yeniden göndermek yerine orijinal iş kimliğini döndürür. Eşgüçlülük

• REST v1 belgelenmiştir ve özel API ana bilgisayarında /v1/... altında sunulur. Flowella REST API