
Xodera Plugins · Bubble Native
Xodera Documents AI Native
Transformați o poză a unei chitanțe sau livrări într-un formular ciornă. Lăsați AI să sugereze data, totalul și alte câmpuri solicitate, apoi permiteți unei persoane să le revizuiască înainte de 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.
Documentație revizuită 6 noiembrie 2026
Exemple practice
Completează automat un proiect de cheltuială dintr-o fotografie a bonului
Tastarea repetată a comerciantului, datei și totalului încetinește introducerea cheltuielilor; câmpurile extrase pot constitui un proiect revizuit.
`fields_json = ["merchant","date","total","currency"]`; utilizatorul capturează o imagine a bonului și consimte separat la prelucrare. Folosiți doar bonuri de probă în timpul testării.
Planificat: `analysis_requested` → Analyze Captured Document utilizând octeții exportați limitați/MIME/nume de câmpuri/consimțământ/ID cerere → afișați câmpurile returnate în formularul de Cheltuieli editabil.
Acțiunea returnează `status`, `operation_id`, `fields_json` și `review_required`. Utilizatorul dvs. corectează/aprobă câmpurile înainte ca fluxul de lucru să creeze o Cheltuială.
În cazul unui rezultat incert, Read Analysis cu același `operation_id`; nu emite automat o altă analiză. Retragerea consimțământului șterge capturile/exporturile reținute; nu păstra niciodată raw base64 într-un Thing public sau în jurnale.
Planificat. O persoană trebuie să revizuiască fiecare valoare sugerată înainte de a salva.
Citește o referință de bon de livrare pentru un formular de revizuire al personalului
Un utilizator al depozitului ar trebui să poată revizui o referință/data sugerată în loc să o tasteze dintr-un bon tipărit fotografiat.
`fields_json = ["delivery_reference","supplier","delivery_date"]`; capturează partea relevantă a unui bon de livrare de probă în timpul testării.
După consimțământ separat pentru capturare/prelucrare, Analyze Captured Document propune câmpurile selectate. Afișează fotografia lângă câmpurile editabile și solicită personalului să confirme înregistrarea de livrare corespunzătoare.
Păstrează `operation_id` returnat pentru a verifica din nou rezultatul și `fields_json` ca propunere. Fluxul tău de lucru efectuează căutarea/actualizarea efectivă a livrării numai după revizuirea de către personal.
Câmpurile lipsă, ambigue sau incorecte necesită corecție manuală. O eroare a furnizorului lasă livrarea originală neschimbată; Read Analysis verifică rezultatul unei operații incerte.
Planificat. O persoană trebuie să revizuiască fiecare valoare sugerată înainte de a salva.
Sugerează un număr de serie al echipamentului dintr-o fotografie a etichetei
Un formular de întreținere poate oferi o sugestie de model/serie revizuită când eticheta unui activ este dificil de tastat.
`fields_json = ["manufacturer","model","serial_number"]`; capturați o imagine de probă a etichetei echipamentului; alegeți furnizorul AI în setările proiectului.
Acțiunea planificată Analyze Captured Document returnează șiruri propuse. Afișați-le lângă fotografie; permiteți utilizatorului să le corecteze înainte de căutarea activului sau fluxul de lucru de întreținere.
Utilizați `fields_json`, `review_required` și `operation_id` returnate. Tratați identificatorii ca text pentru ca aplicația să păstreze zerourile de la început.
Dacă imaginea este ilizibilă sau modelul propune un șir greșit, permiteți introducerea manuală. Citiți aceeași operație după un răspuns incert în loc să taxați o altă inferență.
Planificat. O persoană trebuie să revizuiască fiecare valoare sugerată înainte de a salva.
Ce funcționează acum
Beta privată. Capturarea fotografiilor este disponibilă pentru testare. Extracția câmpurilor din fotografie este planificată și nu este încă pregătită pentru utilizare în aplicația dvs.
Construiește fluxul de lucru
Planificat
Flux de lucru planificat. Nu este încă disponibil în beta curentă.
Aceste exemple folosesc înregistrări de aplicație precum Lesson, Message și Order. Înlocuiți-le cu propriile tipuri de date și nume de elemente. Adresele media de exemplu trebuie înlocuite cu fișierele dumneavoastră.
Planificat: alegeți câmpurile de care are nevoie formularul dvs., de exemplu fields_json=["title","date","total"]. Activați enable_analysis_export și setați analysis_context la contul sau înregistrarea selectată. Aceste setări de analiză nu sunt disponibile în versiunea curentă de captură.
Permiteți utilizatorului să facă o fotografie și să accepte separat procesarea. Pe analysis_requested, rulați Analyze Captured Document utilizând analysis_image_base64, analysis_mime_type, analysis_fields_json și analysis_consent ale acestui element. Folosiți analysis_request_id ca idempotency_key.
Salvați operation_id și request_id returnate și status. Dacă status este processing, folosiți Read Analysis cu acel operation_id pentru a prelua rezultatul mai târziu.
Afișați fields_json returnat într-un formular de revizuire editabil. Salvați valorile aprobate numai după ce utilizatorul le verifică și apasă Confirmă. Păstrați înregistrarea originală până la acea confirmare.
Configurează o singură dată
Creați sau alegeți proiectul de aplicație Bubble în BestPlugins → Dashboard → Plugins. Alegeți Xodera Documents AI Native, copiați cheia acestuia, apoi deschideți Bubble → Plugins → Xodera Documents AI Native și inserați-o în project_api_key. Salvați o singură dată; apoi utilizați acțiunile de mai jos. Fiecare plugin din fiecare proiect are propria cheie.
Solicitați permisiunea camerei și explicați de ce este necesară fotografia. Procesarea necesită un acord separat al utilizatorului. Alegeți furnizorul AI în setările proiectului; utilizarea acestuia este facturată de către furnizor.
Configurează o singură dată
- Creați sau alegeți proiectul de aplicație Bubble la BestPlugins → Dashboard → Plugins.
- Selectați acest plugin și copiați cheia proiectului.
- Deschideți Bubble → Plugins → Xodera Documents AI Native; inserați cheia în project_api_key și salvați.
- Adăugați elementul, alegeți datele aplicației și construiți fluxul de lucru de mai jos.
- Acces beta privat doar pentru moment. Instalarea publică și activarea plătită nu sunt încă deschise.
Instalare și abonament
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.
Salvează rezultatul în aplicația ta
Exemplu ExpenseDraft: proprietar, operation_id, request_id, stare și proposed_fields_json. După revizuire, salvați data aprobată, totalul și alte câmpuri, plus reviewed_by și reviewed_at. Mapati doar câmpurile solicitate de formularul dvs. Nu introduceți conținutul complet al imaginii în jurnale sau în înregistrări text obișnuite.
Eșec, anulare și recuperare
Dacă rezultatul este întârziat, păstrați aceeași cerere și folosiți Read Analysis pentru operation_id cunoscut. Nu faceți o nouă fotografie sau creați automat o nouă cerere. Dacă utilizatorul își retrage consimțământul, ștergeți fotografia și opriți oferirea rezultatului; aceasta nu poate retrage o copie deja trimisă sau salvată.
Capacități și limite
Intrare imagine planificată: PNG, JPEG sau WebP, până la 5 MiB; solicitați nume de câmp distincte 1–32. Revizuiți întotdeauna valorile extrase. Aceasta nu este verificare a identității, nici control al autenticității documentului, nici un instrument de decizie medicală. Taxele furnizorului AI sunt separate.
Setări, acțiuni și rezultate
Utilizați aceste nume în Bubble. Funcționalitățile planificate sunt marcate separat.
Setări beta disponibile
Setări element
document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · textStări
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/noEvenimente
capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_errorAcțiuni și intrările lor
Setări element · 12
Flux de lucru planificat. Nu este încă disponibil în beta curentă.
document_sidetext · Implicit: "front"- Valoare exemplu
front - Exemplu Bubble expresie
Capture Side Dropdown's value - Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.
button_labeltext · Implicit: ""- Valoare exemplu
"" - Exemplu Bubble expresie
App Texts' capture_label - Text vizibil al aplicației; lăsat gol se folosește copia localizată încorporată acolo unde este suportată. Fără acreditări.
consent_texttext · Implicit: ""- Valoare exemplu
I agree to capture this non-sensitive receipt. - Exemplu Bubble expresie
App Texts' capture_consent - Explicați scopul specific al capturii/procesării și destinatarul. Retragerea consimțământului șterge datele reținute, nu copiile anterioare ale aplicației.
disabledyes/no · Implicit: false- Valoare exemplu
no - Exemplu Bubble expresie
GuideHost's is_busy (your yes/no custom state) - Dezactivați elementul în timp ce aplicația este ocupată sau această acțiune nu este disponibilă.
processing_consent_texttext · Implicit: ""- Valoare exemplu
I agree to send this image to the configured AI provider for draft fields. - Exemplu Bubble expresie
App Texts' processing_consent - Explicați scopul specific al capturii/procesării și destinatarul. Retragerea consimțământului șterge datele reținute, nu copiile anterioare ale aplicației.
analyze_button_labeltext · Implicit: ""- Valoare exemplu
"" - Exemplu Bubble expresie
App Texts' analyze_label - Text vizibil al aplicației; lăsat gol se folosește copia localizată încorporată acolo unde este suportată. Fără acreditări.
languagetext · Implicit: "auto"- Valoare exemplu
uk - Exemplu Bubble expresie
Current User's preferred_language - Setați language=auto să urmeze limba unui dispozitiv sau a unui browser acceptat. Introduceți un cod de limbă acceptat pentru a o selecta explicit.
ui_text_jsontext · Implicit: ""- Valoare exemplu
{} - Exemplu Bubble expresie
App Settings' player_labels_json (supported keys only) - JSON opțional cu etichete de buton acceptate. Lăsați gol pentru a utiliza textul încorporat.
enable_analysis_exportyes/no · Implicit: false- Valoare exemplu
yes - Exemplu Bubble expresie
App Settings' enable_reviewed_extraction - Planificat: permite acțiunii de analiză să folosească fotografia după ambele acorduri ale utilizatorului. Dezactivat în mod implicit.
analysis_contexttext · Implicit: ""- Valoare exemplu
<current-user-id> - Exemplu Bubble expresie
Current User's unique id - Valoare stabilă pentru acest cont sau înregistrare. Modificarea acesteia șterge fotografia anterioară.
is_activeyes/no · Implicit: true- Valoare exemplu
yes - Exemplu Bubble expresie
GuideHost's view_is_active (your yes/no custom state) - Setați da în timp ce această vizualizare este deschisă. Setați nu la părăsire, pentru ca redarea sau lucrarea curentă să se oprească.
fields_jsontext · Implicit: "[\"title\",\"date\",\"total\"]"- Valoare exemplu
["title","date","total"] - Exemplu Bubble expresie
Expense Settings' extraction_fields_json - JSON listă de nume de câmpuri de extragere solicitate; rezultatul este date propuse pentru revizuirea umană.
Acțiuni și intrările lor · 2
Flux de lucru planificat. Nu este încă disponibil în beta curentă.
Analyze Captured Document
image_base64text · Implicit: —- Valoare exemplu
<canonical bytes from consented export> - Exemplu Bubble expresie
Document Capture's analysis_image_base64 - Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.
mime_typetext · Implicit: —- Valoare exemplu
image/jpeg - Exemplu Bubble expresie
Document Capture's analysis_mime_type - Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.
fields_jsontext · Implicit: —- Valoare exemplu
["title","date","total"] - Exemplu Bubble expresie
Document Capture's analysis_fields_json - JSON listă de nume de câmpuri de extragere solicitate; rezultatul este date propuse pentru revizuirea umană.
consentyes/no · Implicit: —- Valoare exemplu
yes — current processing consent - Exemplu Bubble expresie
Document Capture's analysis_consent - Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.
idempotency_keytext · Implicit: —- Valoare exemplu
<unchanged analysis_request_id> - Exemplu Bubble expresie
Document Capture's analysis_request_id - Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.
environmenttext · Implicit: —- Valoare exemplu
development - Exemplu Bubble expresie
App Settings' selected_environment - Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.
Returnări
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noRead Analysis
operation_idtext · Implicit: —- Valoare exemplu
<returned operation_id> - Exemplu Bubble expresie
Current ExpenseDraft's operation_id - Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.
environmenttext · Implicit: —- Valoare exemplu
development - Exemplu Bubble expresie
App Settings' selected_environment - Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.
Returnări
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noStări și evenimente
Flux de lucru planificat. Nu este încă disponibil în beta curentă.
Stări
capture_status · textRezultatul curent al acestei acțiuni. Utilizați evenimentul de finalizare corespunzător înainte de a salva cu succes.
local_uri · textLocația fișierului pe acest dispozitiv. Salvați sau încărcați fișierul separat dacă trebuie să fie păstrat online.
mime_type · textValoarea curentă pentru elementul selectat. Citiți‑o după evenimentul asociat.
document_side · textValoarea curentă pentru elementul selectat. Citiți‑o după evenimentul asociat.
image_width · numberValoarea curentă pentru elementul selectat. Citiți‑o după evenimentul asociat.
image_height · numberValoarea curentă pentru elementul selectat. Citiți‑o după evenimentul asociat.
error_code · textInformații despre eroarea ultimei acțiuni. Afișați un mesaj util și oferiți o reîncercare relevantă.
is_capturing · yes/noValoarea curentă pentru elementul selectat. Citiți‑o după evenimentul asociat.
analysis_image_base64 · textValoarea curentă pentru elementul selectat. Citiți‑o după evenimentul asociat.
analysis_mime_type · textValoarea curentă pentru elementul selectat. Citiți‑o după evenimentul asociat.
analysis_fields_json · textValori sugerate pentru câmpurile solicitate. Afișează-le pentru revizuire înainte de salvare.
analysis_request_id · textIdentificator pentru acest element sau acțiune. Păstrați-l împreună cu înregistrarea corespunzătoare a aplicației. Utilizați același identificator de cerere când reîncercați un rezultat incert.
analysis_consent · yes/noValoarea curentă pentru elementul selectat. Citiți‑o după evenimentul asociat.
analysis_export_status · textRezultatul curent al acestei acțiuni. Utilizați evenimentul de finalizare corespunzător înainte de a salva cu succes.
analysis_export_error · textInformații despre eroarea ultimei acțiuni. Afișați un mesaj util și oferiți o reîncercare relevantă.
analysis_image_bytes · numberValoarea curentă pentru elementul selectat. Citiți‑o după evenimentul asociat.
Evenimente
capture_startedCând apare acest eveniment, citiți stările aferente din același element.
capture_succeededCând apare acest eveniment, citiți stările aferente din același element.
capture_cancelledCând apare acest eveniment, citiți stările aferente din același element.
permission_deniedCând apare acest eveniment, citiți stările aferente din același element.
capture_errorCând apare acest eveniment, citiți stările aferente din același element.
analysis_requestedCând apare acest eveniment, citiți stările aferente din același element.
analysis_export_errorCând apare acest eveniment, citiți stările aferente din același element.
analysis_clearedCând apare acest eveniment, citiți stările aferente din același element.
Întrebări pe care le pun dezvoltatorii
Verifică identitatea sau documentele?
Nu. Propune câmpuri text pentru revizuire. O imagine de document capturată nu stabilește identitatea, autenticitatea sau o concluzie medicală/financiară.
Cum funcționează abonamentul?
Preț planificat: instalarea pluginului în Bubble este gratuită. Accesul BestPlugins este un abonament separat pentru fiecare plugin în fiecare proiect de aplicație Bubble: 7 zile gratuite, apoi US$1.50 pe lună. Development și Live sunt incluse. Nu există o limită fixă a numărului de operații; limitele de dimensiune a fișierelor și de funcționalități se aplică în continuare. Checkout-ul nu este încă deschis. Ecranul de activare va afișa data primei facturări și condițiile de anulare.
Ghiduri conexe
Lansare Marketplace în așteptare
Ghidul forumului nu a fost postat
Pentru ajutor, spuneți-ne ce plugin și dispozitiv utilizați, acțiunea pe care ați încercat-o și ce s-a întâmplat. Folosiți un exemplu fără date personale. Nu divulgați niciodată cheia sau fișierele private.