יוצרים כתובת סודית במוח העסקי. כל קובץ שהאתר, הסורק או כלי האוטומציה שולחים אליה נכנס למחברת ומעובד כמו העלאה רגילה.
מרפאה מקבלת טופסי קבלה חתומים מהאתר, משרד עורכי דין סורק מסמכים כל ערב, רואה חשבון מקבל חשבוניות במייל. במקום להעלות כל קובץ ידנית, נותנים למוח העסקי כתובת סודית. כל מה שנשלח אליה נכנס למחברת שבחרתם, ונקרא, מתומלל ומופיע בחיפוש כמו כל העלאה. ההגדרה היא כמה לחיצות; את שליחת הקבצים עושים האתר, כלי אוטומציה כמו Make או Zapier, או המפתח שלכם.
1. פותחים את Webhooks במחברות שלי: במוח העסקי פותחים את המחברות שלי ולוחצים Webhooks למעלה. החלון מסביר שקובץ שנשלח ב-POST לכתובת סודית נכנס למוח לבד.
2. נותנים שם ובוחרים לאן הקבצים נכנסים: מקלידים שם, למשל "טפסים מהאתר". בוחרים למחברת קיימת ובוחרים מחברת, או ליצור מחברת חדשה ומקלידים את השם שלה. במחברת חדשה, כל קריאה יכולה גם לקבוע שם משלה כשמוסיפים לכתובת ?title=.
3. לוחצים + צור webhook: ה-webhook מופיע ברשימה עם הכתובת שלו, מתג הפעלה וכיבוי ומספר הקריאות. לוחצים העתק כדי להעתיק את הכתובת.
4. נותנים את הכתובת למי ששולח: מדביקים אותה במקום שבו הכלי שולח קבצים. ב-Make או ב-Zapier זה שלב HTTP ששולח את הקובץ לכתובת בשיטת POST. המפתח שלכם יכול להשתמש בדוגמה שלמטה.
הכתובת היא הסיסמה: כל מי שיש לו את הכתובת יכול להוסיף קבצים למחברת. לא שמים אותה בתוך עמוד אינטרנט ציבורי. אם היא דלפה, מוחקים את ה-webhook ("למחוק את הוובהוק? מערכות חיצוניות שמשתמשות בו יפסיקו לעבוד.") ויוצרים חדש. כבוי משהה אותו בלי למחוק.
שולחים את הקובץ כ-multipart form data בשדה שנקרא file (או files לכמה קבצים), או כגוף הבקשה עצמו עם שם הקובץ בכותרת X-Filename או ב-?filename=. כל סוג קובץ שמחברת מקבלת עובד. התשובה מפרטת כל מסמך שנוסף.
curl -X POST "https://finestructure.ai/api/kb/webhooks/<your-token>/ingest" \ -F "[email protected]" { "status": "accepted", "notebook_id": "...", "documents": [ { "filename": "intake-form-dana-levi.pdf", ... } ] }
Q: השולח מקבל "Unknown or disabled webhook."
A: הכתובת לא נכונה, ה-webhook נמחק, או שהוא כבוי. בודקים את המתג בחלון Webhooks, או מעתיקים שוב את הכתובת.
Q: השולח מקבל "No file in the request (send multipart 'file' or a raw body)."
A: הבקשה הגיעה בלי קובץ. ב-Make או ב-Zapier בודקים שממופה הקובץ עצמו ולא רק השם שלו, ושהשדה נקרא file.
Q: איפה רואים מה הגיע?
A: במחברת, כמו כל העלאה. חלון ה-Webhooks גם סופר את הקריאות.
Q: זה עולה קרדיטים?
A: קבצים שנשלחים כך מעובדים כמו קבצים שאתם מעלים בעצמכם, באותה עלות.
Q: זה אותו דבר כמו ה-webhooks של הסוכנים?
A: לא. ה-webhooks של הסוכנים שולחים הודעות מ-Fine Structure אליכם. webhook של מחברת מקבל קבצים מכם. ראו Webhooks לאירועים של סוכנים.
Related: Notebooks, folders and uploads, Webhooks for agent events, What the Business Brain is, API keys for your account