# אינטגרציות ו-API

> אינטגרציות ו-API עם אוברסייט: חיבור מערכות, סנכרון מידע, Webhooks ובניית ממשקים, עם אוטומציות תפעוליות וטיפול בשגיאות לפי פרויקט.

העמוד המלא: https://oversight.co.il/solutions/integrations

## בקצרה

המערכות שלכם כבר יודעות לעבוד. בואו נחבר ביניהן.

אינטגרציות ו-API שמחברים את המידע לפעולה הבאה בעסק: חיבורים בין מערכות, ממשקים ואוטומציות, עם מיפוי נתונים, תיעוד וטיפול בשגיאות.

- מערכות מחוברות
- פיתוח API
- תהליך תפעולי

## הפירוט

מערכות טובות לא תמיד עובדות יחד. הזמנה יכולה להיקלט בחנות ועדיין להמתין לעדכון מלאי, לחשבונית או לפתיחת משימה. אוברסייט בונה את הרצף ביניהן: מגדירה מה צריך לעבור, מי אחראי למידע ומה מפעיל את הפעולה הבאה. החיבור מתחיל בתהליך העסקי, ולא מסתיים בתשובה מוצלחת מקריאת API אחת.

העבודה יכולה לכלול שימוש בממשקים קיימים או בניית API למערכת הלקוח, לצד Webhooks, המרת שדות וסנכרון חד-כיווני או דו-כיווני. תורים, ניסיונות חוזרים ותיעוד מוגדרים לפי הצורך, כדי להביא בחשבון גם מידע שלא עבר או פעולה שלא הושלמה. כשאין חיבור מוכן מתאים, יכולת הפיתוח מאפשרת לבנות את הדרך בין הכלים הקיימים.

## מה כלול

- **מערכות שמחליפות מידע**: חיבור ל-API ול-Webhooks קיימים, עם מיפוי שדות והמרת נתונים. המקור, היעד ותנאי ההעברה מוגדרים לפי התהליך.
- **API למערכת העסק**: בניית ממשק שמאפשר למערכות נוספות להתחבר למידע ולפעולות של הלקוח. היקף הממשק, ההרשאות והתיעוד מוגדרים בפרויקט.
- **סנכרון לפי מקור אמת**: מידע במערכות כספים, CRM ומלאי יכול להסתנכרן לפי כללים שנבחרו. מגדירים כיווני העברה וקשרים, במקום להניח שכל המערכות מנהלות אותו מידע.
- **אירוע שממשיך לפעולה**: אוטומציות תפעוליות סביב החיבור, כמו משימה או עדכון לאחר אירוע. כל פעולה קשורה למידע ולתנאים שנקבעו.
- **טיפול ותיעוד מסביב**: תורים, ניסיונות חוזרים וטיפול בשגיאות בהתאם לצורך, לצד תיעוד ממשקים והעברת ידע. תמיכה שוטפת מוגדרת בנפרד.

## היתרונות

- **רואים את שני הצדדים**: אוברסייט בוחנת את המידע ואת הפעולה גם במקור וגם ביעד, כדי שהחיבור יתייחס לתהליך ולא רק לשדה שעובר ביניהם.
- **גם מעבר לחיבור המוכן**: יכולת פיתוח מאפשרת לבנות ממשק או התאמה כשהפתרון המובנה אינו מספיק. הצורך אינו חייב להצטמצם לאפשרויות בתפריט הכלי.
- **ממשיכים מהכלים הקיימים**: המהלך נבנה סביב המערכות שמשרתות את העסק. החלפת מערכת אינה ברירת המחדל כשאפשר לחבר את המידע והפעולות שלה.
- **החריגות בתוך התכנון**: מיפוי, המרה ותגובות לשגיאה נכנסים לאפיון. לא מסתפקים בבדיקה של העברה מוצלחת אחת כדי להגדיר את הרצף.
- **החיבור מקבל ידע להמשך**: תיעוד והעברת ידע מצטרפים לפיתוח. אפשר להבין מה עובר, מה מפעיל אותו ומה צריך לבדוק כשמערכת חיצונית משתנה.

## התהליך

1. **ממפים מידע ופעולות**: מגדירים מקור, יעד, שדות ותנאי פעולה ובוחנים את הממשקים הזמינים. מסכמים מה צריך להמשיך מכל אירוע.
2. **מתכננים את החיבור**: בוחרים את כיווני הסנכרון ומגדירים מיפוי, הרשאות וטיפול בחריגות. מפרידים בין חיבור מוכן לפיתוח הנדרש.
3. **מפתחים ומחברים**: בונים את הממשקים והאוטומציות שנבחרו. המימוש מחבר את המידע לתהליך במערכות הרלוונטיות.
4. **בודקים ומעבירים ידע**: בודקים תרחישים, נתונים ותגובות לשגיאה, ומרכזים תיעוד. מעקב ותמיכה לאחר המסירה מוגדרים בנפרד.

## שאלות ותשובות

### האם אפשר לחבר מערכות קיימות?

כן, בהתאם לממשקים ולגישה הזמינים. המהלך מתחיל במיפוי של המידע והפעולות שהעסק צריך לחבר. לא כל מערכת מאפשרת כל פעולה, ולכן החיבור מוגדר לפי המקור, היעד והתרחישים שנבחרו.

### מה עושים כשאין API מתאים?

בוחנים אם קיימת דרך מורשית אחרת לעבוד עם המערכת. אפשר לבנות API למערכת שבשליטת הלקוח או לפתח התאמה לפי האפשרויות הזמינות. אין הבטחה לעקוף מגבלה של מערכת חיצונית שאינה מאפשרת את החיבור.

### האם אפשר לבנות API למערכת שלנו?

כן. אפשר להגדיר ולפתח ממשק חדש למידע ולפעולות במערכת הלקוח, לצד תיעוד והעברת ידע. ההיקף וההרשאות נקבעים לפי המערכות שצריכות להתחבר והצורך העסקי.

### איך מטפלים בשגיאות ובמידע שלא עבר?

האפיון יכול לכלול תורים, ניסיונות חוזרים ובדיקת חריגות לפי התהליך. מגדירים מה קורה כשהמידע חסר או הפעולה נכשלת. אין התחייבות לכך שכל מערכת חיצונית תהיה זמינה או שכל כשל ייפתר אוטומטית.

### האם החיבור כולל מעקב שוטף?

ההקמה כוללת את הפיתוח והבדיקות שנבחרו, יחד עם התיעוד. מעקב ותמיכה שוטפים אינם כלולים אוטומטית. אם נדרשת מסגרת המשך, מגדירים אותה בהתאם למערכות ולחשיבות התהליך.

## פרויקטים

- [Out](https://oversight.co.il/projects/appout.md)
- [Zedix](https://oversight.co.il/projects/zedix.md): Zedix
- [Treasure](https://oversight.co.il/projects/get-treasure.md): Treasure
- [Nano](https://oversight.co.il/projects/nano.md): Nano
- [בר פחימה בע"מ](https://oversight.co.il/projects/barpahima.md): בר פחימה בע"מ
- [BANX](https://oversight.co.il/projects/banx.md): Banx
- [LYB](https://oversight.co.il/projects/lyb.md): LYB
- [שבעה](https://oversight.co.il/projects/landing-thg.md): TH Group
- [Winvice](https://oversight.co.il/projects/winvice.md): Winvice
- [Bible DNA](https://oversight.co.il/projects/bible4dna.md): Bible DNA
- [CargoSys](https://oversight.co.il/projects/cargosys.md): CargoSys
- [MindFly](https://oversight.co.il/projects/mindfly-live.md): MindFly
- [בוגלו שליחויות](https://oversight.co.il/projects/bugalu.md): בוגלו שליחויות
- [FlySure](https://oversight.co.il/projects/flysure.md): FlySure
- [AskU](https://oversight.co.il/projects/asku.md): AskU
- [חוות הגמלים בנגב](https://oversight.co.il/projects/cameland.md): חוות הגמלים בנגב
- [פז"ם התרעות פקע"ר](https://oversight.co.il/projects/pikud-haoref-siren.md): צופר התרעות פקע"ר
- [ממשקי ספקיות ל-ITC](https://oversight.co.il/projects/itc-provider-interfaces.md): ITC
- [City Deal](https://oversight.co.il/projects/citydeal.md): City Deal
- [Nadlan.com](https://oversight.co.il/projects/nadlan.md): Nadlan.com
- [Lumo](https://oversight.co.il/projects/lumo.md)
- [SmartSend](https://oversight.co.il/projects/smartsend.md)
- [Snif](https://oversight.co.il/projects/snif.md)
- [הדס שמני מרפא](https://oversight.co.il/projects/hadasoils.md): הדס שמני מרפא
- [Electro Click](https://oversight.co.il/projects/electro-click.md): Electro Click
- [יריד ביתר](https://oversight.co.il/projects/yarid-b.md): יריד ביתר
- [Origami.ms](https://oversight.co.il/projects/origami.md): Origami.ms
- [התחדשות ישראל](https://oversight.co.il/projects/hitkhadshut-israel.md): התחדשות ישראל
- [BreakHit](https://oversight.co.il/projects/break-hit.md): BreakHit
- [סיירת רחפנים](https://oversight.co.il/projects/sayeret-rahafanim.md): סיירת רחפנים
- [Signow](https://oversight.co.il/projects/signow.md): Signow
- [Commiz](https://oversight.co.il/projects/commiz.md): Commiz
- [סטודיו פוזיטיב](https://oversight.co.il/projects/studio-positive.md): אגודת הסטודנטים בן-גוריון
- [מזל חזוט](https://oversight.co.il/projects/mazalhazut.md): מזל חזוט

## פתרונות משלימים

- [אינטגרציה והטמעה של CRM / ERP](https://oversight.co.il/solutions/crm-erp.md)
- [פיתוח מערכות מידע וניהול](https://oversight.co.il/solutions/management-systems.md)

## מידע מקצועי

- [אינטגרציה שלא נשברת: איך מחברים מערכות שלא נבנו לדבר זו עם זו](https://oversight.co.il/knowledge/automation/api-integrations-guide.md): למה רוב האינטגרציות נופלות בחודש השלישי, ואיך בונים חיבור שממשיך לעבוד גם כשהצד השני משתנה.

## טכנולוגיות

- Make
- Zapier
- Node.js
- SQL