ממשק ה-API של LinkedIn ועוזרי בינה מלאכותית (MCP) #

כל פעולה שניתן לבצע בדפי LinkedIn ניתנת לביצוע גם מתוך סקריפט או עוזר בינה מלאכותית: הלידים שלך, תור בקשות ההתקשרות, חוקי ה-ICP שלך (כולל אילו מדינות אתה מקבל ומה גודל הרשת הנדרש מליד), תיבת הדואר הנכנס שלך, סוכני ה-AI שלך וההגדרות שלך.

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

היכן למצוא את המפתח שלך #

הגדרות (Settings) ← אינטגרציות (Integrations) ← מפתח API. אם עדיין אין לך מפתח, לחץ על הפק מפתח API (Generate API key). הצעדים המלאים נמצאים ב-גישת API.

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

קריאה ישירה ל-API #

• כתובת בסיס (Base URL): https://app.sdrpilot.ai/api/v1
• כותרת (Header): X-API-Key: YOUR_API_KEY
• תיאור קריא למכונה: https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (זמין גם כ-.json)

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

Authorization: Bearer YOUR_API_KEY עובד גם הוא. מה שלא ניתן לעשות הוא לשלוח מפתח שגוי ולקוות שהוא יעבור למשהו אחר: ברגע שהוצג מפתח, התשובה מבוססת על אותו מפתח.

מה חוזר כאשר משהו אינו תקין:

חיבור עוזר בינה מלאכותית #

כלי ה-LinkedIn נמצאים באותה נקודת קצה (endpoint) של MCP כמו של DM Champ, עם אותו מפתח API, כך שעוזר שכבר חיברת יזהה אותם באופן אוטומטי. אם טרם חיברת עוזר, עקוב אחר חיבור עוזרי בינה מלאכותית (MCP) והשתמש בנקודת הקצה המפורטת שם.

לכל כלי ה-LinkedIn יש תחילית linkedin_, כך שקל לזהות אותם ברשימת הכלים של העוזר שלך וקל לבקש אותם בשמם (“השתמש בכלי ה-LinkedIn כדי להראות לי מה נמצא בתור”). אין הרשאות לכל כלי בנפרד: כלי יכול לבצע כל מה שאתה יכול לבצע באפליקציה.

סביבות עבודה של לקוחות ומיתוג לבן (White label) #

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

• מפתחות לכל סביבת עבודה. הלקוח יוצר את המפתחות שלו בהגדרות של סביבת העבודה. מפתח ניגש רק לנתונים של אותה סביבת עבודה; הדפים של הסוכנות עצמה (לקוחות, מיתוג, חיובים) יחזירו “לא נמצא” (not found) עבורו.
• הכתובות נמצאות בכרטיס ההגדרות של סביבת העבודה. בדומיין ממותג, הכרטיס מציג את כתובת ה-API באותו דומיין (https://<your brand domain>/api/v1), את כתובת ה-MCP להדבקה בתוך עוזר בינה מלאכותית, וקישור למסמכי העזרה, הכל תחת המותג של הסוכנות.
• מתג הגישה ל-API של הסוכנות. סוכנות שמפעילה את שירותי הפנייה בלינקדאין שלה כמותג עצמאי, מחזיקה מתג גישת API לכל לקוח בדף הלקוחות שלה, המופעל כברירת מחדל. כאשר הוא כבוי, המפתחות של הלקוח נדחים תוך דקה וכרטיס ה-API נעלם מההגדרות שלו. הפעלה מחדש של המתג משחזרת את אותם מפתחות. המפתחות של לקוח מושהה נדחים גם הם.

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

דוגמה 1 — קבלת לידים ממדינות מסוימות בלבד #

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

curl -X PUT https://app.sdrpilot.ai/api/v1/icp/YOUR_ICP_ID/filters \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countries":{"mode":"allow","codes":["NL","BE"]}}'

שני דברים שחשוב לדעת. הגוף הוא קבוצת הכללים המלאה, לא תיקון: כלל שתשמיט יכובה. והתשובה כוללת בלוק impact_on_queue המציין כמה בקשות חיבור שכבר נמצאות בתור ייכשלו לפי הכללים החדשים, לדוגמה {"examined": 389, "would_withdraw": 155}. לאחר השמירה, הכללים החדשים מוחלים על התור באופן אוטומטי: בקשות ממתינות שנכשלות בהם מוסרות.

בעוזר אישי, פשוט תגיד: “הגדר את ה-ICP שלי כך שיקבל רק את הולנד ובלגיה, ותגיד לי מה זה יעשה לתור שלי.”

דוגמה 2 — לראות מה נמצא בתור #

בקשות התחברות שאושרו אך טרם נשלחו:

curl -s "https://app.sdrpilot.ai/api/v1/connections/queue?status=queued&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"

כל שורה מכילה את שם האדם, הכותרת, החברה, המיקום, המדינה, מספר החיבורים והעוקבים שלהם, והציון. ניתן לצמצם את הרשימה באמצעות country, min_score, max_score ו-source, ולדפדף בה באמצעות limit ו-cursor. רק בקשות בתור ובמצב המתנה לאישור מופיעות כאן. בקשות שכבר נשלחו הן היסטוריה ולא ניתן לשנותן.

דוגמה 3 — ביטול בקשות של כל מי שנמצא מחוץ למדינות שלך #

לאחר שינוי הכללים, בדוק שוב את התור מולם. ללא apply=true זוהי תצוגה מקדימה בלבד ושום דבר לא משתנה:

curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen" \
  -H "X-API-Key: YOUR_API_KEY"

אתה מקבל בחזרה כמה נבדקו, כמה יבוטלו, ופירוט לפי כלל, כגון country ו-network_too_small (הרשת של הליד הייתה קטנה מהמינימום שלך). מרוצה מהתוצאה? הרץ זאת שוב עם ?apply=true והבקשות הללו יבוטלו.

curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen?apply=true" \
  -H "X-API-Key: YOUR_API_KEY"

אם אתה מעדיף לבטל קבוצה ספציפית, שלח את המזהים (ids) במקום, או מסנן כגון {"filter":{"status":"queued","country":"NG"}} כדי לרוקן את כל מה שתואם. שלח מזהים או מסנן, לא את שניהם.

פתרון בעיות #

• 401 בכל קריאה — המפתח חסר או שגוי. העתק אותו שוב מתוך Settings → Integrations → API Key.
• 403 למרות שהמפתח עובד במקומות אחרים — החשבון אינו מקושר לסביבת עבודה (workspace) של LinkedIn, או ש-LinkedIn עדיין לא מופעל עבורו.
• 502 dmchamp_unreachable — תקלה זמנית בבדיקת המפתח שלך. שום דבר לא עבר; נסה שוב.
• כלל לא תואם דבר — קודי מדינות חייבים להיות בצורת שתי אותיות באותיות גדולות (NL, לא Netherlands או nl), וקודי שפה חייבים להיות באותיות קטנות.
• העוזר לא מציג כלי LinkedIn — חבר אותו מחדש כדי שיטען מחדש את רשימת הכלים, וודא שאתה משתמש באותו מפתח API.

צעדים הבאים #

• חיבור עוזרי AI (MCP) — הגדר את Claude או Cursor בעזרת המפתח שלך.
• גישת API — צור או החלף את המפתח שבו נעשה שימוש כאן.