Interfaċċa ta’ Documents AI għall-ġbid tar-ritratti. L-estrazzjoni tal-oqsma hija ppjanata.
Interfaċċa ta’ Documents AI għall-ġbid tar-ritratti. L-estrazzjoni tal-oqsma hija ppjanata.
← Il-gwidi nattivi kollha

Xodera Plugins · Bubble Native

Xodera Documents AI Native

Ibdel ritratt ta’ rċevuta jew ta’ kunsinna f’abbozz ta’ formola. Ħalli l-AI jissuġġerixxi d-data, it-total u oqsma oħra mitluba, imbagħad ħalli persuna tirrevedihom qabel jiġu ssejvjati.

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.

Dokumentazzjoni riveduta 6 Novembru 2026

Eżempji prattiċi

Imla minn qabel abbozz ta’ nefqa minn ritratt ta’ rċevuta

Il-kitba ripetuta tan-negozjant, id-data u t-total tnaqqas il-ħeffa tad-dħul tal-ispejjeż; l-oqsma estratti jistgħu jintużaw bħala abbozz għar-reviżjoni.

`fields_json = ["merchant","date","total","currency"]`; l-utent jaqbad ritratt ta' rċevuta u jikkunsenta l-ipproċessar separatament. Uża biss rċevuti ta' kampjun waqt it-testjar.

Ippjanat: `analysis_requested` → Analyze Captured Document bil-bytes esportati u limitati, MIME, ismijiet tal-oqsma, kunsens u ID tat-talba → uri l-oqsma mogħtija fil-formola Expense li tista’ tiġi editata.

L-azzjoni tagħti `status`, `operation_id`, `fields_json` u `review_required`. L-utent jikkoreġi jew japprova l-oqsma qabel il-fluss tax-xogħol tiegħek joħloq rekord Expense.

Jekk ir-riżultat mhuwiex ċert, uża Read Analysis bl-istess `operation_id`; tibdiex analiżi oħra awtomatikament. L-irtirar tal-kunsens ineħħi l-immaġni u l-esportazzjoni miżmuma; qatt taħżen base64 mhux ipproċessat f’Thing pubbliku jew fil-logs.

Pjanat. Persuna għandha tirrevedi kull valur suġġerit qabel il-ħażna.

Aqra referenza ta' nota ta' kunsinna għal formola ta' reviżjoni tal-persunal

Utent tal-maħżen għandu jkun jista’ jirrevedi referenza jew data suġġerita minflok jiktibha minn karta mfotografata.

`fields_json = ["delivery_reference","supplier","delivery_date"]`; waqt l-ittestjar ħu ritratt tan-naħa rilevanti ta’ nota ta’ kunsinna bħala kampjun.

Wara kunsens separat għar-ritratt u għall-ipproċessar, Analyze Captured Document jissuġġerixxi l-oqsma magħżula. Uri r-ritratt ħdejn oqsma li jistgħu jiġu editati u itlob lill-persunal jikkonferma r-rekord Delivery korrispondenti.

Żomm l-`operation_id` mogħti biex terġa’ tiċċekkja r-riżultat u `fields_json` bħala proposta. Il-fluss tax-xogħol tiegħek jagħmel it-tiftix jew l-aġġornament effettiv tar-rekord Delivery biss wara r-reviżjoni tal-persunal.

Oqsma nieqsa, ambigwi jew żbaljati jeħtieġu korrezzjoni manwali. Żball tal-fornitur iħalli r-rekord Delivery oriġinali mingħajr tibdil; uża Read Analysis biex tiċċekkja r-riżultat ta’ operazzjoni mhux ċerta.

Pjanat. Persuna għandha tirrevedi kull valur suġġerit qabel il-ħażna.

Suggirixxi numru serjali tal-apparat minn ritratt ta' tikketta

Formola ta' manutenzjoni tista' toffri suġġeriment ta' mudell/serje li jista' jiġi rivedut meta tikketta tal-assett tkun diffiċli biex tiġi miktuba.

`fields_json = ["manufacturer","model","serial_number"]`; ħu ritratt ta’ tikketta ta’ apparat bħala kampjun; agħżel il-fornitur AI tiegħek fis-settings tal-proġett.

L-azzjoni ppjanata Analyze Captured Document tagħti valuri tat-test proposti. Urihom ħdejn ir-ritratt; ħalli l-utent jikkoreġihom qabel it-tiftix tar-rekord Asset jew il-fluss tax-xogħol tal-manutenzjoni tiegħek.

Uża l-valuri mogħtija `fields_json`, `review_required` u `operation_id`. Ittratta l-identifikaturi bħala test sabiex l-app tiegħek iżżomm iż-żerijiet fil-bidu.

Jekk l-immaġni ma tistax tinqara jew il-mudell jissuġġerixxi valur tat-test ħażin, ħalli dħul manwali. Aqra l-istess operazzjoni wara tweġiba mhux ċerta minflok tibda analiżi oħra bi ħlas.

Pjanat. Persuna għandha tirrevedi kull valur suġġerit qabel il-ħażna.

X'jaħdem issa

Beta privata. Il‑kaptura ta’ ritratti hija disponibbli għall‑ittestjar. L‑estrazzjoni tal‑oqsma mill‑ritratt hija ppjanata u għadha mhux lesta għall‑użu fl‑applikazzjoni tiegħek.

Ibni l-fluss tax-xogħol

Pjanifikat

Fluss tax-xogħol ippjanat. Għadu mhux disponibbli fil-beta attwali.

Dawn l-eżempji jużaw reġistri tal-app bħal Lesson, Message u Order. Ibdelhom bi tipi ta' data u ismijiet ta' elementi tiegħek. Indirizzi tal-midja tal-eżempju għandhom jiġu mibdula b'fajls tiegħek.

  1. Ppjanat: agħżel l‑oqsma li t‑forma tiegħek teħtieġ, eżempju fields_json=["title","date","total"]. Attiva enable_analysis_export u issettja analysis_context għall‑kont jew ir‑rekord magħżul. Dawn is‑settings tal‑analisi mhux disponibbli fil‑verżjoni attwali tal‑kaptura.

  2. Ħalli l‑utent jieħu r‑ritratt u jaqbel separatament għall‑proċessar. Fuq analysis_requested, eżegwixxi Analyze Captured Document billi tuża analysis_image_base64, analysis_mime_type, analysis_fields_json u analysis_consent ta’ dan l‑element. Uża analysis_request_id bħala idempotency_key.

  3. Issejvja l‑operation_id, request_id u l‑status li ġew rritornati. Jekk il‑status huwa processing, uża Read Analysis flimkien ma’ operation_id biex tirkupra r-riżultat aktar tard.

  4. Uri fields_json mogħti f’formola ta’ reviżjoni li tista’ tiġi editata. Issejvja l-valuri approvati biss wara li l-utent ikun iċċekkjahom u għafas Confirm. Żomm ir-rekord oriġinali sa dik il-konferma.

Dijagramma tal-fluss tax-xogħol — mhux screenshot tal-app

Ikkonfigura darba waħda

Oħloq jew agħżel il-proġett tal-app Bubble tiegħek f’BestPlugins → Dashboard → Plugins. Agħżel Xodera Documents AI Native, ikkopja l-key tiegħu, imbagħad iftaħ Bubble → Plugins → Xodera Documents AI Native u poġġiha f’project_api_key. Issejvja darba; imbagħad uża l-azzjonijiet hawn taħt. Kull plugin f’kull proġett għandu l-key tiegħu.

Itlob permess għall‑kamera u spjega għaliex il‑ritratt huwa meħtieġ. Il‑proċessar jeħtieġ ftehim separat tal‑utent. Agħżel il‑fornitur AI tiegħek fis‑settings tal‑proġett; l‑użu tiegħu jiġi fatturat mill‑fornitur.

Ikkonfigura darba waħda
  1. Oħloq jew agħżel il-proġett tal-app Bubble tiegħek f'BestPlugins → Dashboard → Plugins.
  2. Agħżel din il-plugin u ikkopja l-key tal-proġett tagħha.
  3. Iftaħ Bubble → Plugins → Xodera Documents AI Native; poġġi l-key f’project_api_key u ssejvja.
  4. Żid l-element, agħżel id-data tal-app tiegħek u ibni l-fluss tax-xogħol hawn taħt.
  5. Għalissa hemm biss aċċess għall-beta privata. L-installazzjoni pubblika u l-attivazzjoni bi ħlas għadhom mhumiex miftuħa.
Installazzjoni u abbonament

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.

Issejvja r-riżultat fl-app tiegħek

Eżempju ExpenseDraft: owner, operation_id, request_id, status u proposed_fields_json. Wara r-reviżjoni, issejvja d-data, it-total u l-oqsma l-oħra approvati, flimkien ma’ reviewed_by u reviewed_at. Orbot biss l-oqsma li titlob il-formola tiegħek. Tpoġġix il-kontenut sħiħ tal-immaġni fil-logs jew f’rekords ordinarji tat-test.

Falliment, ikkanċellament u rkupru

Jekk ir-riżultat jittardja, żomm l-istess talba u uża Read Analysis għall-operation_id magħruf. Tiħux ritratt ġdid u toħloqx talba ġdida awtomatikament. Jekk l-utent jirtira l-kunsens, neħħi r-ritratt u tibqax toffri r-riżultat; dan ma jistax jiġbor lura kopja li diġà ntbagħtet jew ġiet issejvjata.

Kapabbiltajiet u limiti

Input tal‑immaġni ppjanat: PNG, JPEG jew WebP, sa 5 MiB; itlob 1–32 ismijiet ta’ oqsma distinti. Dejjem irrevedi l‑valuri estratti. Dan mhux verifika tal‑identità, kontroll tal‑awtentiċità tad‑dokumenti jew għodda ta’ deċiżjoni medika. Ħlasijiet tal‑fornitur AI huma separati.

Konfigurazzjonijiet, azzjonijiet u riżultati

Uża dawn l-ismijiet f'Bubble. Il-karatteristiċi pjanati huma mmarkati separatament.

Settings beta disponibbli

Konfigurazzjonijiet tal-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

Stati

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

Avvenimenti

capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_error

Azzjonijiet u l-inputs tagħhom

Konfigurazzjonijiet tal-element · 12

Fluss tax-xogħol ippjanat. Għadu mhux disponibbli fil-beta attwali.

document_sidetext · Valur predefinit: "front"
Valur eżempjufront
Eżempju ta’ espressjoni BubbleCapture Side Dropdown's value
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
button_labeltext · Valur predefinit: ""
Valur eżempju""
Eżempju ta’ espressjoni BubbleApp Texts' capture_label
Test tal‑applikazzjoni li jidher; vojta juża kopja lokalizzata integrata fejn hija appoġġjata. Ebda kredenzjali.
consent_texttext · Valur predefinit: ""
Valur eżempjuI agree to capture this non-sensitive receipt.
Eżempju ta’ espressjoni BubbleApp Texts' capture_consent
Spjega l-iskop speċifiku tar-ritratt jew tal-ipproċessar u lil min se jintbagħat. L-irtirar tal-kunsens ineħħi l-bytes miżmuma, mhux il-kopji preċedenti tal-app.
disabledyes/no · Valur predefinit: false
Valur eżempjuno
Eżempju ta’ espressjoni BubbleGuideHost's is_busy (your yes/no custom state)
Itfi l‑element waqt li l‑applikazzjoni tiegħek tkun impenjata jew din l‑azzjoni mhux disponibbli.
processing_consent_texttext · Valur predefinit: ""
Valur eżempjuI agree to send this image to the configured AI provider for draft fields.
Eżempju ta’ espressjoni BubbleApp Texts' processing_consent
Spjega l-iskop speċifiku tar-ritratt jew tal-ipproċessar u lil min se jintbagħat. L-irtirar tal-kunsens ineħħi l-bytes miżmuma, mhux il-kopji preċedenti tal-app.
analyze_button_labeltext · Valur predefinit: ""
Valur eżempju""
Eżempju ta’ espressjoni BubbleApp Texts' analyze_label
Test tal‑applikazzjoni li jidher; vojta juża kopja lokalizzata integrata fejn hija appoġġjata. Ebda kredenzjali.
languagetext · Valur predefinit: "auto"
Valur eżempjuuk
Eżempju ta’ espressjoni BubbleCurrent User's preferred_language
Issettja language=auto biex tuża l-lingwa tal-apparat jew tal-browser jekk dik il-lingwa tkun appoġġjata. Daħħal kodiċi ta’ lingwa appoġġjata biex tagħżilha espliċitament.
ui_text_jsontext · Valur predefinit: ""
Valur eżempju{}
Eżempju ta’ espressjoni BubbleApp Settings' player_labels_json (supported keys only)
JSON opzjonal bil‑tikketti tal‑buttuni appoġġjati. Ħalli vojta biex tuża t-test integrat.
enable_analysis_exportyes/no · Valur predefinit: false
Valur eżempjuyes
Eżempju ta’ espressjoni BubbleApp Settings' enable_reviewed_extraction
Pjanat: ħalli l-azzjoni ta' analiżi tuża r-ritratt wara t-tnejn ta' ftehimiet tal-utent. Mitfi b'default.
analysis_contexttext · Valur predefinit: ""
Valur eżempju<current-user-id>
Eżempju ta’ espressjoni BubbleCurrent User's unique id
Valur stabbli għal dan il-kont jew rekord. Meta jinbidel, ineħħi r-ritratt preċedenti mill-element.
is_activeyes/no · Valur predefinit: true
Valur eżempjuyes
Eżempju ta’ espressjoni BubbleGuideHost's view_is_active (your yes/no custom state)
Issettja yes waqt li din il-veduta tkun miftuħa. Issettja no meta toħroġ minnha, sabiex id-daqq jew ix-xogħol attwali jkun jista’ jieqaf.
fields_jsontext · Valur predefinit: "[\"title\",\"date\",\"total\"]"
Valur eżempju["title","date","total"]
Eżempju ta’ espressjoni BubbleExpense Settings' extraction_fields_json
Array JSON tal-ismijiet tal-oqsma li jridu jiġu estratti; l-output huwa data proposta għal reviżjoni minn persuna.
Azzjonijiet u l-inputs tagħhom · 2

Fluss tax-xogħol ippjanat. Għadu mhux disponibbli fil-beta attwali.

Analyze Captured Document
image_base64text · Valur predefinit: —
Valur eżempju<canonical bytes from consented export>
Eżempju ta’ espressjoni BubbleDocument Capture's analysis_image_base64
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
mime_typetext · Valur predefinit: —
Valur eżempjuimage/jpeg
Eżempju ta’ espressjoni BubbleDocument Capture's analysis_mime_type
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
fields_jsontext · Valur predefinit: —
Valur eżempju["title","date","total"]
Eżempju ta’ espressjoni BubbleDocument Capture's analysis_fields_json
Array JSON tal-ismijiet tal-oqsma li jridu jiġu estratti; l-output huwa data proposta għal reviżjoni minn persuna.
consentyes/no · Valur predefinit: —
Valur eżempjuyes — current processing consent
Eżempju ta’ espressjoni BubbleDocument Capture's analysis_consent
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
idempotency_keytext · Valur predefinit: —
Valur eżempju<unchanged analysis_request_id>
Eżempju ta’ espressjoni BubbleDocument Capture's analysis_request_id
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
environmenttext · Valur predefinit: —
Valur eżempjudevelopment
Eżempju ta’ espressjoni BubbleApp Settings' selected_environment
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

Valuri mogħtija

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no
Read Analysis
operation_idtext · Valur predefinit: —
Valur eżempju<returned operation_id>
Eżempju ta’ espressjoni BubbleCurrent ExpenseDraft's operation_id
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
environmenttext · Valur predefinit: —
Valur eżempjudevelopment
Eżempju ta’ espressjoni BubbleApp Settings' selected_environment
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

Valuri mogħtija

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no
Stati u avvenimenti

Fluss tax-xogħol ippjanat. Għadu mhux disponibbli fil-beta attwali.

Stati

capture_status · text

Riżultat kurrenti ta’ din l‑azzjoni. Uża l‑avveniment ta’ tlestija korrispondenti qabel tissejvja suċċess.

local_uri · text

Il-post tal-fajl fuq dan l-apparat. Issejvja jew ittella’ l-fajl separatament jekk irid jinżamm online.

mime_type · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

document_side · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

image_width · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

image_height · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

error_code · text

Informazzjoni dwar l‑żball għall‑azzjoni l‑aktar riċenti. Uri messaġġ ta’ għajnuna u offri r‑retries rilevanti.

is_capturing · yes/no

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

analysis_image_base64 · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

analysis_mime_type · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

analysis_fields_json · text

Valuri suġġeriti għall-oqsma mitluba. Uri tagħhom għall-ir-reviżjoni qabel il-ħażna.

analysis_request_id · text

Identifikatur għal dan l‑oġġett jew azzjoni. Żommuh mal‑rekord tal‑app li jaqbel. Uża l-istess identifikatur tal‑talba meta terġa' tipprova riżultat mhux ċert.

analysis_consent · yes/no

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

analysis_export_status · text

Riżultat kurrenti ta’ din l‑azzjoni. Uża l‑avveniment ta’ tlestija korrispondenti qabel tissejvja suċċess.

analysis_export_error · text

Informazzjoni dwar l‑żball għall‑azzjoni l‑aktar riċenti. Uri messaġġ ta’ għajnuna u offri r‑retries rilevanti.

analysis_image_bytes · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

Avvenimenti

capture_started

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

capture_succeeded

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

capture_cancelled

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

permission_denied

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

capture_error

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

analysis_requested

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

analysis_export_error

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

analysis_cleared

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

Mistoqsijiet li jistaqsu l-iżviluppaturi

Jivverifika l‑identità jew id‑dokumenti?

Le. Jissuġġerixxi oqsma tat-test għall‑reviżjoni. Ritratt ta’ dokument kapturat ma jistax jikkonferma l‑identità, l‑awtentiċità jew konklużjoni medika/finanzjarja.

Kif taħdem is-sottoskrizzjoni?

Prezzijiet ippjanati: l-installazzjoni tal-plugin f’Bubble hija b’xejn. L-aċċess għal BestPlugins huwa abbonament separat għal kull plugin f’kull proġett ta’ app Bubble: 7 ijiem b’xejn, imbagħad US$1.50 fix-xahar. Development u Live huma inklużi. M’hemm l-ebda limitu fiss fuq in-numru ta’ operazzjonijiet; il-limiti tad-daqs tal-fajls u tal-karatteristiċi xorta japplikaw. Il-paġna tal-ħlas għadha mhix miftuħa. L-iskrin tal-attivazzjoni juri d-data tal-ewwel kont u t-termini tal-kanċellazzjoni.

Gwidi relatati

Marketplace ħarġa pendenti

Gwida tal-forum mhux ippubblikata

Għal għajnuna, għidilna liema plugin u apparat qed tuża, l-azzjoni li ppruvajt u x'ġara. Uża eżempju mingħajr data personali. Qatt ma taqsam il-key tiegħek jew fajls privati.