Xodera Plugins · Bubble Native
Xodera Documents AI Native
Shndërroni një foto të faturës ose dërgesës në një formular draft. Lejoni AI-n të sugjerojë datën, totalin dhe fushat e tjera të kërkuara, pastaj lejoni një person t’i shqyrtojë para se t’i ruajë.
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.
Dokumentacioni i rishikuar 6 November 2026
Shembuj praktikë
Paraplotë draftin e shpenzimit nga foto e fatures
Shtypja e përsëritur e tregtarit, datës dhe totalit ngadalëson futurjen e shpenzimeve; fushat e nxjerra mund të jenë një draft i rishikueshëm.
`fields_json = ["merchant","date","total","currency"]`; përdoruesi kap një imazh fature dhe veçmas jep pëlqimin për përpunimin. Përdorni vetëm fatura shembull gjatë testimit.
Planifikuar: `analysis_requested` → Analyze Captured Document duke përdorur bajtët e eksportuar të kufizuar/MIME/emrat e fushave/pëlqimin/ID e kërkesës → shfaq fushat e kthyer në formularin tuaj të editueshëm të Shpenzimit.
Veprimi kthen `status`, `operation_id`, `fields_json` dhe `review_required`. Përdoruesi juaj korrigjon/aprobon fushat përpara se rrjedha juaj e punës të krijojë një Shpenzim.
Në një rezultat të pasigurt, Read Analysis me të njëjtin `operation_id`; mos gjeneroni një analizë tjetër automatikisht. Tërheqja e pëlqimit pastron kapjen/esportin e ruajtur; kurrë mos ruani base64 të papërpunuar në një Thing publik ose në regjistra.
Planifikuar. Një person duhet të rishikojë çdo vlerë të sugjeruar përpara ruajtjes.
Lexoni një referencë të fletës së dërgesës për një formular që shqyrtohet nga stafi
Një përdorues depo duhet të jetë në gjendje të rishikojë një referencë/datë të sugjeruar në vend që ta shtypë nga një fletë letre e fotografuar.
`fields_json = ["delivery_reference","supplier","delivery_date"]`; kapni anën përkatëse të një flete dërgese shembull gjatë testimit.
Pasi përdoruesi të ketë dhënë pëlqimin për marrjen e fotos dhe, veçmas, pëlqimin për përpunimin, Analyze Captured Document propozon fushat e zgjedhura. Shfaqni fotografinë pranë fushave të editueshme dhe kërkoni nga stafi të konfirmojë regjistrin përkatës të Dërgesës.
Mbani `operation_id` e kthyer për të kontrolluar përsëri rezultatin dhe `fields_json` si propozim. Rrjedha juaj e punës kryen kërkimin/azhurnimin real të Dërgesës vetëm pas rishikimit nga stafi.
Fushat e munguar, të paqartë ose të pasakta kërkojnë korrigjim manual. Një gabim i ofruesit lë Dërgesën origjinale të pandryshuar; Read Analysis kontrolloni rezultatin e një operacioni të pasigurt.
Planifikuar. Një person duhet të rishikojë çdo vlerë të sugjeruar përpara ruajtjes.
Sugjeroni një numër serial i pajisjes nga foto e etiketës
Një formular mirëmbajtjeje mund të ofrojë një sugjerim të rishikueshëm të modelit/serialit kur etiketimi i asetit është i vështirë për t’u shtypur.
`fields_json = ["manufacturer","model","serial_number"]`; kapni një imazh shembull të etiketës së pajisjes; zgjidhni ofruesin tuaj AI në cilësimet e projektit.
Veprimi i planifikuar Analyze Captured Document kthen vargje të propozuara. Shfaqini ato pranë fotos; lejoni përdoruesin t’i korrigjojë përpara se kërkimi ose rrjedha juaj e punës për Asetin të fillojë.
Përdorni `fields_json`, `review_required` dhe `operation_id` e kthyer. Trajtoni identifikuesit si tekst që aplikacioni juaj të ruajë zerot në fillim të identifikuesve.
Nëse imazhi është i palexueshëm ose modeli propozon një varg të gabuar, lejoni futjen manuale. Lexoni përsëri të njëjtin operacion pas një përgjigjeje të pasigurt, në vend që të nisni një përpunim tjetër me pagesë nga modeli.
Planifikuar. Një person duhet të rishikojë çdo vlerë të sugjeruar përpara ruajtjes.
Çfarë funksionon tani
Beta private. Kapja e fotove është e disponueshme për testim. Nxjerrja e fushave nga fotoja është e planifikuar dhe ende nuk është gati për përdorim në aplikacionin tuaj.
Krijoni rrjedhën e punës
Planifikuar
Proces i planifikuar. Ende i padisponueshëm në beta-në aktuale.
Këto shembuj përdorin regjistrime aplikacioni si Lesson, Message dhe Order. Zëvendësoni ato me llojet tuaja të të dhënave dhe emrat e elementeve. Adresat e mediave shembull duhet të zëvendësohen me skedarët tuaj.
Planifikuar: zgjidhni fushat që i nevojiten formularit tuaj, për shembull fields_json=["title","date","total"]. Aktivizoni enable_analysis_export dhe caktoni analysis_context në llogarinë ose regjistrin e zgjedhur. Këto rregullime të analizës nuk janë të disponueshme në versionin aktual të kapjes.
Lejoni përdoruesin të bëjë një foto dhe të pajtohet veçmas me përpunimin. Në analysis_requested, ekzekutoni Analyze Captured Document duke përdorur analysis_image_base64, analysis_mime_type, analysis_fields_json dhe analysis_consent të këtij elementi. Përdorni analysis_request_id si idempotency_key.
Ruani operation_id, request_id dhe status e kthyer. Nëse status është processing, përdorni Read Analysis me atë operation_id për ta marrë rezultatin më vonë.
Shfaqni fields_json e kthyer në një formular shqyrtimi të editueshëm. Ruani vlerat e miratuara vetëm pasi përdoruesi i kontrollon dhe shtypë Konfirmo. Mbani regjistrin origjinal deri në atë konfirmim.
Konfigurojeni një herë
Krijoni ose zgjidhni projektin tuaj të aplikacionit Bubble në BestPlugins → Dashboard → Plugins. Zgjidhni Xodera Documents AI Native, kopjoni çelësin e tij, pastaj hapni Bubble → Plugins → Xodera Documents AI Native dhe ngjitni në project_api_key. Ruani një herë; më pas përdorni veprimet më poshtë. Çdo shtojcë në çdo projekt ka çelësin e vet.
Kërkoni leje për kamerën dhe shpjegoni pse nevojitet fotoja. Përpunimi kërkon pëlqim të veçantë nga përdoruesi. Zgjidhni ofruesin tuaj AI në cilësimet e projektit; përdorimi i tij faturizohet nga ai ofrues.
Konfigurojeni një herë
- Krijoni ose zgjidhni projektin tuaj të aplikacionit Bubble në BestPlugins → Dashboard → Plugins.
- Zgjidhni këtë shtojcë dhe kopjoni çelësin e projektit.
- Hapni Bubble → Plugins → Xodera Documents AI Native; ngjitni çelësin në project_api_key dhe ruani.
- Shtoni elementin, zgjidhni të dhënat e aplikacionit tuaj dhe ndërtoni rrjedhën e punës më poshtë.
- Akses beta privat vetëm për momentin. Instalimi publik dhe aktivizimi me pagesë ende nuk janë të hapur.
Instalim dhe abonim
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.
Ruani rezultatin në aplikacionin tuaj
Shembull ExpenseDraft: pronari, operation_id, request_id, status dhe proposed_fields_json. Pas shqyrtimit, ruani datën e miratuar, totalin dhe fushat e tjera, plus reviewed_by dhe reviewed_at. Hartoni vetëm fushat që kërkon formulari juaj. Mos vendosni përmbajtjen e plotë të imazhit në regjistrat e logjeve ose në regjistrat e zakonshëm të tekstit.
Dështim, anulim dhe rikuperim
Nëse rezultati vonohet, mbani të njëjtën kërkesë dhe përdorni Read Analysis për operation_id e njohur. Mos bëni foto të re ose krijoni kërkesë të re automatikisht. Nëse përdoruesi tërheq pëlqimin, fshini foton dhe ndaloni ofrimin e rezultatit; kjo nuk mund të tërheqë mbrapsht një kopje që tashmë është dërguar ose ruajtur.
Aftësitë dhe kufizimet
Hyrje e planifikuar imazhi: PNG, JPEG ose WebP, deri në 5 MiB; kërkoni 1–32 emra të ndryshëm fushash. Gjithmonë shqyrtoni vlerat e nxjerra. Kjo nuk është verifikim identiteti, kontroll i autenticitetit të dokumentit ose mjet vendimmarrjeje mjekësore. Tarifat e ofruesit AI janë të veçanta.
Rregullimet, veprimet dhe rezultatet
Përdorni këto emra në Bubble. Veçoritë e planifikuara janë shënuar veçmas.
Cilësimet beta të disponueshme
Rregullimet e elementit
document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · textGjendjet
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/noNgjarjet
capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_errorVeprimet dhe inputet e tyre
Rregullimet e elementit · 12
Proces i planifikuar. Ende i padisponueshëm në beta-në aktuale.
document_sidetext · Parazgjedhur: "front"- Vlera shembull
front - Shembull i shprehjes Bubble
Capture Side Dropdown's value - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
button_labeltext · Parazgjedhur: ""- Vlera shembull
"" - Shembull i shprehjes Bubble
App Texts' capture_label - Teksti i dukshëm i aplikacionit; bosh përdor kopjen e brendshme të lokalizuar ku mbështetet. Pa kredenciale.
consent_texttext · Parazgjedhur: ""- Vlera shembull
I agree to capture this non-sensitive receipt. - Shembull i shprehjes Bubble
App Texts' capture_consent - Shpjegoni qëllimin specifik të kapjes/përpunimit dhe marrësin. Tërheqja e pëlqimit pastron bajtët e ruajtur, jo kopjet e mëparshme të aplikacionit.
disabledyes/no · Parazgjedhur: false- Vlera shembull
no - Shembull i shprehjes Bubble
GuideHost's is_busy (your yes/no custom state) - Çaktivizo elementin ndërsa aplikacioni juaj është i zënë ose kjo veprim është i padisponueshëm.
processing_consent_texttext · Parazgjedhur: ""- Vlera shembull
I agree to send this image to the configured AI provider for draft fields. - Shembull i shprehjes Bubble
App Texts' processing_consent - Shpjegoni qëllimin specifik të kapjes/përpunimit dhe marrësin. Tërheqja e pëlqimit pastron bajtët e ruajtur, jo kopjet e mëparshme të aplikacionit.
analyze_button_labeltext · Parazgjedhur: ""- Vlera shembull
"" - Shembull i shprehjes Bubble
App Texts' analyze_label - Teksti i dukshëm i aplikacionit; bosh përdor kopjen e brendshme të lokalizuar ku mbështetet. Pa kredenciale.
languagetext · Parazgjedhur: "auto"- Vlera shembull
uk - Shembull i shprehjes Bubble
Current User's preferred_language - Vendosni language=auto për të ndjekur gjuhën e pajisjes ose të shfletuesit, nëse ajo mbështetet. Futni një kod gjuhe të mbështetur për ta zgjedhur gjuhën shprehimisht.
ui_text_jsontext · Parazgjedhur: ""- Vlera shembull
{} - Shembull i shprehjes Bubble
App Settings' player_labels_json (supported keys only) - JSON opsionale me etiketa butonash të mbështetura. Lëreni bosh për të përdorur tekstin e brendshëm.
enable_analysis_exportyes/no · Parazgjedhur: false- Vlera shembull
yes - Shembull i shprehjes Bubble
App Settings' enable_reviewed_extraction - Planifikuar: lejoni veprimin e analizës të përdorë foton vetëm pasi përdoruesi të ketë dhënë veçmas pëlqimin për marrjen e fotos dhe për përpunimin e saj. I çaktivizuar si parazgjedhje.
analysis_contexttext · Parazgjedhur: ""- Vlera shembull
<current-user-id> - Shembull i shprehjes Bubble
Current User's unique id - Vlerë e qëndrueshme për këtë llogari ose rekord. Ndryshimi i saj pastron foton e mëparshme nga ky element.
is_activeyes/no · Parazgjedhur: true- Vlera shembull
yes - Shembull i shprehjes Bubble
GuideHost's view_is_active (your yes/no custom state) - Vendosni yes ndërsa kjo pamje është e hapur. Vendosni no kur dilni, në mënyrë që riprodhimi ose puna aktuale të mund të ndalojë.
fields_jsontext · Parazgjedhur: "[\"title\",\"date\",\"total\"]"- Vlera shembull
["title","date","total"] - Shembull i shprehjes Bubble
Expense Settings' extraction_fields_json - Një array JSON me emrat e fushave që kërkohen për nxjerrje; dalja është një propozim të dhënash për shqyrtim nga një person.
Veprimet dhe inputet e tyre · 2
Proces i planifikuar. Ende i padisponueshëm në beta-në aktuale.
Analyze Captured Document
image_base64text · Parazgjedhur: —- Vlera shembull
<canonical bytes from consented export> - Shembull i shprehjes Bubble
Document Capture's analysis_image_base64 - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
mime_typetext · Parazgjedhur: —- Vlera shembull
image/jpeg - Shembull i shprehjes Bubble
Document Capture's analysis_mime_type - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
fields_jsontext · Parazgjedhur: —- Vlera shembull
["title","date","total"] - Shembull i shprehjes Bubble
Document Capture's analysis_fields_json - Një array JSON me emrat e fushave që kërkohen për nxjerrje; dalja është një propozim të dhënash për shqyrtim nga një person.
consentyes/no · Parazgjedhur: —- Vlera shembull
yes — current processing consent - Shembull i shprehjes Bubble
Document Capture's analysis_consent - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
idempotency_keytext · Parazgjedhur: —- Vlera shembull
<unchanged analysis_request_id> - Shembull i shprehjes Bubble
Document Capture's analysis_request_id - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
environmenttext · Parazgjedhur: —- Vlera shembull
development - Shembull i shprehjes Bubble
App Settings' selected_environment - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Vlerat e kthyera
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noRead Analysis
operation_idtext · Parazgjedhur: —- Vlera shembull
<returned operation_id> - Shembull i shprehjes Bubble
Current ExpenseDraft's operation_id - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
environmenttext · Parazgjedhur: —- Vlera shembull
development - Shembull i shprehjes Bubble
App Settings' selected_environment - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Vlerat e kthyera
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noGjendjet dhe ngjarjet
Proces i planifikuar. Ende i padisponueshëm në beta-në aktuale.
Gjendjet
capture_status · textRezultati aktual i kësaj veprimi. Përdorni ngjarjen përfundimtare përkatëse përpara se të ruani suksesin.
local_uri · textVendndodhja e skedarit në këtë pajisje. Ruani ose ngarkoni skedarin veçmas nëse duhet të mbahet online.
mime_type · textVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
document_side · textVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
image_width · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
image_height · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
error_code · textInformacioni i gabimit për veprimin e fundit. Shfaqni një mesazh i dobishëm dhe ofroni riprovimin përkatës.
is_capturing · yes/noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
analysis_image_base64 · textVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
analysis_mime_type · textVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
analysis_fields_json · textVlera të sugjeruara për fushat e kërkuara. Shfaqini ato për shqyrtim përpara ruajtjes.
analysis_request_id · textIdentifikues për këtë artikull ose veprim. Mbajeni me regjistrin përkatës të aplikacionit. Përdorni të njëjtin identifikues kërkese kur riprovoni një rezultat të pasigurt.
analysis_consent · yes/noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
analysis_export_status · textRezultati aktual i kësaj veprimi. Përdorni ngjarjen përfundimtare përkatëse përpara se të ruani suksesin.
analysis_export_error · textInformacioni i gabimit për veprimin e fundit. Shfaqni një mesazh i dobishëm dhe ofroni riprovimin përkatës.
analysis_image_bytes · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
Ngjarjet
capture_startedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
capture_succeededKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
capture_cancelledKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
permission_deniedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
capture_errorKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
analysis_requestedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
analysis_export_errorKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
analysis_clearedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
Pyetjet që bëjnë zhvilluesit
A e verifikon identitetin ose dokumentet?
Jo. Proponon fusha teksti për shqyrtim. Një imazh i dokumentit të kapur nuk vërteton identitetin, autenticitetin ose një përfundim mjekësor/financiar.
Si funksionon abonimi?
Çmimi i planifikuar: instalimi i shtojcës në Bubble është falas. Qasja në BestPlugins është një abonim i veçantë për çdo shtojcë në çdo projekt aplikacioni Bubble: 7 ditë falas, pastaj US$1.50 në muaj. Development dhe Live përfshihen. Nuk ka kufi të caktuar për numrin e operacioneve; kufizimet për madhësinë e skedarëve dhe për veçoritë vazhdojnë të zbatohen. Pagesa nuk është hapur ende. Ekrani i aktivizimit do të shfaqë datën e parë të faturimit dhe kushtet e anulimit.
Udhëzues të lidhur
Lëshimi në Marketplace është në pritje
Udhëzuesi i forumit nuk është postuar
Për ndihmë, na tregoni cilin shtojcë dhe pajisje përdorni, veprimin që provuat dhe çfarë ndodhi. Përdorni një shembull pa të dhëna personale. Kurrë mos ndani çelësin tuaj ose skedarët privatë.