> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Geliştirici değişiklik günlüğü: API, webhook, OAuth ve MCP > Flowella REST API, webhook'lar, OAuth uygulamaları ve MCP sunucusundaki değişiklikler. Uyumluluğu bozan değişiklikler ve yapmanız gerekenler işaretlenir. Flowella REST API, webhook'lar, OAuth uygulamaları ve Flowella MCP sunucusu üzerine kurulan entegrasyonları etkileyen değişiklikler, en yenisi en üstte. **Breaking** etiketli girişler sizin tarafınızda değişiklik gerektirir ve her biri neyi güncellemeniz gerektiğini belirtir. Flowella uygulamasındaki değişiklikler için [değişiklik günlüğüne](https://knowledge.flowella.io/tr/changelog.md) bakın. Geçerli API sürümü `2026-08-11`. [Daha fazla bilgi: Sürümleme](https://knowledge.flowella.io/tr/api-reference/introduction.md#versioning) **6 Kasım 2026** v2.8.0 ## 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](https://knowledge.flowella.io/tr/api-reference/webhooks.md#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](https://knowledge.flowella.io/tr/api-reference/introduction.md#check-your-credentials) * Yeniden oynatılan eşgüçlü yanıtlar `Idempotent-Replayed: true` başlığını içerir. [Eşgüçlülük](https://knowledge.flowella.io/tr/api-reference/introduction.md#idempotency) ## 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ı](https://knowledge.flowella.io/tr/settings/developer-apps.md) * **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](https://knowledge.flowella.io/tr/settings/developer-apps.md#yüklü-uygulamaları-inceleyin-ve-iptal-edin) **2 Kasım 2026** v2.7.0 * **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ı](https://knowledge.flowella.io/tr/settings/api-keys.md) * `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](https://knowledge.flowella.io/tr/api-reference/introduction.md) * Flowella'da oluşturulan Flow'lar her gönderimi, Flow'un **Settings** sekmesinde ayarlanan webhook uç noktalarınızdan birine gönderebilir. [Webhook'lar](https://knowledge.flowella.io/tr/settings/webhooks.md) * Geçersiz bir yönlendirme URI'si ile geliştirici uygulaması kaydetmek anlaşılır bir hata döndürür. [Bir uygulama kaydedin](https://knowledge.flowella.io/tr/settings/developer-apps.md#bir-uygulama-kaydedin) **16 Ekim 2026** v2.6.5 ## 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](https://knowledge.flowella.io/tr/api-reference/introduction.md#versioning) * **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](https://knowledge.flowella.io/tr/settings/webhooks.md#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ı](https://knowledge.flowella.io/tr/settings/developer-apps.md) ## API * Hata yanıtları, `error` içinde desteğe iletebileceğiniz bir `requestId` içerir. [Hatalar](https://knowledge.flowella.io/tr/api-reference/introduction.md#errors) * 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](https://knowledge.flowella.io/tr/api-reference/webhooks.md#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](https://knowledge.flowella.io/tr/api-reference/webhooks.md#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](https://knowledge.flowella.io/tr/api-reference/webhooks.md#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://knowledge.flowella.io/tr/settings/webhooks.md#yeniden-denemeler-ve-bekleme) **13 Ekim 2026** v2.6.0 * **`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](https://knowledge.flowella.io/tr/api-reference/introduction.md#base-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](https://knowledge.flowella.io/tr/api-reference/introduction.md#openapi-spec) * 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ı](https://knowledge.flowella.io/tr/app/template-reference.md#carousel-şablonları) * Şablon değişkenleri için yedek değerler API gönderimlerinde de geçerlidir. [Yedek değerler](https://knowledge.flowella.io/tr/app/template-variables.md#fallback-values) * **Developer hub**, eksiksiz kılavuzlar ve bir Postman koleksiyonu içerir. [Geliştirici merkezi](https://knowledge.flowella.io/tr/settings/developer-hub.md) **21 Eylül 2026** * 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ı](https://knowledge.flowella.io/tr/api-reference/introduction.md#rate-limits) **26 Ağustos 2026** * **`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](https://knowledge.flowella.io/tr/api-reference/introduction.md#bulk-template-sends) * **`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](https://knowledge.flowella.io/tr/api-reference/introduction.md#idempotency) **2 Ağustos 2026** * REST v1 belgelenmiştir ve özel API ana bilgisayarında `/v1/...` altında sunulur. [Flowella REST API](https://knowledge.flowella.io/tr/api-reference/introduction.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.