Interface da captura da fotografias Documents AI. L'extracziun da champs è planisada.
Interface da captura da fotografias Documents AI. L'extracziun da champs è planisada.
← Tut las guidas Bubble Native

Xodera Plugins · Bubble Native

Xodera Documents AI Native

Transfurma ina fotografia d'ina quittanza u d'ina furniziun en in sboz da formular. Lascha l'IA proponer la data, la summa ed ils auters champs dumandads; lura als controllescha ina persuna avant da memorisar.

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.

Documentaziun controllada ils 6 da november 2026

Exemplars pratics

Preemplenir in sboz da spaisa cun ina fotografia d'ina quittanza

Endatar repetidamain il commerziant, la data e la summa retardescha l'endataziun da spaisas; ils champs extratgs pon furmar in sboz che po vegnir controllà.

`fields_json = ["merchant","date","total","currency"]`; l'utilisader captura ina maletg da ricevuta e separat dà il consentiment per il processament. Utilisescha mo exempel da ricevutas durant il test.

Planà: `analysis_requested` → Analyze Captured Document cun ils bytes exportads limitads/MIME/numens da champs/consentiment/ID da dumonda → mussar ils champs returnads en tes formular da spesa editabel.

L'acziun returna `status`, `operation_id`, `fields_json` e `review_required`. Tes utilisader corecta/approva ils champs avant che tes flus da lavur cree ina spesa.

Sch'il resultat è incert, dovra Read Analysis cun il medem `operation_id`; na cumenza betg automaticamain in'autra analisa. Revocar il consentiment stizza la fotografia e l'export conservads; na memorisescha mai base64 betg elavurà en in Thing public u en logs.

Planà. Ina persuna sto revizar mintga valur proposta avant da salvar.

Leger ina referenza da nota da spedi per in formular da revì da persunal

In utilisader dal magazzin duess esser abel da revizar ina referenza/data proposta empè da scriverla da ina slip da carta fotografada.

`fields_json = ["delivery_reference","supplier","delivery_date"]`; captura la part relevanta d'ina exempel da nota da spedi durant il test.

Suenter consentiments separads per fotografar ed elavurar, Analyze Captured Document propona ils champs tschernids. Mussa la fotografia sper ils champs modifitgabels e dumonda al persunal da confermar l'endataziun Delivery correspundenta.

Conserva il `operation_id` returnà per controllar puspè il resultat e `fields_json` sco proposta. Tes flus da lavur exequescha la tschertga u actualisaziun effectiva dal Delivery mo suenter la controlla dal persunal.

Champs mancants, ambigus u sbagliads dovran ina correctura manuala. In sbagl dal furnitur lascha il Delivery original senza midadas; dovra Read Analysis per controllar il resultat d'ina operaziun incerta.

Planà. Ina persuna sto revizar mintga valur proposta avant da salvar.

Proponer in numer da seria da l'equipament da ina foto da l'etichetta

In formular da manutenzion po offrir ina proposta revidebla da model/seria cura che l'etichetta d'asset è difficila da scriver.

`fields_json = ["manufacturer","model","serial_number"]`; captura ina maletg d'exempel d'etichetta d'equipament; tscherna tes furnider d'IA en ils parameters dal project.

L'acziun planada Analyze Captured Document returna strings propostas. Mussar las adside da la foto; permetter a l'utilisader da las corettar avant che tes tschertgament d'asset u flus da manutenzion cumenzescha.

Utilisescha ils `fields_json`, `review_required` e `operation_id` returnads. Tratta ils identificaders sco text per che tia app mantegna ils zeros avant.

Sche l'imagin è illegibel u il model propona ina stringa errada, permetta l'entrata manuala. Legia la medema operaziun suenter ina risposta incerta empè da far in'ulteriura inferenza.

Planà. Ina persuna sto revizar mintga valur proposta avant da salvar.

Tge che funcziuna ussa

Beta privata. La captura da fotografias è disponibla per testar. L'extracziun da champs da la fotografia è planificada e n'è anc betg pronta per l'utilisaziun en tia app.

Crear il flus da lavur

Previst

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

Quests exempels dovran endataziuns da l'app sco Lesson, Message ed Order. Remplazza quellas cun tes agens tips da datas e nums d'elements. Remplazza las adressas da medias d'exempel cun tias atgnas datotecas.

  1. Planà: tscherna ils champs che tes formular basegna, per exempel fields_json=["title","date","total"]. Activescha enable_analysis_export e defini analysis_context per il conto u il registraziun selecziunà. Questas configuraziuns d'analisa n'èn betg disponiblas en la versiun actuala da la captura.

  2. Lassa l'utilisader far ina foto e dar il consentiment separà per il processament. Sin analysis_requested, exequa Analyze Captured Document aduprond quest element analysis_image_base64, analysis_mime_type, analysis_fields_json e analysis_consent. Dovra analysis_request_id sco idempotency_key.

  3. Salva il operation_id, request_id e il status retornads. Sch'il status è processing, dovra Read Analysis cun quel operation_id per recuperar il resultat pli tard.

  4. Mosta il fields_json retornà en in formular da reviziun editabel. Salva las valurs approvadas sulet suenter che l'utilisader las controllescha e clicca sin Confirmar. Conserva il registraziun original enfin quella conferma.

Diagramma dal flus da lavur — betg ina captura d’app

Configurar ina giada

Creescha u tscherna tes project d'app Bubble en BestPlugins → Dashboard → Plugins. Tscherna Xodera Documents AI Native, copia sia clav, suenter avra Bubble → Plugins → Xodera Documents AI Native e incolla ella en project_api_key. Salva ina giada; suenter utilisescha las acziuns sutvart. Mintga plugin en mintga project ha sia propria clav.

Dumonda il permess per la camera e explitgescha perche la foto è necessaria. Il processament pretenda in accord separat cun l'utilisader. Tscherna tes furnitur d'IA en ils parameters dal project; l'utilisaziun è facturà dal furnitur.

Configurar ina giada
  1. Creescha u tscherna tes project d'app Bubble en BestPlugins → Dashboard → Plugins.
  2. Tscherna quest plugin e copia sia clav dal project.
  3. Avra Bubble → Plugins → Xodera Documents AI Native; incolla la clav en project_api_key e salva.
  4. Agiunta l'element, tscherna tias datas d'app e construescha il flus da lavur sutvart.
  5. Accès beta privat per ussa mo. Installaziun publica e activaziun cun pajament n'èn anc betg avertas.
Installaziun e abonnament

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.

Memorisar il resultat en tia app

Exempel ExpenseDraft: proprietari, operation_id, request_id, status e proposed_fields_json. Suenter la reviziun, salva la data approvada, il total e ils ulteriurs champs, pli reviewed_by e reviewed_at. Mappa mo ils champs dumandads dal formular. Na metta betg il cuntegn cumplain da la fotografia en ils logs u en registraziuns da text ordinaras.

Falliment, annullar e restaurar

Sch'il resultat è retardà, mantegna la medema dumonda e dovra Read Analysis per il operation_id enconuschent. Na prenda betg ina nova foto ni creescha automaticamain ina nova dumonda. Sch'il utilisader revoca il consentiment, stizza la foto e ferma la proposta dal resultat; quai po betg recuparer ina copia gia tramessa u salvada.

Capacitads e lims

Input d'imagin planifitgà: PNG, JPEG u WebP, enfin 5 MiB; dumonda noms da champs distints 1–32. Reviescha adina las valurs extratas. Quai n'è betg ina verificaziun d'identitad, in controll da l'autenticitad dal document u in utensil per decisiuns medicalas. Las taxas dal furnitur d'IA èn separatas.

Configuraziuns, acziuns e resultats

Utilisescha quests numens en Bubble. Funcziuns planisadas èn marcadas separadamain.

Configuraziuns beta disponiblas

Configuraziun da l'element

document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · text

Stadis

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/no

Eveniments

capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_error

Acziuns e lur inputs

Configuraziun da l'element · 12

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

document_sidetext · Standard: "front"
Valur d'exempelfront
Exempel Bubble expressiunCapture Side Dropdown's value
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
button_labeltext · Standard: ""
Valur d'exempel""
Exempel Bubble expressiunApp Texts' capture_label
Text visibel da l'app; vid duvrar la copia integràda localisada là nua ch'ella è sustegnida. Naginas credenzials.
consent_texttext · Standard: ""
Valur d'exempelI agree to capture this non-sensitive receipt.
Exempel Bubble expressiunApp Texts' capture_consent
Declera l'intent specific da fotografar ed elavurar ed il destinatar. Revocar il consentiment stizza ils bytes conservads, betg las copias precedentas da l'app.
disabledyes/no · Standard: false
Valur d'exempelno
Exempel Bubble expressiunGuideHost's is_busy (your yes/no custom state)
Deactiva l'element cura che tia app è occupada u che questa acziun è betg disponibla.
processing_consent_texttext · Standard: ""
Valur d'exempelI agree to send this image to the configured AI provider for draft fields.
Exempel Bubble expressiunApp Texts' processing_consent
Declera l'intent specific da fotografar ed elavurar ed il destinatar. Revocar il consentiment stizza ils bytes conservads, betg las copias precedentas da l'app.
analyze_button_labeltext · Standard: ""
Valur d'exempel""
Exempel Bubble expressiunApp Texts' analyze_label
Text visibel da l'app; vid duvrar la copia integràda localisada là nua ch'ella è sustegnida. Naginas credenzials.
languagetext · Standard: "auto"
Valur d'exempeluk
Exempel Bubble expressiunCurrent User's preferred_language
Definiescha language=auto per suandar la lingua da l'apparat u dal navigatur, sch'ella è sustegnida. Endatescha in code da lingua sustegnì per tscherner quella explicitamain.
ui_text_jsontext · Standard: ""
Valur d'exempel{}
Exempel Bubble expressiunApp Settings' player_labels_json (supported keys only)
JSON facultativ cun etichettas da buttun sustegnidas. Lascha vid per duvrar il text integrà.
enable_analysis_exportyes/no · Standard: false
Valur d'exempelyes
Exempel Bubble expressiunApp Settings' enable_reviewed_extraction
Planà: permetter a l'acziun d'analisa d'utilisar la fotografia suenter che ambas acords d'utilisader èn acceptads. Deactivà per standard.
analysis_contexttext · Standard: ""
Valur d'exempel<current-user-id>
Exempel Bubble expressiunCurrent User's unique id
Valur stabla per quest conto u registraziun. Modifitgarla stizza la fotografia precedenta.
is_activeyes/no · Standard: true
Valur d'exempelyes
Exempel Bubble expressiunGuideHost's view_is_active (your yes/no custom state)
Definiescha yes durant che questa vista è averta. Definiescha no cura che ti bandunas ella, per che la reproducziun u il lavur actual possia sa fermar.
fields_jsontext · Standard: "[\"title\",\"date\",\"total\"]"
Valur d'exempel["title","date","total"]
Exempel Bubble expressiunExpense Settings' extraction_fields_json
Array JSON dals nums dals champs che duain vegnir extratgs; il resultat è ina proposta da datas per la controlla d'ina persuna.
Acziuns e lur inputs · 2

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

Analyze Captured Document
image_base64text · Standard: —
Valur d'exempel<canonical bytes from consented export>
Exempel Bubble expressiunDocument Capture's analysis_image_base64
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
mime_typetext · Standard: —
Valur d'exempelimage/jpeg
Exempel Bubble expressiunDocument Capture's analysis_mime_type
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
fields_jsontext · Standard: —
Valur d'exempel["title","date","total"]
Exempel Bubble expressiunDocument Capture's analysis_fields_json
Array JSON dals nums dals champs che duain vegnir extratgs; il resultat è ina proposta da datas per la controlla d'ina persuna.
consentyes/no · Standard: —
Valur d'exempelyes — current processing consent
Exempel Bubble expressiunDocument Capture's analysis_consent
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
idempotency_keytext · Standard: —
Valur d'exempel<unchanged analysis_request_id>
Exempel Bubble expressiunDocument Capture's analysis_request_id
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
environmenttext · Standard: —
Valur d'exempeldevelopment
Exempel Bubble expressiunApp Settings' selected_environment
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Valurs returnadas

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no
Read Analysis
operation_idtext · Standard: —
Valur d'exempel<returned operation_id>
Exempel Bubble expressiunCurrent ExpenseDraft's operation_id
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
environmenttext · Standard: —
Valur d'exempeldevelopment
Exempel Bubble expressiunApp Settings' selected_environment
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Valurs returnadas

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no
Stadis e eveniments

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

Stadis

capture_status · text

Resultat actual da questa acziun. Dovra l'eveniment correspundent che inditgescha la fin da l'acziun avant da memorisar il success.

local_uri · text

Posiziun dal datoteca sin quest apparat. Salva u incaricha il datoteca separadamain sch'igl è necessari da mantenerla online.

mime_type · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

document_side · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

image_width · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

image_height · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

error_code · text

Informaziuns d'error per l'ultima acziun. Mussar in messadi d'agid e porscher il reprovà pertinent.

is_capturing · yes/no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

analysis_image_base64 · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

analysis_mime_type · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

analysis_fields_json · text

Valurs proponidas per ils champs dumandads. Mussar las per la reviziun avant da salvar.

analysis_request_id · text

Identificader per quest element u acziun. Mantegna el cun il registr da l'app correspundent. Utilisescha il medem identificader da dumonda cun reprovair in resultat incert.

analysis_consent · yes/no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

analysis_export_status · text

Resultat actual da questa acziun. Dovra l'eveniment correspundent che inditgescha la fin da l'acziun avant da memorisar il success.

analysis_export_error · text

Informaziuns d'error per l'ultima acziun. Mussar in messadi d'agid e porscher il reprovà pertinent.

analysis_image_bytes · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

Eveniments

capture_started

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

capture_succeeded

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

capture_cancelled

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

permission_denied

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

capture_error

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

analysis_requested

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

analysis_export_error

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

analysis_cleared

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

Dumondas che ils sviluppaders fan

Verifichescha quai l'identitad u ils documents?

Na. Quai propona champs da text per reviziun. Ina fotografia da document capturà na stabilescha betg l'identitad, l'autenticitad ni ina conclusiun medicala/finanziala.

Co funcziuna l'abunament?

Prezzi planis: l'installaziun dal plugin en Bubble è gratuita. L'access a BestPlugins è in abunament separat per mintga plugin en mintga project d'app Bubble: 7 dis gratuits, suenter US$1.50 per mais. Development e Live èn inclus. Na dat nagin limit fix per il dumber d'operaziuns; ils limits da grondezza da datoteca e da funcziuns valan anc. Il checkout n'è anc avert. Il visur d'activaziun mussa la prima data da facturaziun e las cundiziuns da annullaziun.

Guidas colliadas

Marketplace publicaziun pendenta

Guida dal forum betg publicada

Per agid, indichescha nus tge plugin e tge apparat ti dovras, l'acziun che ti has empruvà e tge succedì. Dovra in exempel senza datas persunalas. Mai cundivida tia clav ni tes files privats.