מפתחים — API, עדכוני Webhooks ומחבר AI

בוחרים את סוג החיבור

לידנייט מאפשרת חיבור ל-API למפתחים באמצעות מפתחות אישיים לשרת וקבלת עדכוני Webhooks חתומים. מחבר ה-AI הנפרד ל-Claude ול-ChatGPT עדיין לא זמין. הוראות המחבר מתארות שימוש לאחר הפעלתו; יצירת מפתח API לא מפעילה אותו.

מה רוצים לעשות	המדריך המתאים	מה צריך לחבר
לחבר שרת, לסנכרן CRM או להפיק דוחות	API למפתחים	יוצרים מפתח אישי דרך הגדרות → API למפתחים ומשתמשים בו בצד השרת בלבד.
לקבל עדכונים על אנשי קשר ומצבי קמפיינים בלי לבדוק שוב ושוב	Webhooks	מוסיפים בהגדרות כתובת HTTPS ציבורית ושומרים את סוד החתימה שמוצג פעם אחת בלבד.
לעבוד בסביבת עבודה מתוך Claude או ChatGPT כשהמחבר ייפתח לשימוש	מחבר AI	מעתיקים את הכתובת מההגדרות, מתחברים ב־OAuth ובוחרים סביבת עבודה במסך ההרשאה.
להעביר תמונות וסרטונים מהמכשיר למחבר העתידי	העלאת קבצים למחבר	פותחים את קישור ההעלאה מהשיחה, מעלים לסביבת העבודה המתאימה וחוזרים לשיחה.
למצוא פעולות, שדות, תשובות ומבני אירועים מדויקים	מפרט ה-API	נעזרים במפרט ובמסמך OpenAPI החי שמתאים גם לכלי פיתוח.

לפני שמחברים שירות

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

שלושה מנגנונים עם פרטי גישה שונים

מפתח אישי ל-API למפתחים

כל מפתח שייך לחשבון אחד ולסביבת עבודה אחת. כתובת הבסיס היא https://api.lead-knight.com/v1, ואת המפתח שולחים בכותרת Authorization: Bearer <key>. הרמות read, write ו־publish קובעות תקרת הרשאות בלבד, בנוסף להרשאות התפקיד והמושב העדכניות. המפתח אינו אמצעי כניסה לאפליקציה, אינו מנהל מפתחות אחרים ואינו מחבר את Claude או ChatGPT.

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

עדכוני Webhooks חתומים

לידנייט שולחת בקשות HTTPS מסוג POST לשרת המקבל. לכל Webhook יש סוד חתימה נפרד שמתחיל ב־whsec_; זה אינו מפתח API. מאמתים את החתימה על גוף הבקשה המקורי, בודקים את חותמת הזמן ומונעים טיפול כפול לפי מזהה המסירה. אירוע יכול להגיע יותר מפעם אחת, והעדכונים אינם יומן מלא של כל שינוי או הוכחה לפרסום חיצוני.

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

מחבר ה-AI העתידי

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

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

אם משהו לא עובד

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