Changelog per sviluppatori: API, webhook, OAuth e MCP

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

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
• Le risposte idempotenti riprodotte includono l’intestazione Idempotent-Replayed: true. Idempotenza

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
• Installed apps ora si chiama AI assistants, con una colonna Last token. Verificare e revocare le app installate

• 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
• 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
• I Flow creati in Flowella possono inviare ogni risposta a uno dei vostri endpoint webhook, impostato nella scheda Settings del Flow. Webhook
• La registrazione di un’app per sviluppatori con un redirect URI non valido restituisce un errore in linguaggio semplice. Registrare un’app

Modifiche incompatibili

• API-Version accetta solo 2026-08-11. Qualsiasi altro valore restituisce 400. Omettete l’intestazione oppure inviate 2026-08-11. Versioni
• 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
• 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

API

• Le risposte di errore includono un requestId all’interno di error, che potete indicare all’assistenza. Errori
• 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
• 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
• 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
• I proprietari dell’organizzazione ricevono una sola notifica quando Flowella mette in pausa un endpoint che non risponde. Nuovi tentativi e back-off

• 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
• Il primo server nel documento OpenAPI è https://api.flowella.io, così le collection importate chiamano l’URL di base corretto. Specifica OpenAPI
• 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
• I valori di fallback per le variabili dei template si applicano agli invii tramite API. Valori di fallback
• Il Developer hub include guide complete e una collection Postman. Developer hub

• 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

• 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
• 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

• La REST v1 è documentata e servita sull’host dedicato dell’API in /v1/.... API REST di Flowella