Xodera Plugins · Bubble Native
Xodera Documents AI Native
Trasforma una foto di ricevuta o consegna in una bozza di modulo. Consenti all'IA di suggerire data, totale e altri campi richiesti, poi fai revisionare il tutto da una persona prima di salvare.
Public beta guides · Haptics instructions are in its Bubble listing
Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.
Documentazione revisionata 6 novembre 2026
Esempi pratici
Precompila una bozza di spesa da una foto della ricevuta
La digitazione ripetuta di commerciante, data e totale rallenta l'inserimento delle spese; i campi estratti possono costituire una bozza revisionabile.
`fields_json = ["merchant","date","total","currency"]`; l'utente acquisisce un'immagine della ricevuta e acconsente separatamente al trattamento. Usa solo ricevute di esempio durante i test.
Pianificato: `analysis_requested` → Analyze Captured Document usando i byte esportati limitati/MIME/nomi dei campi/consenso/ID della richiesta → mostra i campi restituiti nel tuo modulo Spesa modificabile.
L'azione restituisce `status`, `operation_id`, `fields_json` e `review_required`. Il tuo utente corregge/approva i campi prima che il flusso di lavoro crei una Spesa.
In caso di risultato incerto, Read Analysis con lo stesso `operation_id`; non avviare un'altra analisi automaticamente. Il ritiro del consenso cancella la cattura/esportazione conservata; non memorizzare mai il raw base64 in un oggetto pubblico o nei log.
Pianificato. Una persona deve revisionare ogni valore suggerito prima di salvare.
Leggi un riferimento di nota di consegna per un modulo di revisione del personale
Un utente del magazzino dovrebbe poter revisionare un riferimento/data suggeriti invece di digitarli da una foto di una ricevuta cartacea.
`fields_json = ["delivery_reference","supplier","delivery_date"]`; cattura il lato pertinente di una nota di consegna di esempio durante il test.
Dopo il consenso separato per la cattura/elaborazione, Analyze Captured Document propone i campi selezionati. Mostra la fotografia accanto ai campi modificabili e chiedi allo staff di confermare il record di Consegna corrispondente.
Conserva lo `operation_id` restituito per verificare nuovamente il risultato e `fields_json` come proposta. Il tuo flusso di lavoro esegue la ricerca/aggiornamento effettiva della Consegna solo dopo la revisione del personale.
Campi mancanti, ambigui o errati richiedono correzione manuale. Un errore del fornitore lascia la Consegna originale invariata; Read Analysis verifica il risultato di un'operazione incerta.
Pianificato. Una persona deve revisionare ogni valore suggerito prima di salvare.
Suggerisci un numero di serie dell'attrezzatura da una foto dell'etichetta
Un modulo di manutenzione può offrire un suggerimento di modello/seriale revisionabile quando l'etichetta di un bene è difficile da digitare.
`fields_json = ["manufacturer","model","serial_number"]`; acquisisci un'immagine di esempio dell'etichetta dell'attrezzatura; scegli il tuo provider AI nelle impostazioni del progetto.
L'azione Analyze Captured Document pianificata restituisce le stringhe proposte. Visualizzale accanto alla foto; consenti all'utente di correggerle prima della ricerca dell'Asset o del flusso di lavoro di manutenzione.
Usa `fields_json`, `review_required` e `operation_id` restituiti. Tratta gli identificatori come testo in modo che la tua app conservi gli zeri iniziali.
Se l'immagine è illeggibile o il modello propone una stringa errata, consenti l'inserimento manuale. Leggi la stessa operazione dopo una risposta incerta invece di addebitare un'altra inferenza.
Pianificato. Una persona deve revisionare ogni valore suggerito prima di salvare.
Cosa funziona ora
Beta privata. La cattura foto è disponibile per i test. L'estrazione dei campi dalla foto è pianificata e non è ancora pronta per l'uso nella tua app.
Crea il flusso di lavoro
Pianificato
Flusso di lavoro pianificato. Non è ancora disponibile nella beta attuale.
Questi esempi utilizzano record di app come Lesson, Message e Order. Sostituiscili con i tuoi tipi di dati e nomi di elemento. Gli indirizzi multimediali di esempio devono essere sostituiti con i tuoi file.
Previsto: scegli i campi di cui ha bisogno il tuo modulo, ad esempio fields_json=["title","date","total"]. Abilita enable_analysis_export e imposta analysis_context sull'account o record selezionato. Queste impostazioni di analisi non sono disponibili nella versione di acquisizione corrente.
Consenti all'utente di scattare una foto e di accettare separatamente il trattamento. Su analysis_requested, esegui Analyze Captured Document usando analysis_image_base64, analysis_mime_type, analysis_fields_json e analysis_consent di questo elemento. Usa analysis_request_id come idempotency_key.
Salva lo operation_id, lo request_id restituiti e lo stato. Se status è processing, usa Read Analysis con quello operation_id per recuperare il risultato più tardi.
Mostra lo fields_json restituito in un modulo di revisione modificabile. Salva i valori approvati solo dopo che l'utente li verifica e preme Conferma. Conserva il record originale fino a quella conferma.
Configura una sola volta
Crea o scegli il tuo progetto app Bubble in BestPlugins → Dashboard → Plugins. Scegli Xodera Documents AI Native, copia la sua chiave, quindi apri Bubble → Plugins → Xodera Documents AI Native e incollala in project_api_key. Salva una volta; poi usa le azioni qui sotto. Ogni plugin in ogni progetto ha la propria chiave.
Richiedi l'autorizzazione alla fotocamera e spiega perché è necessaria la foto. L'elaborazione richiede un accordo utente separato. Scegli il tuo provider IA nelle impostazioni del progetto; il suo utilizzo è fatturato dal provider.
Configura una sola volta
- Crea o scegli il tuo progetto app Bubble su BestPlugins → Dashboard → Plugins.
- Scegli questo plugin e copia la sua chiave di progetto.
- Apri Bubble → Plugins → Xodera Documents AI Native; incolla la chiave in project_api_key e salva.
- Aggiungi l'elemento, scegli i dati della tua app e costruisci il flusso di lavoro qui sotto.
- Accesso beta privato solo per ora. L'installazione pubblica e l'attivazione a pagamento non sono ancora disponibili.
Installazione e abbonamento
For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.
Salva il risultato nella tua app
Esempio ExpenseDraft: proprietario, operation_id, request_id, stato e proposed_fields_json. Dopo la revisione, salva la data approvata, il totale e gli altri campi, oltre a reviewed_by e reviewed_at. Mappa solo i campi richiesti dal tuo modulo. Non inserire il contenuto completo dell'immagine nei log o nei normali record di testo.
Errore, annullamento e ripristino
Se il risultato è ritardato, mantieni la stessa richiesta e usa Read Analysis per lo operation_id noto. Non scattare una nuova foto né creare una nuova richiesta automaticamente. Se l'utente revoca il consenso, cancella la foto e interrompi l'offerta del risultato; non è possibile richiamare una copia già inviata o salvata.
Capacità e limiti
Ingresso immagine previsto: PNG, JPEG o WebP, fino a 5 MiB; richiedi nomi di campo distinti 1–32. Rivedi sempre i valori estratti. Questo non è un controllo d'identità, una verifica dell'autenticità del documento né uno strumento di decisione medica. Le tariffe del provider AI sono separate.
Impostazioni, azioni e risultati
Usa questi nomi in Bubble. Le funzionalità pianificate sono contrassegnate separatamente.
Impostazioni beta disponibili
Impostazioni elemento
document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · textStati
capture_status · textlocal_uri · textmime_type · textdocument_side · textimage_width · numberimage_height · numbererror_code · textis_capturing · yes/noanalysis_status · textanalysis_operation_id · textanalysis_fields_json · textanalysis_error_code · textreview_required · yes/nois_analyzing · yes/noEventi
capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_errorAzioni e i loro input
Impostazioni elemento · 12
Flusso di lavoro pianificato. Non è ancora disponibile nella beta attuale.
document_sidetext · Predefinito: "front"- Valore di esempio
front - Esempio di espressione Bubble
Capture Side Dropdown's value - Usa il valore del record aziendale corrente; convalidalo rispetto ai limiti riportati di seguito.
button_labeltext · Predefinito: ""- Valore di esempio
"" - Esempio di espressione Bubble
App Texts' capture_label - Testo visibile dell'app; vuoto utilizza la copia localizzata integrata dove supportata. Nessuna credenziale.
consent_texttext · Predefinito: ""- Valore di esempio
I agree to capture this non-sensitive receipt. - Esempio di espressione Bubble
App Texts' capture_consent - Spiega lo scopo specifico di acquisizione/elaborazione e il destinatario. Il ritiro del consenso cancella i byte conservati, non le copie precedenti dell'app.
disabledyes/no · Predefinito: false- Valore di esempio
no - Esempio di espressione Bubble
GuideHost's is_busy (your yes/no custom state) - Disabilita l'elemento mentre la tua app è occupata o questa azione non è disponibile.
processing_consent_texttext · Predefinito: ""- Valore di esempio
I agree to send this image to the configured AI provider for draft fields. - Esempio di espressione Bubble
App Texts' processing_consent - Spiega lo scopo specifico di acquisizione/elaborazione e il destinatario. Il ritiro del consenso cancella i byte conservati, non le copie precedenti dell'app.
analyze_button_labeltext · Predefinito: ""- Valore di esempio
"" - Esempio di espressione Bubble
App Texts' analyze_label - Testo visibile dell'app; vuoto utilizza la copia localizzata integrata dove supportata. Nessuna credenziale.
languagetext · Predefinito: "auto"- Valore di esempio
uk - Esempio di espressione Bubble
Current User's preferred_language - Imposta language=auto per seguire la lingua di un dispositivo o browser supportato. Inserisci un codice lingua supportato per sceglierla esplicitamente.
ui_text_jsontext · Predefinito: ""- Valore di esempio
{} - Esempio di espressione Bubble
App Settings' player_labels_json (supported keys only) - JSON opzionale con etichette dei pulsanti supportate. Lascia vuoto per usare il testo integrato.
enable_analysis_exportyes/no · Predefinito: false- Valore di esempio
yes - Esempio di espressione Bubble
App Settings' enable_reviewed_extraction - Previsto: consentire all'azione di analisi di utilizzare la foto dopo entrambi gli accordi dell'utente. Disattivato per impostazione predefinita.
analysis_contexttext · Predefinito: ""- Valore di esempio
<current-user-id> - Esempio di espressione Bubble
Current User's unique id - Valore stabile per questo account o record. Modificarlo cancella la foto precedente.
is_activeyes/no · Predefinito: true- Valore di esempio
yes - Esempio di espressione Bubble
GuideHost's view_is_active (your yes/no custom state) - Imposta sì mentre questa vista è aperta. Imposta no quando esci, così la riproduzione o il lavoro corrente può fermarsi.
fields_jsontext · Predefinito: "[\"title\",\"date\",\"total\"]"- Valore di esempio
["title","date","total"] - Esempio di espressione Bubble
Expense Settings' extraction_fields_json - JSON array di nomi dei campi di estrazione richiesti; l'output è dati proposti per la revisione umana.
Azioni e i loro input · 2
Flusso di lavoro pianificato. Non è ancora disponibile nella beta attuale.
Analyze Captured Document
image_base64text · Predefinito: —- Valore di esempio
<canonical bytes from consented export> - Esempio di espressione Bubble
Document Capture's analysis_image_base64 - Usa il valore del record aziendale corrente; convalidalo rispetto ai limiti riportati di seguito.
mime_typetext · Predefinito: —- Valore di esempio
image/jpeg - Esempio di espressione Bubble
Document Capture's analysis_mime_type - Usa il valore del record aziendale corrente; convalidalo rispetto ai limiti riportati di seguito.
fields_jsontext · Predefinito: —- Valore di esempio
["title","date","total"] - Esempio di espressione Bubble
Document Capture's analysis_fields_json - JSON array di nomi dei campi di estrazione richiesti; l'output è dati proposti per la revisione umana.
consentyes/no · Predefinito: —- Valore di esempio
yes — current processing consent - Esempio di espressione Bubble
Document Capture's analysis_consent - Usa il valore del record aziendale corrente; convalidalo rispetto ai limiti riportati di seguito.
idempotency_keytext · Predefinito: —- Valore di esempio
<unchanged analysis_request_id> - Esempio di espressione Bubble
Document Capture's analysis_request_id - Usa il valore del record aziendale corrente; convalidalo rispetto ai limiti riportati di seguito.
environmenttext · Predefinito: —- Valore di esempio
development - Esempio di espressione Bubble
App Settings' selected_environment - Usa il valore del record aziendale corrente; convalidalo rispetto ai limiti riportati di seguito.
Resi
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noRead Analysis
operation_idtext · Predefinito: —- Valore di esempio
<returned operation_id> - Esempio di espressione Bubble
Current ExpenseDraft's operation_id - Usa il valore del record aziendale corrente; convalidalo rispetto ai limiti riportati di seguito.
environmenttext · Predefinito: —- Valore di esempio
development - Esempio di espressione Bubble
App Settings' selected_environment - Usa il valore del record aziendale corrente; convalidalo rispetto ai limiti riportati di seguito.
Resi
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noStati ed eventi
Flusso di lavoro pianificato. Non è ancora disponibile nella beta attuale.
Stati
capture_status · textRisultato corrente di questa azione. Usa l'evento di completamento corrispondente prima di salvare il successo.
local_uri · textPosizione del file su questo dispositivo. Salva o carica il file separatamente se deve essere mantenuto online.
mime_type · textValore corrente per l'elemento selezionato. Leggilo dopo l'evento correlato.
document_side · textValore corrente per l'elemento selezionato. Leggilo dopo l'evento correlato.
image_width · numberValore corrente per l'elemento selezionato. Leggilo dopo l'evento correlato.
image_height · numberValore corrente per l'elemento selezionato. Leggilo dopo l'evento correlato.
error_code · textInformazioni di errore per l'ultima azione. Mostra un messaggio utile e offri il tentativo di nuovo pertinente.
is_capturing · yes/noValore corrente per l'elemento selezionato. Leggilo dopo l'evento correlato.
analysis_image_base64 · textValore corrente per l'elemento selezionato. Leggilo dopo l'evento correlato.
analysis_mime_type · textValore corrente per l'elemento selezionato. Leggilo dopo l'evento correlato.
analysis_fields_json · textValori suggeriti per i campi richiesti. Mostrali per la revisione prima di salvare.
analysis_request_id · textIdentificatore per questo elemento o azione. Conservalo con il record dell'app corrispondente. Usa lo stesso identificatore di richiesta quando riprovi un risultato incerto.
analysis_consent · yes/noValore corrente per l'elemento selezionato. Leggilo dopo l'evento correlato.
analysis_export_status · textRisultato corrente di questa azione. Usa l'evento di completamento corrispondente prima di salvare il successo.
analysis_export_error · textInformazioni di errore per l'ultima azione. Mostra un messaggio utile e offri il tentativo di nuovo pertinente.
analysis_image_bytes · numberValore corrente per l'elemento selezionato. Leggilo dopo l'evento correlato.
Eventi
capture_startedQuando si verifica questo evento, leggi gli stati correlati dallo stesso elemento.
capture_succeededQuando si verifica questo evento, leggi gli stati correlati dallo stesso elemento.
capture_cancelledQuando si verifica questo evento, leggi gli stati correlati dallo stesso elemento.
permission_deniedQuando si verifica questo evento, leggi gli stati correlati dallo stesso elemento.
capture_errorQuando si verifica questo evento, leggi gli stati correlati dallo stesso elemento.
analysis_requestedQuando si verifica questo evento, leggi gli stati correlati dallo stesso elemento.
analysis_export_errorQuando si verifica questo evento, leggi gli stati correlati dallo stesso elemento.
analysis_clearedQuando si verifica questo evento, leggi gli stati correlati dallo stesso elemento.
Domande che gli sviluppatori pongono
Verifica l'identità o i documenti?
No. Propone campi di testo per la revisione. Un'immagine di documento acquisita non stabilisce l'identità, l'autenticità o una conclusione medica/finanziaria.
Come funziona l'abbonamento?
Prezzo pianificato: l'installazione del plugin in Bubble è gratuita. L'accesso a BestPlugins è un abbonamento separato per ogni plugin in ogni progetto app Bubble: 7 giorni gratuiti, poi US$1.50 al mese. Development e Live sono inclusi. Non esiste un limite fisso al numero di operazioni; i limiti di dimensione file e di funzionalità rimangono validi. Il checkout non è ancora aperto. La schermata di attivazione mostrerà la prima data di fatturazione e i termini di cancellazione.
Guide correlate
Rilascio Marketplace in sospeso
Guida del forum non pubblicata
Per assistenza, indicaci quale plugin e dispositivo utilizzi, l'azione che hai provato e cosa è accaduto. Usa un esempio senza dati personali. Non condividere mai la tua chiave o file privati.