Інтерфейс захоплення фото Documents AI. Видобуток полів заплановано.

Xodera Plugins · Bubble Native

Xodera Documents AI Native

Перетворіть фото чека чи накладної на чернетку форми. AI пропонує дату, суму й інші потрібні поля, а людина перевіряє їх перед збереженням.

Посібники публічних бета-версій · інструкції Haptics у його картці Bubble

Умови публічної бета-версії: Bubble безкоштовно · 7 днів з карткою, потім 1,50 USD/місяць за плагін у проєкті.

Побудуйте бізнес-процес ↓Налаштування плагіна ↗Native Lab

Документація переглянута 6 листопада 2026

Практичні сценарії

Чернетка витрати з чека

Повторне введення продавця, дати та суми уповільнює введення витрат; витягнуті поля можуть бути чернеткою для перегляду.

`fields_json = ["merchant","date","total","currency"]`; користувач захоплює зображення чеку і окремо дає згоду на обробку. Під час тестування використовуйте лише зразкові чеки.

Заплановано: `analysis_requested` → Analyze Captured Document з використанням обмежених експортованих байтів/MIME/назв полів/згоди/ідентифікатора запиту → показати повернені поля у вашій редагованій формі Видатків.

Дія повертає `status`, `operation_id`, `fields_json` і `review_required`. Ваш користувач виправляє/затверджує поля перед тим, як ваш робочий процес створить Видаток.

При невизначеному результаті Read Analysis з тим же `operation_id`; не запускайте інший аналіз автоматично. Відкликання згоди очищає збережене захоплення/експорт; ніколи не зберігайте необроблений base64 у публічному об’єкті чи журналах.

Заплановано. Людина має перевірити кожне запропоноване значення перед збереженням.

Реквізити накладної

Користувач складу повинен мати можливість переглянути запропоноване посилання/дату замість введення їх з фотографованого паперового листа.

`fields_json = ["delivery_reference","supplier","delivery_date"]`; захопіть відповідну сторону зразка накладної під час тестування.

Після окремої згоди на захоплення/обробку, Analyze Captured Document пропонує вибрані поля. Показуйте фотографію поруч із редагованими полями та просіть співробітника підтвердити відповідний запис Доставки.

Збережіть повернений `operation_id`, щоб ще раз перевірити результат, і `fields_json` як пропозицію. Ваш робочий процес виконує фактичний пошук/оновлення доставки лише після перегляду персоналом.

Відсутні, неоднозначні або неправильні поля потребують ручного виправлення. Помилка провайдера залишає оригінальну доставку без змін; Read Analysis перевіряє результат невизначеної операції.

Заплановано. Людина має перевірити кожне запропоноване значення перед збереженням.

Серійний номер обладнання

Форма технічного обслуговування може пропонувати переглядану пропозицію моделі/серійного номера, коли мітка активу важко вводиться.

`fields_json = ["manufacturer","model","serial_number"]`; захопіть зразок зображення мітки обладнання; виберіть вашого AI‑провайдера у налаштуваннях проєкту.

Запланована дія Analyze Captured Document повертає запропоновані рядки. Відобразьте їх поруч із фото; дозвольте користувачеві виправити їх перед пошуком активу або робочим процесом технічного обслуговування.

Використовуйте повернені `fields_json`, `review_required` та `operation_id`. Обробляйте ідентифікатори як текст, щоб ваш застосунок зберігав провідні нулі.

Якщо зображення нечитаєме або модель пропонує неправильний рядок, дозволіть ручне введення. Прочитайте ту ж операцію після невизначеної відповіді, а не запускайте інше виведення.

Заплановано. Людина має перевірити кожне запропоноване значення перед збереженням.

Що працює зараз

Приватна бета. Фотографування доступне для тестування. Розпізнавання полів із фото заплановане й ще не готове до використання у вашому застосунку.

Побудуйте бізнес-процес

Заплановано

Запланований процес. Ще не доступний у поточній бета-версії.

У прикладах є записи Lesson, Message та Order. Замініть їх на власні типи даних і назви елементів. Замість адрес із прикладів підставте власні файли.

Заплановано: оберіть потрібні поля, наприклад fields_json=["title","date","total"]. Увімкніть enable_analysis_export і задайте analysis_context для вибраного акаунта чи запису. У поточній версії фотографування цих налаштувань ще немає.
Користувач робить фото й окремо погоджується на обробку. На analysis_requested виконайте Analyze Captured Document зі значеннями analysis_image_base64, analysis_mime_type, analysis_fields_json та analysis_consent цього елемента. Передайте analysis_request_id як idempotency_key.
Збережіть отримані operation_id, request_id і status. Якщо status = processing, пізніше отримайте результат через Read Analysis з цим operation_id.
Покажіть fields_json у формі з можливістю редагування. Зберігайте лише перевірені значення після кнопки «Підтвердити». До цього залишайте початковий запис без змін.

Діаграма робочого процесу — не скріншот додатку · SVG

Налаштуйте один раз

Створіть або оберіть проєкт Bubble у BestPlugins → Dashboard → Plugins. Оберіть Xodera Documents AI Native, скопіюйте його ключ, відкрийте Bubble → Plugins → Xodera Documents AI Native і вставте ключ у project_api_key. Збережіть один раз, далі використовуйте дії нижче. Для кожного плагіна в кожному проєкті є окремий ключ.

Запитайте дозвіл на камеру й поясніть, для чого фото. Для обробки потрібна окрема згода користувача. Оберіть AI-провайдера в налаштуваннях проєкту; його використання оплачується окремо.

Налаштуйте один раз

Створіть або оберіть проєкт Bubble у BestPlugins → Dashboard → Plugins.
Оберіть цей плагін і скопіюйте ключ його проєкту.
Відкрийте Bubble → Plugins → Xodera Documents AI Native; вставте ключ у project_api_key і збережіть.
Додайте елемент, оберіть дані свого застосунку та побудуйте workflow нижче.
Наразі лише приватна бета. Публічне встановлення та платна активація ще не відкриті.

Встановлення та підписка

Для Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit та Haptics: безкоштовне встановлення в Bubble, 7 днів пробного доступу з карткою, потім 1,50 USD на місяць за плагін у проєкті. Розробку й робочу версію включено, без ліміту операцій. Обмеження файлів і можливостей залишаються. Перед підтвердженням перевірте оплату й скасування. Інші плагіни недоступні для покупки.

Як записати результат у свою базу

Приклад ExpenseDraft: owner, operation_id, request_id, status і proposed_fields_json. Після перевірки запишіть підтверджені дату, суму й інші поля, а також reviewed_by та reviewed_at. Зіставляйте лише поля, які запитувала форма. Не записуйте повний вміст зображення в журнали або звичайні текстові записи.

Помилки, скасування та відновлення

Якщо результат затримується, залиште той самий запит і використовуйте Read Analysis з відомим operation_id. Не фотографуйте й не створюйте новий запит автоматично. Якщо згоду відкликано, очистьте фото й не пропонуйте результат; уже надіслану або збережену копію відкликати неможливо.

Можливості й обмеження

Заплановано зображення PNG, JPEG або WebP до 5 MiB; від 1 до 32 різних назв полів. Завжди перевіряйте розпізнані значення. Це не перевірка особи, справжності документа або інструмент медичних рішень. Послуги AI-провайдера оплачуються окремо.

Налаштування, дії та результати

Використовуйте ці назви в Bubble. Плановані функції позначені окремо.

Доступні бета‑налаштування

Налаштування елемента

document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · text

Стани

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

Події

capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_error

Дії та їхні параметри

Налаштування елемента · 12

Запланований процес. Ще не доступний у поточній бета-версії.

document_sidetext · Типове значення: "front": Приклад значенняfront; Приклад виразу BubbleCapture Side Dropdown's value; Візьміть значення поточного бізнес-запису й перевірте межі нижче.

button_labeltext · Типове значення: "": Приклад значення""; Приклад виразу BubbleApp Texts' capture_label; Видимий текст app; порожнє значення використовує вбудований переклад, де підтримано. Без секретів.

consent_texttext · Типове значення: "": Приклад значенняI agree to capture this non-sensitive receipt.; Приклад виразу BubbleApp Texts' capture_consent; Поясніть точну мету й отримувача зйомки/обробки. Відкликання очищає утримувані байти, а не вже передані копії.

disabledyes/no · Типове значення: false: Приклад значенняno; Приклад виразу BubbleGuideHost's is_busy (your yes/no custom state); Вимкніть елемент, коли застосунок зайнятий або дія недоступна.

processing_consent_texttext · Типове значення: "": Приклад значенняI agree to send this image to the configured AI provider for draft fields.; Приклад виразу BubbleApp Texts' processing_consent; Поясніть точну мету й отримувача зйомки/обробки. Відкликання очищає утримувані байти, а не вже передані копії.

analyze_button_labeltext · Типове значення: "": Приклад значення""; Приклад виразу BubbleApp Texts' analyze_label; Видимий текст app; порожнє значення використовує вбудований переклад, де підтримано. Без секретів.

languagetext · Типове значення: "auto": Приклад значенняuk; Приклад виразу BubbleCurrent User's preferred_language; Укажіть language=auto, щоб автоматично використати підтримувану мову пристрою або браузера. Щоб обрати мову явно, укажіть підтримуваний код мови.

ui_text_jsontext · Типове значення: "": Приклад значення{}; Приклад виразу BubbleApp Settings' player_labels_json (supported keys only); Необов’язковий JSON із підтримуваними підписами кнопок. Залиште порожнім для вбудованих текстів.

enable_analysis_exportyes/no · Типове значення: false: Приклад значенняyes; Приклад виразу BubbleApp Settings' enable_reviewed_extraction; Заплановано: дозволити дії розпізнавання використовувати фото після обох згод користувача. Типово вимкнено.

analysis_contexttext · Типове значення: "": Приклад значення<current-user-id>; Приклад виразу BubbleCurrent User's unique id; Стале значення цього акаунта або запису. Його зміна очищує попереднє фото.

is_activeyes/no · Типове значення: true: Приклад значенняyes; Приклад виразу BubbleGuideHost's view_is_active (your yes/no custom state); yes, доки ця сторінка відкрита; no під час виходу, щоб зупинити відтворення чи поточну дію.

fields_jsontext · Типове значення: "[\"title\",\"date\",\"total\"]": Приклад значення["title","date","total"]; Приклад виразу BubbleExpense Settings' extraction_fields_json; JSON-масив потрібних полів витягу; результат — запропоновані дані для людської перевірки.

Дії та їхні параметри · 2

Запланований процес. Ще не доступний у поточній бета-версії.

Analyze Captured Document

image_base64text · Типове значення: —: Приклад значення<canonical bytes from consented export>; Приклад виразу BubbleDocument Capture's analysis_image_base64; Візьміть значення поточного бізнес-запису й перевірте межі нижче.

mime_typetext · Типове значення: —: Приклад значенняimage/jpeg; Приклад виразу BubbleDocument Capture's analysis_mime_type; Візьміть значення поточного бізнес-запису й перевірте межі нижче.

fields_jsontext · Типове значення: —: Приклад значення["title","date","total"]; Приклад виразу BubbleDocument Capture's analysis_fields_json; JSON-масив потрібних полів витягу; результат — запропоновані дані для людської перевірки.

consentyes/no · Типове значення: —: Приклад значенняyes — current processing consent; Приклад виразу BubbleDocument Capture's analysis_consent; Візьміть значення поточного бізнес-запису й перевірте межі нижче.

idempotency_keytext · Типове значення: —: Приклад значення<unchanged analysis_request_id>; Приклад виразу BubbleDocument Capture's analysis_request_id; Візьміть значення поточного бізнес-запису й перевірте межі нижче.

environmenttext · Типове значення: —: Приклад значенняdevelopment; Приклад виразу BubbleApp Settings' selected_environment; Візьміть значення поточного бізнес-запису й перевірте межі нижче.

Повернення

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no

Read Analysis

operation_idtext · Типове значення: —: Приклад значення<returned operation_id>; Приклад виразу BubbleCurrent ExpenseDraft's operation_id; Візьміть значення поточного бізнес-запису й перевірте межі нижче.

environmenttext · Типове значення: —: Приклад значенняdevelopment; Приклад виразу BubbleApp Settings' selected_environment; Візьміть значення поточного бізнес-запису й перевірте межі нижче.

Повернення

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no

Стани та події

Запланований процес. Ще не доступний у поточній бета-версії.

Стани

capture_status · text

Поточний результат дії. Перед записом успіху дочекайтеся відповідної події завершення.

local_uri · text

Розташування файлу на цьому пристрої. Збережіть або завантажте його окремо, якщо він потрібен в інтернеті.

mime_type · text