Xodera Plugins · Bubble Native
Xodera Documents AI Native
Converte unha foto de recibo ou entrega nun borrador de formulario. Deixe que a IA suxira a data, o total e outros campos solicitados, e logo permita que unha persoa os revise antes de gardar.
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.
Documentación revisada 6 novembro 2026
Exemplos prácticos
Completar previamente un borrador de gasto a partir dunha foto de recibo
Escribir repetidamente o comerciante, a data e o total ralentiza a introdución de gastos; os campos extraídos poden ser un borrador revisable.
`fields_json = ["merchant","date","total","currency"]`; o usuario captura unha imaxe de recibo e, por separado, dá consentimento ao procesamento. Use só recibos de mostra durante as probas.
Planificado: `analysis_requested` → Analyze Captured Document usando os bytes exportados limitados/MIME/nomes de campo/consentimento/ID de solicitude → mostrar os campos devoltos no seu formulario de gasto editable.
A acción devolve `status`, `operation_id`, `fields_json` e `review_required`. O seu usuario corrige/aprueba os campos antes de que o seu fluxo de traballo cree un gasto.
Ante un resultado incerto, Read Analysis co mesmo `operation_id`; non emita outra análise automaticamente. A retirada do consentimento elimina a captura/exportación retida; nunca persista o base64 bruto nun Obxecto público ou nos rexistros.
Planificado. Unha persoa debe revisar cada valor suxerido antes de gardar.
Lea unha referencia de nota de entrega para un formulario de revisión do persoal
Un usuario de almacén debería poder revisar unha referencia/data suxerida en vez de tecleala a partir dun talón de papel fotografado.
`fields_json = ["delivery_reference","supplier","delivery_date"]`; capture o lado relevante dunha nota de entrega de mostra durante as probas.
Despois do consentimento separado de captura/procesamento, Analyze Captured Document propón os campos seleccionados. Mostre a fotografía ao lado dos campos editables e solicite ao persoal que confirme o rexistro de entrega coincidente.
Conserve o `operation_id` devolto para comprobar o resultado de novo e `fields_json` como proposta. O seu fluxo de traballo realiza a busca/actualización real da entrega só despois da revisión do persoal.
Os campos que falten, sexan ambiguos ou incorrectos requiren corrección manual. Un erro do provedor deixa a entrega orixinal inalterada; Read Analysis comproba o resultado dunha operación incerta.
Planificado. Unha persoa debe revisar cada valor suxerido antes de gardar.
Suxira un número de serie do equipamento a partir dunha foto da etiqueta
Un formulario de mantemento pode ofrecer unha suxestión de modelo/serie revisable cando a etiqueta do activo é incómoda de escribir.
`fields_json = ["manufacturer","model","serial_number"]`; capture unha imaxe de mostra da etiqueta do equipamento; escolla o seu provedor de IA nos axustes do proxecto.
A acción planificada Analyze Captured Document devolve cadeas propostas. Mostréas ao lado da foto; permita ao usuario corrixilas antes da busca ou fluxo de mantemento do activo.
Use os `fields_json`, `review_required` e `operation_id` devoltos. Trate os identificadores como texto para que a súa aplicación preserve os ceros iniciais.
Se a imaxe é ilegible ou o modelo propón unha cadea errónea, permita a introdución manual. Lea a mesma operación despois dunha resposta incerta en vez de cobrar outra inferencia.
Planificado. Unha persoa debe revisar cada valor suxerido antes de gardar.
O que funciona agora
Beta privada. A captura de fotos está dispoñible para probas. A extracción de campos da foto está prevista e aínda non está lista para usar na súa aplicación.
Crea o fluxo de traballo
Planificado
Fluxo de traballo planificado. Aínda non está dispoñible na versión beta actual.
Estes exemplos usan rexistros de aplicación como Lesson, Message e Order. Substitúeaos polos seus propios tipos de datos e nomes de elementos. Os enderezos de medios de exemplo deben substituírse polos seus propios ficheiros.
Previsto: escolla os campos que necesita o seu formulario, por exemplo fields_json=["title","date","total"]. Active enable_analysis_export e estableza analysis_context na conta ou rexistro seleccionado. Estas configuracións de análise non están dispoñibles na versión actual de captura.
Permita que o usuario tire unha foto e acepte separadamente o procesamento. En analysis_requested, execute Analyze Captured Document usando os analysis_image_base64, analysis_mime_type, analysis_fields_json e analysis_consent deste elemento. Use analysis_request_id como idempotency_key.
Garde operation_id, request_id e status devoltos. Se status ten o valor processing, use Read Analysis con ese operation_id para recuperar o resultado máis tarde.
Mostre o fields_json devolto nun formulario de revisión editable. Garde os valores aprobados só despois de que o usuario os verifique e pulse Confirmar. Mantén o rexistro orixinal ata esa confirmación.
Configura unha vez
Cree ou escolla o seu proxecto de aplicación Bubble en BestPlugins → Dashboard → Plugins. Escolla Xodera Documents AI Native, copie a súa clave, despois abra Bubble → Plugins → Xodera Documents AI Native e péguela en project_api_key. Guarde unha vez; a seguir utilice as accións a continuación. Cada complemento en cada proxecto ten a súa propia clave.
Solicite permiso para a cámara e explique por que se necesita a foto. O procesamento require o consentimento separado do usuario. Escolla o seu provedor de IA nos axustes do proxecto; o seu uso factúrase polo provedor.
Configura unha vez
- Cree ou escolla o seu proxecto de aplicación Bubble en BestPlugins → Dashboard → Plugins.
- Escolla este complemento e copie a súa clave de proxecto.
- Abra Bubble → Plugins → Xodera Documents AI Native; pegue a clave en project_api_key e garde.
- Engada o elemento, escolla os datos da súa aplicación e constrúa o fluxo de traballo a continuación.
- Acceso a beta privada só por agora. A instalación pública e a activación de pago aínda non están abertas.
Instalación e subscrición
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.
Garde o resultado na súa aplicación
Exemplo ExpenseDraft: propietario, operation_id, request_id, estado e proposed_fields_json. Despois da revisión, garde a data aprobada, o total e outros campos, máis reviewed_by e reviewed_at. Mapee só os campos solicitados polo seu formulario. Non inclúa o contido completo da imaxe nos rexistros ou nos textos ordinarios.
Fallo, cancelación e recuperación
Se o resultado se atrasa, manteña a mesma solicitude e use Read Analysis para o coñecido operation_id. Non tome unha nova foto nin cree unha nova solicitude automaticamente. Se o usuario retira o consentimento, elimine a foto e deixe de ofrecer o resultado; isto non pode retirar unha copia xa enviada ou gardada.
Capacidades e límites
Entrada de imaxe prevista: PNG, JPEG ou WebP, ata 5 MiB; solicite nomes de campos distintos 1–32. Revise sempre os valores extraídos. Isto non é verificación de identidade, comprobación da autenticidade do documento nin unha ferramenta de decisión médica. Os cargos do provedor de IA son separados.
Configuracións, accións e resultados
Utilice estes nomes en Bubble. As funcionalidades planificadas están marcadas por separado.
Configuracións beta dispoñibles
Configuración do elemento
document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · textEstados
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/noEventos
capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_errorAccións e as súas entradas
Configuración do elemento · 12
Fluxo de traballo planificado. Aínda non está dispoñible na versión beta actual.
document_sidetext · Predeterminado: "front"- Valor de exemplo
front - Exemplo de expresión Bubble
Capture Side Dropdown's value - Utiliza o valor do rexistro empresarial actual; valídalo contra os límites abaixo.
button_labeltext · Predeterminado: ""- Valor de exemplo
"" - Exemplo de expresión Bubble
App Texts' capture_label - Texto visible da aplicación; baleiro usa a copia localizada incorporada onde se admita. Sen credenciais.
consent_texttext · Predeterminado: ""- Valor de exemplo
I agree to capture this non-sensitive receipt. - Exemplo de expresión Bubble
App Texts' capture_consent - Explique o propósito específico da captura/procesamento e o destinatario. A retirada do consentimento elimina os bytes retidos, non as copias anteriores da aplicación.
disabledyes/no · Predeterminado: false- Valor de exemplo
no - Exemplo de expresión Bubble
GuideHost's is_busy (your yes/no custom state) - Desactiva o elemento mentres a túa aplicación está ocupada ou esta acción non está dispoñible.
processing_consent_texttext · Predeterminado: ""- Valor de exemplo
I agree to send this image to the configured AI provider for draft fields. - Exemplo de expresión Bubble
App Texts' processing_consent - Explique o propósito específico da captura/procesamento e o destinatario. A retirada do consentimento elimina os bytes retidos, non as copias anteriores da aplicación.
analyze_button_labeltext · Predeterminado: ""- Valor de exemplo
"" - Exemplo de expresión Bubble
App Texts' analyze_label - Texto visible da aplicación; baleiro usa a copia localizada incorporada onde se admita. Sen credenciais.
languagetext · Predeterminado: "auto"- Valor de exemplo
uk - Exemplo de expresión Bubble
Current User's preferred_language - Establece language=auto para seguir un dispositivo ou idioma de navegador compatible. Introduce un código de idioma compatible para elixilo explicitamente.
ui_text_jsontext · Predeterminado: ""- Valor de exemplo
{} - Exemplo de expresión Bubble
App Settings' player_labels_json (supported keys only) - JSON opcional con etiquetas de botón compatibles. Déixao baleiro para usar o texto incorporado.
enable_analysis_exportyes/no · Predeterminado: false- Valor de exemplo
yes - Exemplo de expresión Bubble
App Settings' enable_reviewed_extraction - Planificado: permitir que a acción de análise use a foto despois de ambos os acordos do usuario. Desactivado por defecto.
analysis_contexttext · Predeterminado: ""- Valor de exemplo
<current-user-id> - Exemplo de expresión Bubble
Current User's unique id - Valor estable para esta conta ou rexistro. Cambialo elimina a foto anterior.
is_activeyes/no · Predeterminado: true- Valor de exemplo
yes - Exemplo de expresión Bubble
GuideHost's view_is_active (your yes/no custom state) - Establece sí mentres esta vista está aberta. Establece non ao saír, para que a reprodución ou o traballo actual poidan detenerse.
fields_jsontext · Predeterminado: "[\"title\",\"date\",\"total\"]"- Valor de exemplo
["title","date","total"] - Exemplo de expresión Bubble
Expense Settings' extraction_fields_json - JSON matriz de nomes de campos de extracción solicitados; a saída son datos propostos para revisión humana.
Accións e as súas entradas · 2
Fluxo de traballo planificado. Aínda non está dispoñible na versión beta actual.
Analyze Captured Document
image_base64text · Predeterminado: —- Valor de exemplo
<canonical bytes from consented export> - Exemplo de expresión Bubble
Document Capture's analysis_image_base64 - Utiliza o valor do rexistro empresarial actual; valídalo contra os límites abaixo.
mime_typetext · Predeterminado: —- Valor de exemplo
image/jpeg - Exemplo de expresión Bubble
Document Capture's analysis_mime_type - Utiliza o valor do rexistro empresarial actual; valídalo contra os límites abaixo.
fields_jsontext · Predeterminado: —- Valor de exemplo
["title","date","total"] - Exemplo de expresión Bubble
Document Capture's analysis_fields_json - JSON matriz de nomes de campos de extracción solicitados; a saída son datos propostos para revisión humana.
consentyes/no · Predeterminado: —- Valor de exemplo
yes — current processing consent - Exemplo de expresión Bubble
Document Capture's analysis_consent - Utiliza o valor do rexistro empresarial actual; valídalo contra os límites abaixo.
idempotency_keytext · Predeterminado: —- Valor de exemplo
<unchanged analysis_request_id> - Exemplo de expresión Bubble
Document Capture's analysis_request_id - Utiliza o valor do rexistro empresarial actual; valídalo contra os límites abaixo.
environmenttext · Predeterminado: —- Valor de exemplo
development - Exemplo de expresión Bubble
App Settings' selected_environment - Utiliza o valor do rexistro empresarial actual; valídalo contra os límites abaixo.
Valores devoltos
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noRead Analysis
operation_idtext · Predeterminado: —- Valor de exemplo
<returned operation_id> - Exemplo de expresión Bubble
Current ExpenseDraft's operation_id - Utiliza o valor do rexistro empresarial actual; valídalo contra os límites abaixo.
environmenttext · Predeterminado: —- Valor de exemplo
development - Exemplo de expresión Bubble
App Settings' selected_environment - Utiliza o valor do rexistro empresarial actual; valídalo contra os límites abaixo.
Valores devoltos
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noEstados e eventos
Fluxo de traballo planificado. Aínda non está dispoñible na versión beta actual.
Estados
capture_status · textResultado actual desta acción. Usa o evento de finalización coincidente antes de gardar o éxito.
local_uri · textLocalización do ficheiro neste dispositivo. Garde ou cargue o ficheiro por separado se debe permanecer en liña.
mime_type · textValor actual do elemento seleccionado. Léelo despois do evento relacionado.
document_side · textValor actual do elemento seleccionado. Léelo despois do evento relacionado.
image_width · numberValor actual do elemento seleccionado. Léelo despois do evento relacionado.
image_height · numberValor actual do elemento seleccionado. Léelo despois do evento relacionado.
error_code · textInformación de erro da última acción. Mostra unha mensaxe útil e ofrece o reintento correspondente.
is_capturing · yes/noValor actual do elemento seleccionado. Léelo despois do evento relacionado.
analysis_image_base64 · textValor actual do elemento seleccionado. Léelo despois do evento relacionado.
analysis_mime_type · textValor actual do elemento seleccionado. Léelo despois do evento relacionado.
analysis_fields_json · textValores suxeridos para os campos solicitados. Mostraos para revisión antes de gardar.
analysis_request_id · textIdentificador para este elemento ou acción. Mantéña co rexistro da aplicación correspondente. Use o mesmo identificador de solicitude ao volver a intentar un resultado incerto.
analysis_consent · yes/noValor actual do elemento seleccionado. Léelo despois do evento relacionado.
analysis_export_status · textResultado actual desta acción. Usa o evento de finalización coincidente antes de gardar o éxito.
analysis_export_error · textInformación de erro da última acción. Mostra unha mensaxe útil e ofrece o reintento correspondente.
analysis_image_bytes · numberValor actual do elemento seleccionado. Léelo despois do evento relacionado.
Eventos
capture_startedCando ocorra este evento, lea os estados relacionados do mesmo elemento.
capture_succeededCando ocorra este evento, lea os estados relacionados do mesmo elemento.
capture_cancelledCando ocorra este evento, lea os estados relacionados do mesmo elemento.
permission_deniedCando ocorra este evento, lea os estados relacionados do mesmo elemento.
capture_errorCando ocorra este evento, lea os estados relacionados do mesmo elemento.
analysis_requestedCando ocorra este evento, lea os estados relacionados do mesmo elemento.
analysis_export_errorCando ocorra este evento, lea os estados relacionados do mesmo elemento.
analysis_clearedCando ocorra este evento, lea os estados relacionados do mesmo elemento.
Preguntas que os desenvolvedores fan
Verifica a identidade ou os documentos?
Non. Propón campos de texto para revisión. Unha imaxe de documento capturada non establece identidade, autenticidade nin unha conclusión médica/financeira.
Como funciona a subscrición?
Prezo previsto: instalar o complemento en Bubble é gratuíto. O acceso a BestPlugins é unha subscrición separada para cada complemento en cada proxecto de aplicación Bubble: 7 días gratuítos, despois US$1.50 ao mes. Development e Live están incluídos. Non hai un límite fixo no número de operacións; os límites de tamaño de ficheiro e de funcionalidades aínda se aplican. O proceso de compra aínda non está aberto. A pantalla de activación mostrará a primeira data de facturación e os termos de cancelación.
Guías relacionadas
Marketplace publicación pendente
Guía do foro non publicada
Para obter axuda, indícanos que complemento e dispositivo utilizas, a acción que intentaches e o que sucedeu. Usa un exemplo sen datos persoais. Nunca compartas a túa clave ou ficheiros privados.