Xodera Plugins · Bubble Native
Xodera Documents AI Native
Transformatz una fòto de recebut o de liurason en un formulari de borrolhon. Daissatz l'IA suggerir la data, lo total e los autres camps demandats, puèi daissatz una persona los revisar abans de los enregistrar.
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.
Documentacion revisada 6 novèmber 2026
Exemples practics
Preemplenar un borrolhon de despensa amb una fòto de recebut
La picada repetida del comerciant, de la data e del total ralentís la sasida de despesa ; los camps extrachs pòdon èsser un brouch revisable.
`fields_json = ["merchant","date","total","currency"]`; l'utilizaire pren una fòto de recebut e consentís separatament al tractament. Utilizatz sonque de recebuts d'exemple pendent los tèsts.
Previst : `analysis_requested` → Analyze Captured Document en utilizant los octets exportats limitats/MIME/nomes de camps/consentiment/ID de requèsta → afichar los camps retornats dins vòstre formulari de despesa modificable.
L’accion retorna `status`, `operation_id`, `fields_json` e `review_required`. Vòstre utilizaire corrège/apròva los camps abans que lo flux de trabalh crèe una despesa.
Se lo resultat es incert, executatz Read Analysis amb lo meteis `operation_id`; lançatz pas automaticament una autra analisi. Lo retirament del consentiment escafa la captura e l'exportacion gardadas; enregistratz pas jamai lo base64 brut dins un Thing public o dins los jornals.
Previst. Una persona deu revisar cada valor suggerit abans d’enregistrar.
Legir una referéncia de nòta de liurason per un formulari de revisió del personal
Un utilizaire d’entrepàu deuriá poder revisar una referéncia/data suggerida al luòc de la picar a partir d’un talon de papièr fotografiat.
`fields_json = ["delivery_reference","supplier","delivery_date"]` ; capturatz lo costat pertinent d’una nòta de liurason d’exemple pendent los tèsts.
Aprèp de consentiments separats per la captura e pel tractament, Analyze Captured Document prepausa los camps seleccionats. Afichatz la fotografia al costat dels camps modificables e demandatz al personal de confirmar lo registre Delivery correspondent.
Gardatz lo `operation_id` retornat per verificar tornarmai lo resultat e `fields_json` coma proposicion. Vòstre flux de trabalh efectua la recèrca o l'actualizacion efectiva de Delivery sonque aprèp la revision del personal.
Los camps mancants, ambigús o incorrèctes requerisson una correccion manuala. Una error del provesidor daissa lo Delivery original inalterat; utilizatz Read Analysis per verificar lo resultat d'una operacion incerta.
Previst. Una persona deu revisar cada valor suggerit abans d’enregistrar.
Suggerir un numèro de sèria d’equipament a partir d’una foto d’etiqueta
Un formulari de mantenença pòt ofrir una suggestion de modèl/sèria revisable quand l’etiqueta d’un actiu es malaisida de picar.
`fields_json = ["manufacturer","model","serial_number"]` ; capturatz una imatge d’etiqueta d’equipament d’exemple ; causissètz vòstre provesidor d’IA dins los paramètres del projècte.
L’accion prevista Analyze Captured Document retorna de cadenas proposadas. Afichatz-las al costat de la foto ; permetètz a l’utilizaire de las corregir abans la recèrca d’actiu o lo flux de trabalh de mantenença.
Utilizatz los `fields_json`, `review_required` e `operation_id` retornats. Tractatz los identificadors coma de tèxte per que vòstra aplicacion conservèsca los zèros inicials.
Se l’imatge es illegibla o lo modèl prepausa una cadena erronèa, permetètz una entrada manuala. Legissètz la meteissa operacion aprèp una responsa incerta al luòc de facturar una autra inferéncia.
Previst. Una persona deu revisar cada valor suggerit abans d’enregistrar.
Qué fonciona ara
Beta privada. La captura de fotos es disponibla per ensag. L’extraccion de camps a partir de la foto es prevista e es pas encara prèsta a èsser utilizada dins vòstra aplicacion.
Crear lo flux de trabalh
Planificat
Flux de trabalh previst. Pas encara disponible dins la beta actuala.
Aquestes exemples utilizan de registres d’aplicacion tals coma Lesson, Message e Order. Remplaçatz-los per vòstres pròpris tipes de donadas e noms d’elements. Las adreças de mèdias d’exemple devon èsser remplaçadas per vòstres pròpris fichièrs.
Previst : causissètz los camps que vòstre formulari necessita, per exemple fields_json=["title","date","total"]. Activatz enable_analysis_export e definissètz analysis_context sul compte o registre seleccionat. Aquestas configuracions d’analisi son pas disponiblas dins la version actuala de captura.
Permet a l’utilizaire de prene una foto e d’acceptar separadament lo tractament. Sus analysis_requested, avètz Analyze Captured Document en utilizant los analysis_image_base64, analysis_mime_type, analysis_fields_json e analysis_consent d’aqueste element. Utilizatz analysis_request_id coma idempotency_key.
Enregistratz los operation_id, request_id e status retornats. Se status val processing, utilizatz Read Analysis amb aquel operation_id per obténer lo resultat mai tard.
Afichatz lo fields_json retornat dins un formulari de revisió modificable. Enregistratz las valors aprovadas solament aprèp que l’utilizaire las verifique e quichèt Confirmar. Conservatz l’enregistrament original fins a aquesta confirmacion.
Configurar un sol còp
Creatz o causissètz vòstre projècte d’aplicacion Bubble dins BestPlugins → Dashboard → Plugins. Causissètz Xodera Documents AI Native, copiatz sa clau, puèi dobrissètz Bubble → Plugins → Xodera Documents AI Native e pegatz-la dins project_api_key. Enregistratz una còp ; puèi utilizatz las accions çai-jos. Cada plugin dins cada projècte a sa pròpria clau.
Demandatz la permission de la camèra e explicatz perqué la foto es necessària. Lo tractament requerís un acord d’utilizaire separat. Causissètz vòstre provesidor d’IA dins los paramètres del projècte ; son utilizacion es facturada per aquel provesidor.
Configurar un sol còp
- Creatz o causissètz vòstre projècte d’aplicacion Bubble a BestPlugins → Dashboard → Plugins.
- Causissètz aqueste plugin e copiatz sa clau de projècte.
- Dobrissètz Bubble → Plugins → Xodera Documents AI Native ; pegatz la clau dins project_api_key e enregistratz.
- Apondètz l’element, causissètz vòstras donadas d’aplicacion e construïtz lo flux de trabalh çai-jos.
- Accès beta privat solament per ara. L’installacion publica e l’activacion pagada son pas encara dobèrtas.
Installacion e 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.
Enregistrar lo resultat dins vòstra aplicacion
Exemple ExpenseDraft: owner, operation_id, request_id, status e proposed_fields_json. Aprèp revision, enregistratz la data aprovada, lo total e los autres camps, e tanben reviewed_by e reviewed_at. Mapatz sonque los camps demandats pel formulari. Metatz pas lo contengut complet de l'imatge dins los jornals ni dins de registres de tèxte ordinari.
Fracàs, anullacion e recuperacion
Se lo resultat es retardat, mantengatz la meteissa demanda e utilizatz Read Analysis per lo operation_id conegut. Prenètz pas una nòva foto ni creatz pas una nòva demanda automaticament. Se l’utilizaire revoca lo consentiment, escafatz la foto e arrestatz d’ofrir lo resultat ; aquò pòt pas recuperar una còpia ja enviada o enregistrada.
Capacitats e limits
Entrada d’imatge prevista : PNG, JPEG o WebP, fins a 5 MiB ; demandatz los noms de camps distinctes 1–32. Revisatz totjorn las valors extrachas. Aquò es pas una verificacion d’identitat, pas una verificacion d’autenticitat de document ni un instrument de decision medicala. Los còsts del provesidor d’IA son separats.
Paramètres, accions e resultats
Utilizatz aqueles noms dins Bubble. Las foncions planificadas son marcadas separadament.
Paramètres beta disponibles
Paramètres de 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 · textEstats
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/noEveniments
capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_errorAccions e lors entradas
Paramètres de l’element · 12
Flux de trabalh previst. Pas encara disponible dins la beta actuala.
document_sidetext · Per defaut: "front"- Valor d’exemple
front - Exemple d'expression Bubble
Capture Side Dropdown's value - Utilizatz la valor del registre comercial actual ; validatz-la contra los limits çai-jos.
button_labeltext · Per defaut: ""- Valor d’exemple
"" - Exemple d'expression Bubble
App Texts' capture_label - Tèxte visible de l'aplicacion; daissatz-lo void per utilizar lo tèxte integrat tradusit ont es disponible. I metatz pas d'informacions secretas d'autentificacion.
consent_texttext · Per defaut: ""- Valor d’exemple
I agree to capture this non-sensitive receipt. - Exemple d'expression Bubble
App Texts' capture_consent - Explicatz lo prètzfach especific de captura/tractament e lo destinatari. L’abandon del consentiment escafa los octets retenguts, pas las còpias anteriors de l’aplicacion.
disabledyes/no · Per defaut: false- Valor d’exemple
no - Exemple d'expression Bubble
GuideHost's is_busy (your yes/no custom state) - Desactivar l’element mentre vòstra aplicacion es ocupada o aquesta accion es indisponibla.
processing_consent_texttext · Per defaut: ""- Valor d’exemple
I agree to send this image to the configured AI provider for draft fields. - Exemple d'expression Bubble
App Texts' processing_consent - Explicatz lo prètzfach especific de captura/tractament e lo destinatari. L’abandon del consentiment escafa los octets retenguts, pas las còpias anteriors de l’aplicacion.
analyze_button_labeltext · Per defaut: ""- Valor d’exemple
"" - Exemple d'expression Bubble
App Texts' analyze_label - Tèxte visible de l'aplicacion; daissatz-lo void per utilizar lo tèxte integrat tradusit ont es disponible. I metatz pas d'informacions secretas d'autentificacion.
languagetext · Per defaut: "auto"- Valor d’exemple
uk - Exemple d'expression Bubble
Current User's preferred_language - Definissètz language=auto per seguir la lenga de l'aparelh o del navegador se aquela lenga es suportada. Entratz un còde de lenga suportat per la causir explicitament.
ui_text_jsontext · Per defaut: ""- Valor d’exemple
{} - Exemple d'expression Bubble
App Settings' player_labels_json (supported keys only) - JSON opcional amb etiquetas de botonas suportadas. Daissatz void per utilizar lo tèxte integrat.
enable_analysis_exportyes/no · Per defaut: false- Valor d’exemple
yes - Exemple d'expression Bubble
App Settings' enable_reviewed_extraction - Previst : permetre a l’accion d’analisi d’utilizar la fotografia aprèp los dos acòrds d’utilizaire. Desactivat per defaut.
analysis_contexttext · Per defaut: ""- Valor d’exemple
<current-user-id> - Exemple d'expression Bubble
Current User's unique id - Valor estable per aqueste compte o enregistrament. Lo cambiar escafa la fotografia precedenta.
is_activeyes/no · Per defaut: true- Valor d’exemple
yes - Exemple d'expression Bubble
GuideHost's view_is_active (your yes/no custom state) - Definissètz yes mentre aquesta vista es dobèrta. Definissètz no quand la quitatz, per que la lectura o lo trabalh en cors se pòsca arrestar.
fields_jsontext · Per defaut: "[\"title\",\"date\",\"total\"]"- Valor d’exemple
["title","date","total"] - Exemple d'expression Bubble
Expense Settings' extraction_fields_json - JSON tablèu de noms de camps d’extraccion demandats ; lo resultat es de donadas proposadas per revisió umana.
Accions e lors entradas · 2
Flux de trabalh previst. Pas encara disponible dins la beta actuala.
Analyze Captured Document
image_base64text · Per defaut: —- Valor d’exemple
<canonical bytes from consented export> - Exemple d'expression Bubble
Document Capture's analysis_image_base64 - Utilizatz la valor del registre comercial actual ; validatz-la contra los limits çai-jos.
mime_typetext · Per defaut: —- Valor d’exemple
image/jpeg - Exemple d'expression Bubble
Document Capture's analysis_mime_type - Utilizatz la valor del registre comercial actual ; validatz-la contra los limits çai-jos.
fields_jsontext · Per defaut: —- Valor d’exemple
["title","date","total"] - Exemple d'expression Bubble
Document Capture's analysis_fields_json - JSON tablèu de noms de camps d’extraccion demandats ; lo resultat es de donadas proposadas per revisió umana.
consentyes/no · Per defaut: —- Valor d’exemple
yes — current processing consent - Exemple d'expression Bubble
Document Capture's analysis_consent - Utilizatz la valor del registre comercial actual ; validatz-la contra los limits çai-jos.
idempotency_keytext · Per defaut: —- Valor d’exemple
<unchanged analysis_request_id> - Exemple d'expression Bubble
Document Capture's analysis_request_id - Utilizatz la valor del registre comercial actual ; validatz-la contra los limits çai-jos.
environmenttext · Per defaut: —- Valor d’exemple
development - Exemple d'expression Bubble
App Settings' selected_environment - Utilizatz la valor del registre comercial actual ; validatz-la contra los limits çai-jos.
Valors retornadas
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noRead Analysis
operation_idtext · Per defaut: —- Valor d’exemple
<returned operation_id> - Exemple d'expression Bubble
Current ExpenseDraft's operation_id - Utilizatz la valor del registre comercial actual ; validatz-la contra los limits çai-jos.
environmenttext · Per defaut: —- Valor d’exemple
development - Exemple d'expression Bubble
App Settings' selected_environment - Utilizatz la valor del registre comercial actual ; validatz-la contra los limits çai-jos.
Valors retornadas
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noEstats e eveniments
Flux de trabalh previst. Pas encara disponible dins la beta actuala.
Estats
capture_status · textResultat actual d’aquesta accion. Utilizatz l’eveniment de fin correspondent abans d’enregistrar lo succès.
local_uri · textEmplaçament del fichièr sus aqueste aparelh. Enregistratz o cargatz lo fichièr separatament se deu èsser mantengut en linha.
mime_type · textValor actual per l’element seleccionat. Legissètz-la aprèp l’eveniment associat.
document_side · textValor actual per l’element seleccionat. Legissètz-la aprèp l’eveniment associat.
image_width · numberValor actual per l’element seleccionat. Legissètz-la aprèp l’eveniment associat.
image_height · numberValor actual per l’element seleccionat. Legissètz-la aprèp l’eveniment associat.
error_code · textInformacions d'error per la darrièra accion. Afichatz un messatge util e prepausatz de tornar ensajar l'operacion pertinenta.
is_capturing · yes/noValor actual per l’element seleccionat. Legissètz-la aprèp l’eveniment associat.
analysis_image_base64 · textValor actual per l’element seleccionat. Legissètz-la aprèp l’eveniment associat.
analysis_mime_type · textValor actual per l’element seleccionat. Legissètz-la aprèp l’eveniment associat.
analysis_fields_json · textValors suggeridas pels camps demandats. Las mostrar per revisió abans d’enregistrar.
analysis_request_id · textIdentificant per aqueste element o accion. Conservar-lo amb l’enregistrament d’aplicacion correspondent. Utiliza lo meteis identificant de demanda al moment de tornar ensajar un resultat incert.
analysis_consent · yes/noValor actual per l’element seleccionat. Legissètz-la aprèp l’eveniment associat.
analysis_export_status · textResultat actual d’aquesta accion. Utilizatz l’eveniment de fin correspondent abans d’enregistrar lo succès.
analysis_export_error · textInformacions d'error per la darrièra accion. Afichatz un messatge util e prepausatz de tornar ensajar l'operacion pertinenta.
analysis_image_bytes · numberValor actual per l’element seleccionat. Legissètz-la aprèp l’eveniment associat.
Eveniments
capture_startedQuand aqueste eveniment se produtz, legissètz los estats relatius a partir del meteis element.
capture_succeededQuand aqueste eveniment se produtz, legissètz los estats relatius a partir del meteis element.
capture_cancelledQuand aqueste eveniment se produtz, legissètz los estats relatius a partir del meteis element.
permission_deniedQuand aqueste eveniment se produtz, legissètz los estats relatius a partir del meteis element.
capture_errorQuand aqueste eveniment se produtz, legissètz los estats relatius a partir del meteis element.
analysis_requestedQuand aqueste eveniment se produtz, legissètz los estats relatius a partir del meteis element.
analysis_export_errorQuand aqueste eveniment se produtz, legissètz los estats relatius a partir del meteis element.
analysis_clearedQuand aqueste eveniment se produtz, legissètz los estats relatius a partir del meteis element.
Questions que los desvolopaires posan
Verifica l’identitat o los documents ?
Non. Propausa de camps de tèxte per revisió. Una imatge de document capturada establisís pas l’identitat, l’autenticitat o una conclusion medicala/financièra.
Cossí fonciona l’abonament ?
Preus previstos : l’installacion del plugin dins Bubble es gratuita. L’accès a BestPlugins es un abonament separat per cada plugin dins cada projècte d’aplicacion Bubble : 7 jorns gratuïts, puèi US$1.50 per mes. Development e Live son incluses. I a pas de limit fix sus lo nombre d’operacions ; los limits de talha de fichièr e de foncionalitats s’aplican encara. La pagina de pagament es pas encara dobèrta. L’ecran d’activacion mostrarà la primièra data de facturacion e las condicions d’annullacion.
Guidas ligadas
Publicacion de Marketplace en espèra
Guida del forum pas publicada
Per obténer d’ajuda, informatz-nos quin plugin e quin aparelh utilizatz, l’accion que ensajatz e çò qu’es capitat. Utilizatz un exemple sens donadas personalas. Partajatz pas jamai vòstra clau o vòstres fichièrs privats.