> ## 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. # Changelog per sviluppatori: API, webhook, OAuth e MCP > Modifiche ad API REST, webhook, app OAuth e server MCP di Flowella, con le modifiche incompatibili segnalate e cosa aggiornare nella vostra integrazione. Le modifiche che riguardano le integrazioni basate sull'API REST di Flowella, sui webhook, sulle app OAuth e sul server MCP di Flowella, dalla più recente. Le voci con il tag **Breaking** richiedono una modifica da parte vostra, e ognuna indica cosa aggiornare. Per le modifiche all'app Flowella, consultate il [changelog](https://knowledge.flowella.io/it/changelog.md). La versione attuale dell'API è `2026-08-11`. [Per saperne di più: Versioni](https://knowledge.flowella.io/it/api-reference/introduction.md#versioning) **6 novembre 2026** v2.8.0 ## Ciclo di vita dei Flow * `GET /v1/flows/{id}` restituisce lo stato del Flow in Meta (`metaStatus`), le sue schermate, i campi e l'azione di invio. * `POST /v1/flows/{id}/publish?dry_run=true` verifica un Flow senza pubblicarlo. * `POST /v1/flows/{id}/deprecate` ritira un Flow in Meta. Meta non può annullare questa operazione. Flowella la blocca finché dei template usano ancora il Flow, a meno che non inviate `force`. * `DELETE /v1/flows/{id}` restituisce `409` `HUBSPOT_FLOW_MANAGED` per un Flow creato da un form HubSpot, e `409` `FLOW_REFERENCED_BY_TEMPLATES` finché una bozza di template usa ancora il Flow. Eliminare un Flow non lo elimina mai in Meta: per ritirarlo lì, deprecatelo prima. Pubblicare un Flow deprecato restituisce `409` `FLOW_DEPRECATED`. * Quando create un template, un pulsante Flow può puntare a un Flow Flowella con `flowellaFlowId` invece che a un ID di Flow Meta. * I Flow che create tramite l'API vengono pubblicati con la schermata di ingresso `MAIN_FORM`. I Flow pubblicati in precedenza continuano a funzionare. Ripubblicateli prima di usarli con `flowellaFlowId`. ## Webhook * Nuovo evento `flow.status_updated` quando cambia lo stato di un Flow in Meta, ad esempio quando viene deprecato. Iscrivetevi in **Settings** → **Webhooks**. [Tipi di evento](https://knowledge.flowella.io/it/api-reference/webhooks.md#tipi-di-evento) ## Credenziali * `GET /v1/ping` restituisce il modo in cui avete effettuato l'accesso, i vostri scope e, per le app, il client ID. [Verificare le credenziali](https://knowledge.flowella.io/it/api-reference/introduction.md#check-your-credentials) * Le risposte idempotenti riprodotte includono l'intestazione `Idempotent-Replayed: true`. [Idempotenza](https://knowledge.flowella.io/it/api-reference/introduction.md#idempotency) ## Server MCP * Gli assistenti IA possono collegarsi al server MCP di Flowella effettuando l'accesso, senza una chiave API. L'utente sceglie un'organizzazione e seleziona **Allow access** nella schermata di consenso di Flowella. Le connessioni dei membri che non sono Owner o Admin sono in sola lettura. [App per sviluppatori](https://knowledge.flowella.io/it/settings/developer-apps.md) * **Installed apps** ora si chiama **AI assistants**, con una colonna **Last token**. [Verificare e revocare le app installate](https://knowledge.flowella.io/it/settings/developer-apps.md#verificare-e-revocare-le-app-installate) **2 novembre 2026** v2.7.0 * **Server MCP di Flowella.** Gli assistenti IA che supportano il Model Context Protocol possono leggere i vostri canali, template e Flows. Il server è in sola lettura e usa una chiave API dell'organizzazione. [Chiavi API](https://knowledge.flowella.io/it/settings/api-keys.md) * `GET /v1/flows/{id}` accetta l'ID del form Flowella. Modificare lo schema di un Flow creato da un form HubSpot restituisce `409`: apportate la modifica in HubSpot e sincronizzate di nuovo. [API REST di Flowella](https://knowledge.flowella.io/it/api-reference/introduction.md) * I Flow creati in Flowella possono inviare ogni risposta a uno dei vostri endpoint webhook, impostato nella scheda **Settings** del Flow. [Webhook](https://knowledge.flowella.io/it/settings/webhooks.md) * La registrazione di un'app per sviluppatori con un redirect URI non valido restituisce un errore in linguaggio semplice. [Registrare un'app](https://knowledge.flowella.io/it/settings/developer-apps.md#registrare-un’app) **16 ottobre 2026** v2.6.5 ## Modifiche incompatibili * **`API-Version` accetta solo `2026-08-11`.** Qualsiasi altro valore restituisce `400`. Omettete l'intestazione oppure inviate `2026-08-11`. [Versioni](https://knowledge.flowella.io/it/api-reference/introduction.md#versioning) * **Gli endpoint webhook richiedono un URL HTTPS pubblico.** Gli indirizzi privati, di loopback e di metadati cloud non sono accettati. Verificate ogni endpoint prima dell'aggiornamento. [Aggiungere un endpoint webhook](https://knowledge.flowella.io/it/settings/webhooks.md#aggiungere-un-endpoint-webhook) * **App OAuth.** Verificate questi requisiti prima di aggiornare un'app basata su Flowella OAuth: * Le richieste senza scope ottengono l'accesso in sola lettura, e gli scope sconosciuti vengono rifiutati. * Gli endpoint token, introspect e revoke richiedono l'autenticazione del client. * La richiesta di autorizzazione richiede `state`. * I grant client credentials non restituiscono un refresh token. * La revoca di un token revoca solo la famiglia di quel token. [App per sviluppatori](https://knowledge.flowella.io/it/settings/developer-apps.md) ## API * Le risposte di errore includono un `requestId` all'interno di `error`, che potete indicare all'assistenza. [Errori](https://knowledge.flowella.io/it/api-reference/introduction.md#errors) * La creazione di un contatto restituisce `201` e l'aggiornamento restituisce `200`. Un `externalId` duplicato restituisce `409` e un contatto eliminato restituisce `404`. ## Webhook * Nuovi eventi `contact.created`, `contact.updated` e `contact.deleted`. [Tipi di evento](https://knowledge.flowella.io/it/api-reference/webhooks.md#tipi-di-evento) * Date un nome a ogni endpoint con **Name (optional)**. Il nome compare sopra l'URL nell'elenco. * Per 24 ore dopo la rotazione di un segreto di firma, Flowella firma ogni consegna anche con il vecchio segreto e lo invia in `X-Flowella-Signature-Previous`, così potete cambiare segreto senza perdere eventi. [Ruotare un segreto di firma](https://knowledge.flowella.io/it/api-reference/webhooks.md#ruotare-un-segreto-di-firma) * Un evento consegnato di nuovo mantiene l'ID evento e il timestamp originali. I record di consegna dell'API includono l'ID di correlazione, le intestazioni della risposta e l'orario del prossimo tentativo. [Deduplicare gli eventi](https://knowledge.flowella.io/it/api-reference/webhooks.md#deduplicare-gli-eventi) * I proprietari dell'organizzazione ricevono una sola notifica quando Flowella mette in pausa un endpoint che non risponde. [Nuovi tentativi e back-off](https://knowledge.flowella.io/it/settings/webhooks.md#nuovi-tentativi-e-back-off) **13 ottobre 2026** v2.6.0 * **Usate `https://api.flowella.io`.** Le richieste a `https://api.flowella.io/v1/...` restituiscono JSON. I vecchi URL `https://app.flowella.io/api/v1/...`, compreso il documento OpenAPI, reindirizzano in modo permanente all'host dell'API. Aggiornate l'URL di base per non dipendere dal reindirizzamento. [URL di base](https://knowledge.flowella.io/it/api-reference/introduction.md#base-url) * Il primo server nel documento OpenAPI è `https://api.flowella.io`, così le collection importate chiamano l'URL di base corretto. [Specifica OpenAPI](https://knowledge.flowella.io/it/api-reference/introduction.md#openapi-spec) * L'API rifiuta i componenti di template non validi, e i template che superano i limiti di invio di Meta, prima che arrivino a Meta. * Potete creare e inviare template carosello tramite l'API. Se non passate un media per una card, Flowella usa l'esempio approvato di quella card. [Template carosello](https://knowledge.flowella.io/it/app/template-reference.md#template-carosello) * I valori di fallback per le variabili dei template si applicano agli invii tramite API. [Valori di fallback](https://knowledge.flowella.io/it/app/template-variables.md#fallback-values) * Il **Developer hub** include guide complete e una collection Postman. [Developer hub](https://knowledge.flowella.io/it/settings/developer-hub.md) **21 settembre 2026** * Gli invii ripetuti dello stesso template tramite l'API partono più velocemente. * Quando Meta limita una chiamata di gestione dei template, Flowella la segnala come rate limit, così i vostri nuovi tentativi rallentano correttamente. [Limiti di frequenza](https://knowledge.flowella.io/it/api-reference/introduction.md#rate-limits) **26 agosto 2026** * **`POST /v1/templates/send` restituisce `202`.** Flowella accetta la richiesta, restituisce subito un ID del job e consegna i messaggi in background, ritentando in caso di errori WhatsApp temporanei. Se la vostra integrazione verifica una risposta `200`, aggiornatela per aspettarsi `202` con `"status": "accepted"`. Seguite la consegna nella scheda **Statistics** del template. [Invii di template in blocco](https://knowledge.flowella.io/it/api-reference/introduction.md#bulk-template-sends) * **`Idempotency-Key`.** Inviate un'intestazione `Idempotency-Key` con `POST /v1/templates/send` e Flowella riconosce le ripetizioni della stessa richiesta per sette giorni, restituendo l'ID del job originale invece di inviare di nuovo. [Idempotenza](https://knowledge.flowella.io/it/api-reference/introduction.md#idempotency) **2 agosto 2026** * La REST v1 è documentata e servita sull'host dedicato dell'API in `/v1/...`. [API REST di Flowella](https://knowledge.flowella.io/it/api-reference/introduction.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.