Visualizza le categorie

Integrazione di Anvil.works con Stripe - Sincronizzazione automatica dei dati di pagamento in tempo reale

7 minuti di lettura

INTEGRAZIONE API

Striscia Incudine

Striscia Striscia
Flussi di query Flussi di query
Incudine Incudine
Codice zero
Configurazione semplice
Veloce

Query Streams consente una perfetta integrazione con Anvil Stripe, sincronizzando automaticamente i dati di pagamento Stripe in tempo reale con i fogli Anvil. Iscriviti gratuitamente a QueryStreams.com e inizia ad automatizzare le tue pipeline di dati da Stripe ad Anvil in pochi minuti.

Questa guida illustra come impostare la sincronizzazione automatica dei dati da Stripe ad Anvil utilizzando Query Streams. Che tu abbia bisogno di tenere aggiornati i team finanziari con i dati di pagamento, sincronizzare le metriche degli abbonamenti agli spazi di lavoro collaborativi o automatizzare i flussi di lavoro di reporting delle entrate, Query Streams offre una soluzione sicura e senza codice per l'integrazione tra Stripe e Anvil.works.

Automazione programmata

Sincronizzazione ogni ora, ogni giorno o secondo programmi personalizzati

Sicurezza per progettazione

Le chiavi API rimangono sulla tua rete

Velocissimo

Streaming dati ottimizzato

Sincronizzazione intelligente

Inserisci, aggiorna, elimina automaticamente

Che cos'è l'integrazione Anvil Stripe?

L'integrazione Anvil Stripe collega la tua piattaforma di pagamento Stripe ad Anvil, consentendo la sincronizzazione automatica dei dati senza esportazioni o importazioni manuali. Query Streams funge da ponte sicuro tra il tuo account Stripe e Anvil, eseguendo query SQL salvate sui tuoi dati Stripe secondo una pianificazione e inviando i risultati direttamente ai tuoi fogli.

Funzionalità principali:

  • Sincronizzazione automatica: Pianifica le query in modo che vengano eseguite ogni ora, ogni giorno o a intervalli personalizzati.
  • Accesso SQL a Stripe: Interroga clienti, fatture, abbonamenti, addebiti e altro utilizzando il familiare linguaggio SQL.
  • Modalità sincronizzazione completa: Inserisci nuove righe, aggiorna quelle esistenti e rimuovi automaticamente i record eliminati.
  • Connessione sicura: Le tue credenziali Stripe (OAuth o chiave API) rimangono protette all'interno della tua rete.
  • Non è richiesta alcuna codifica: Configura tutto tramite il portale web Query Streams

Prerequisiti

1

Agente Query Streams installato

L'agente deve essere in esecuzione sulla tua rete con accesso per sincronizzare i dati Stripe.

Installare l'agente per i flussi di query →
2

Connettore API Stripe configurato

Il tuo account Stripe deve essere collegato come fonte dati API nell'agente (supporta l'autenticazione OAuth o API Access Token).

Collega Stripe a Query Streams →
3

Conto Anvil

Un account Anvil con accesso API (disponibile nei piani Business ed Enterprise o tramite prova gratuita).

4

Query salvata

Almeno una query salvata in Query Streams che restituisce i dati Stripe che desideri sincronizzare.

Passaggio 1: crea la tua query Stripe

1
2
3
4
5
6
7

Prima di configurare l'integrazione, è necessario disporre di una query salvata che restituisca i dati Stripe che si desidera sincronizzare con Anvil. Query Streams consente di scrivere query SQL sui dati Stripe come se fossero un database.

  1. Accedi al portale Query Streams: Visita my.querystreams.com e accedi
  2. Apri il Query Builder: Accedi al Query Builder dalla dashboard.
  3. Seleziona la tua fonte dati Stripe: Nella barra laterale Data Explorer a sinistra, espandi il tuo Data Realm, quindi seleziona il connettore Stripe e scegli i dati API che desideri interrogare.
  4. Scrivi la tua query SQL: Interrogare le tabelle Stripe utilizzando la sintassi SQL
Esempio di query Stripe SQL
SELECT 
    customer_email,
    customer_name,
    amount_dollars,
    status,
    created
FROM invoices
WHERE created >= NOW() - INTERVAL '30 days'
  AND status = 'paid'
ORDER BY created DESC
LIMIT 500;

Tabelle Stripe disponibili: clienti, fatture, abbonamenti, oneri, intenzioni_di_pagamento, rimborsi, transazioni_di_saldo, prodotti, prezzi, eventi, controversie, pagamentie altro ancora.

  1. Prova e salva: Esegui la query per verificare i risultati, quindi salvala con un nome descrittivo come "Fatture pagate di recente per Anvil".
Consiglio dell'esperto: Se prevedi di utilizzare la modalità Full Sync, assicurati che la tua query includa una colonna con un identificatore univoco (come id o id_fattura) che Anvil può utilizzare per abbinare le righe.

Passaggio 2: Creare l'integrazione Anvil.works

2
3
4
5
6
7

Ora collegherai la query salvata ad Anvil tramite la funzione Automazione.

  1. Passa alla sezione Automazione: Nel portale Query Streams, fare clic su Automazione nella barra laterale sinistra
  2. Crea nuova integrazione: Cliccare Nuova integrazione per avviare la procedura guidata di configurazione
  3. Seleziona la query salvata: Scegli la query Stripe che hai creato nel passaggio 1.
  4. Scegli Anvil come destinazione: Seleziona Incudine dall'elenco delle piattaforme disponibili

Passaggio 3: collega il tuo account Anvil

3
4
5
6
7

L'integrazione di Anvil.works richiede l'installazione del componente Query Streams nell'app Anvil.works e la sua configurazione con una chiave di connessione sicura.

1

Aggiungi dipendenza da terze parti

Nell'app Anvil.works, vai su Impostazioni → Dipendenze

Fare clic sul pulsante "Terza parte" e inserisci questo codice:

47C7VQG6QJTVY16B
2

Crea modulo server

Nell'app Anvil.works, crea un Modulo server e aggiungi questo codice:

da querystreams import connector
connector.init_connector("YOUR_AUTH_KEY")
3

Genera chiave di autenticazione sicura

Nella configurazione dell'automazione Query Streams:

  1. Cliccare Genera chiave sicura (oppure inserisci il tuo)
  2. Copia la chiave di autenticazione
  3. Sostituisci LA_TUA_CHIAVE_DI_AUTENTICITÀ nel codice Anvil.works con questa chiave
4

Inserisci l'URL dell'app Anvil

In Query Streams, inserisci l'URL della tua app Anvil.works pubblicata (dominio anvil.app o dominio personalizzato).

Esempi: https://your-app.anvil.app o https://yourdomain.com

5

Collegamento di prova

Cliccare Collegamento di prova per verificare che Query Streams sia in grado di comunicare con la tua app Anvil.works

Passaggio 4: seleziona il foglio di destinazione

4
5
6
7

Scegli dove sincronizzare i tuoi dati Stripe in Anvil.works.

  1. Sfoglia i tuoi fogli: Query Streams mostrerà i fogli Anvil e gli spazi di lavoro disponibili.
  2. Seleziona un foglio: Scegli un foglio esistente su cui sincronizzare i dati oppure seleziona Crea nuovo foglio
  3. Mappatura delle colonne: Query Streams mapperà automaticamente le colonne della query alle colonne di Anvil. Controlla e modifica se necessario.
Suggerimento: Se si crea un nuovo foglio, Query Streams creerà automaticamente delle colonne basate sui risultati della query.

Passaggio 5: configurare la modalità di sincronizzazione

5
6
7

Scegli come Query Streams deve gestire la sincronizzazione dei dati.

+

Modalità Append

Ideale per registri e cronologia
  • Aggiunge nuove righe in fondo
  • Non modifica mai le righe esistenti
  • Non cancella mai i dati
  • Conserva i documenti storici
Ideale per: Cronologia dei pagamenti, registri delle transazioni, tracciamento degli eventi

Modalità Full Sync

Popolare
Ideale per dati in tempo reale
  • Inserti nuovi record
  • Aggiornamenti record modificati
  • Elimina record rimossi
  • Richiede colonna chiave
Ideale per: Abbonamenti attivi, elenchi clienti, dashboard delle entrate

Selezione colonna chiave: Se si utilizza la modalità Sincronizzazione completa, selezionare la colonna che identifica in modo univoco ogni riga. Questa colonna deve essere presente sia nei risultati della query che nel foglio Anvil.

Comportamento della sincronizzazione delle colonne (SYNC vs PRESERVE)

Per ogni colonna nella mappatura dei campi, scegli come Query Streams deve gestirla durante la sincronizzazione:

SYNC (Predefinito)

Valore sorgente sovrascrive sempre bersaglio

Utilizzo per: Colonne di dati che devono corrispondere esattamente a Stripe (stato del pagamento, importi, date)

PRESERVARE

Il valore target è mai sovrascritto

Utilizzo per: Colonne in cui è possibile aggiungere note manuali, assegnazioni o lo stato di follow-up in Anvil.works
Esempio: sincronizzazione delle fatture con i follow-up del team
Colonne di origine (da Stripe)
  • id_fattura – Campo chiave
  • indirizzo_e-mail_del_cliente – SYNC
  • importo_dollari – SYNC
  • stato – SYNC
Colonne aggiunte dall'utente (in Anvil.works)
  • Assegnato a – CONSERVARE
  • Note di follow-up – CONSERVARE
  • Priorità – CONSERVARE
Risultato: Ogni sincronizzazione aggiorna i dati di pagamento da Stripe, conservando le note e gli incarichi del tuo team.

Passaggio 6: imposta la pianificazione della sincronizzazione

6
7

Configura quando Query Streams deve sincronizzare i dati da Stripe ad Anvil.

Manuale Esegui sincronizzazioni solo su richiesta
Ogni 5 minutiSincronizzazione ad alta frequenza per dati in tempo reale
Ogni 10 minutiAggiornamenti quasi in tempo reale
Ogni 15 minutiSincronizzazione frequente per dati attivi
🕑
Ogni ora Sincronizza ogni ora
📅
GiornalieroSincronizza una volta al giorno all'ora specificata
Personalizzato Imposta giorni e orari specifici

Passaggio 7: Rivedere e attivare

7
  1. Configurazione della revisione: Verifica tutte le impostazioni, inclusi query, destinazione, modalità di sincronizzazione e pianificazione.
  2. Assegna un nome alla tua integrazione: Assegnagli un nome descrittivo come "Fatture Stripe a Anvil Daily Sync".
  3. Attiva: Cliccare Crea integrazione salvare e attivare
  4. Esegui sincronizzazione iniziale: Cliccare Corri ora eseguire la prima sincronizzazione e verificare che tutto funzioni correttamente

Congratulazioni!

L'integrazione tra Stripe e Anvil.works è ora attiva. I dati di pagamento verranno sincronizzati automaticamente in base alla tua pianificazione.

Monitoraggio dell'integrazione

Dopo l'attivazione, puoi monitorare l'integrazione di Anvil Stripe dalla dashboard di Automation:

🕑

Ora dell'ultima sincronizzazione

Visualizza quando i dati sono stati sincronizzati l'ultima volta

📊

Righe sincronizzate

Visualizza il numero di righe inserite, aggiornate ed eliminate

🔔

Avvisi di errore

Ricevi una notifica se la sincronizzazione non riesce

📃

Cronologia sincronizzazioni

Rivedi le operazioni di sincronizzazione passate e i relativi risultati

Casi d'uso comuni per l'integrazione di Anvil Stripe

💰

Monitoraggio delle entrate

Sincronizza le entrate mensili, il MRR e le tendenze di pagamento da Stripe ad Anvil per i dashboard esecutivi e la pianificazione finanziaria.

💳

Gestione degli abbonamenti

Tieni aggiornato il tuo team con abbonamenti attivi, account disdetti e metriche di abbonamento negli spazi di lavoro collaborativi di Anvil.

👥

Analisi dei clienti

Sincronizza automaticamente i dati dei clienti, il valore lifetime e la cronologia dei pagamenti su Anvil per i team addetti al successo dei clienti e alle vendite.

Monitoraggio dei pagamenti non riusciti

Tieni traccia degli addebiti non riusciti, dei tentativi di pagamento e degli abbonamenti a rischio in Anvil.works per un approccio proattivo nei confronti dei clienti.

📈

Riconciliazione finanziaria

Sincronizza rimborsi, contestazioni, transazioni di saldo e pagamenti con Anvil per garantire la visibilità al team contabile e finanziario.

Domande frequenti

Con quale frequenza posso sincronizzare i dati da Stripe ad Anvil? +

Query Streams supporta pianificazioni di sincronizzazione da ogni ora a intervalli personalizzati. Nella maggior parte dei casi, le sincronizzazioni giornaliere o orarie offrono un buon equilibrio tra l'aggiornamento dei dati e le risorse di sistema.

🔒 La mia chiave API Stripe è sicura durante la sincronizzazione? +

Sì. La tua chiave API Stripe rimane protetta all'interno della tua rete tramite l'agente Query Streams. I dati vengono crittografati durante il trasferimento e il tuo token API Anvil viene archiviato in modo sicuro. Query Streams non memorizza mai i tuoi dati di pagamento grezzi.

Cosa succede se la sincronizzazione non riesce? +

Query Streams riproverà le sincronizzazioni non riuscite e ti notificherà gli errori persistenti. Puoi visualizzare i dettagli dell'errore nella cronologia delle sincronizzazioni e avviare manualmente un nuovo tentativo una volta risolto il problema.

📂 Posso sincronizzare più query Stripe su diversi fogli Anvil? +

Sì. Crea integrazioni separate per ogni query e foglio di destinazione. Ogni integrazione può utilizzare tabelle Stripe, modalità di sincronizzazione e pianificazioni diverse.

💳 Quali dati Stripe posso sincronizzare con Anvil? +

È possibile interrogare e sincronizzare 15 tabelle Stripe, tra cui clienti, fatture, abbonamenti, addebiti, intenzioni di pagamento, rimborsi, transazioni di saldo, prodotti, prezzi, eventi, controversie, pagamenti, coupon, voci di fattura e voci di abbonamento.

Updated on 3 giugno 2026

Powered by BetterDocs