# RevenueCat + Brew

Avvia le automazioni di Brew dagli eventi RevenueCat di acquisti in-app, abbonamenti e fatturazione, su Apple, Google, Amazon, Stripe e Web Billing. Richiede il piano Pro di RevenueCat o superiore.

URL canonico: https://brew.new/it/browse/integrations/revenuecat

- Direzione: Dati in entrata
- Collegamento: Secret del webhook
- Eventi di acquisti in-app + abbonamenti

## Funzionalità disponibili

- **Trigger da evento**: Avvia le automazioni di Brew dagli eventi RevenueCat di acquisti in-app, abbonamenti e fatturazione, su Apple, Google, Amazon, Stripe e Web Billing.

## Trasforma gli eventi degli abbonamenti in email utili

Collega RevenueCat per far partire email in linea con il tuo brand quando qualcuno acquista, rinnova, disdice o ha un problema di fatturazione nella tua app. Brew supporta 11 eventi del ciclo di vita di RevenueCat, e lo stesso flusso può servire gli abbonati di App Store, Google Play, Amazon, Stripe e Web Billing.

RevenueCat e gli store restano responsabili di acquisti, rinnovi, rimborsi ed entitlement. Brew crea e invia le email.


## Cosa puoi creare

- Email di benvenuto per gli abbonati: l’evento INITIAL_PURCHASE scatta quando inizia un nuovo abbonamento, anche se si tratta dell’inizio di una prova. Gli acquisti una tantum arrivano invece come NON_RENEWING_PURCHASE.
- Ricevute di rinnovo: l’evento RENEWAL scatta quando un abbonamento si rinnova o quando un ex abbonato si abbona di nuovo, con productId, priceUsd, pricePurchaseCurrency e currency.
- Avvisi di problemi di fatturazione: l’evento BILLING_ISSUE scatta quando un pagamento non va a buon fine. Inserisci un link alla pagina in cui l’abbonato aggiorna il metodo di pagamento.
- Follow-up dopo la disdetta: l’evento CANCELLATION contiene cancelReason, così l’email può trattare un rimborso o un errore di fatturazione in modo diverso da una disdetta volontaria.
- Email di bentornato: l’evento UNCANCELLATION scatta quando un abbonato riattiva un abbonamento disdetto prima che scada.
- Riattivazione dopo la fine dell’accesso: l’evento EXPIRATION scatta quando un abbonamento termina davvero e contiene expirationReason.
- Avvisi di cambio di piano: l’evento PRODUCT_CHANGE contiene previousProductId e newProductId. Il nuovo prodotto potrebbe entrare in vigore più tardi, quindi formula l’email come una modifica richiesta.
- Avvisi di pausa e di proroga: l’evento SUBSCRIPTION_PAUSED scatta quando la pausa di un abbonamento Google Play viene programmata per la fine del periodo. L’evento SUBSCRIPTION_EXTENDED scatta quando uno store proroga il periodo o Google Play rinvia un addebito.

## La disdetta non è la fine dell’accesso

L’evento CANCELLATION può indicare un abbonamento disdetto o un rimborso e, da solo, non significa che l’accesso sia terminato. L’evento che indica la fine dell’accesso è EXPIRATION. L’evento SUBSCRIPTION_PAUSED si limita a programmare una pausa futura.

Usa CANCELLATION per le email di riattivazione o i sondaggi di uscita, ed EXPIRATION per tutto ciò che presuppone che l’accesso sia terminato. Un evento UNCANCELLATION non interrompe un’esecuzione per la disdetta già avviata, quindi controlla revenuecat_subscription_status in una condizione prima di ogni email successiva.

Filtra su environment per tenere gli eventi SANDBOX fuori dalle automazioni attive.


## Configura RevenueCat in Brew

- I webhook di RevenueCat richiedono il piano Pro di RevenueCat o superiore.
- Apri Integrazioni, scegli RevenueCat e seleziona Genera l’URL del webhook.
- In RevenueCat, apri Integrations > Webhooks e aggiungi una configurazione. Incolla l’URL di Brew, scegli Production, Sandbox o entrambi e seleziona gli eventi del ciclo di vita da inviare.
- In quella configurazione attiva la firma HMAC dei webhook e copia subito il secret di firma: RevenueCat lo mostra una sola volta. Incollalo in Brew e seleziona Collega. Non incollare una chiave API REST di RevenueCat né il valore facoltativo dell’header Authorization.
- Invia un webhook di test da RevenueCat. Una consegna TEST firmata attiva il collegamento ma non avvia mai un’automazione per i clienti.
- Imposta l’attributo dell’abbonato $email per ogni cliente, così Brew ha un indirizzo a cui inviare.
- Il collegamento crea un trigger per ciascuno degli 11 eventi. Non esiste un interruttore per attivare o disattivare gli eventi. Crea un’automazione, seleziona il suo evento RevenueCat e invia un test mentre è ancora in bozza. Quando arriva un evento corrispondente, vengono eseguite solo le automazioni attive.

## Eventi RevenueCat supportati

Brew supporta questi 11 tipi di evento:

- INITIAL_PURCHASE
- RENEWAL
- NON_RENEWING_PURCHASE
- PRODUCT_CHANGE
- CANCELLATION
- UNCANCELLATION
- EXPIRATION
- BILLING_ISSUE
- SUBSCRIPTION_PAUSED
- SUBSCRIPTION_EXTENDED
- TRANSFER

## Sincronizzazione dei contatti e personalizzazione

Brew legge il destinatario prima di tutto dall’attributo dell’abbonato $email, poi, in alternativa, accetta un ID utente dell’app, un ID utente originale dell’app o un alias, purché abbia la forma di un indirizzo email. Gli alias di RevenueCat sono lo storico degli ID utente dell’app, quindi imposta $email in modo esplicito invece di affidarti agli alias. Se nessuno di questi campi contiene un indirizzo reale, Brew registra l’evento come non risolto, non crea alcun contatto e non avvia alcuna automazione.

Ogni evento verificato con un indirizzo email reale crea o aggiorna un contatto di Brew, abbinato in base all’email, che un’automazione usi o meno l’evento. Quando i dati sono presenti, Brew imposta revenuecat_app_user_id, revenuecat_store e revenuecat_environment.

Gli eventi del ciclo di vita impostano revenuecat_subscription_status su active, cancelled, expired, billing_issue o pause_scheduled. Brew salva anche revenuecat_product_id, revenuecat_cancel_reason, revenuecat_expiration_reason, revenuecat_last_purchase_at e revenuecat_pending_product_id, quando l’evento li fornisce.

Per i merge tag, usa lo schema del payload dichiarato dall’evento selezionato. Ogni evento include email, productId, priceUsd, pricePurchaseCurrency, currency, store, environment e createdAt, quando presenti. Il campo priceUsd è il prezzo in USD, mentre pricePurchaseCurrency è il prezzo nella valuta indicata da currency. I payload di RevenueCat non forniscono a Brew né il nome né il cognome.

Il campo store arriva così come lo invia RevenueCat, ad esempio APP_STORE o PLAY_STORE, e RevenueCat può aggiungere nuovi valori. Imposta le condizioni sui valori che ti interessano.

Un acquisto non costituisce un consenso all’email di marketing. Raccogli il consenso a parte e verificalo prima degli invii promozionali.


## Perché TRANSFER non invia mai un’email?

RevenueCat invia TRANSFER con gli ID utente dell’app ma senza l’email del destinatario. Brew lo registra come non risolto e non avvia alcuna automazione.


## Perché un evento compare senza che venga inviata un’email?

Ricevere un evento e inviare un’email sono passaggi separati. Verifica che un’automazione corrispondente sia attiva, poi controlla i suoi filtri, la cronologia delle esecuzioni, l’idoneità del destinatario e il dominio di invio. Una consegna TEST non avvia mai un’automazione. Quando un destinatario non è risolto, controlla prima $email; Brew accetta anche ID utente dell’app, ID utente originali dell’app e alias, purché abbiano la forma di un indirizzo email.


## Limiti e risoluzione dei problemi

- Brew non può concedere o revocare entitlement, emettere rimborsi o modificare gli abbonamenti.
- Un errore 401 con l’header della firma mancante di solito significa che la firma HMAC è disattivata o che è stato incollato il valore di Authorization al posto del secret di firma. Attiva la firma HMAC, copia il nuovo secret e ricollega RevenueCat.
- Un errore 401 con una firma HMAC non corrispondente significa che Brew ha un secret diverso o non aggiornato. Ruotare il secret in RevenueCat invalida quello precedente, quindi copia il nuovo valore e ricollega RevenueCat in Brew.
- Se non arriva nessun webhook, verifica che il tuo piano RevenueCat includa i webhook.
- Verifica il consenso e la finalità di ogni email. Sincronizzare gli abbonati non autorizza gli invii promozionali.

## Fonti e guide alla configurazione

- [Guida alla configurazione di RevenueCat](https://docs.brew.new/integrations/import/revenuecat)
- [Crea un’automazione](https://docs.brew.new/create-emails/build-an-automation)
- [Merge tag](https://docs.brew.new/create-emails/merge-tags)
- [Cosa puoi inviare con Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Webhook di RevenueCat](https://www.revenuecat.com/docs/integrations/webhooks)
- [Attributi dei clienti di RevenueCat](https://www.revenuecat.com/docs/customers/customer-attributes)

## Correlati

- [Tutte le integrazioni](https://brew.new/it/browse/integrations.md)
- [Registrati](https://brew.new/it/sign-up.md)
- Sito web: https://brew.new