DM Champ Docs

ממשק ה-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 עובד גם הוא. מה שלא ניתן לעשות הוא לשלוח מפתח שגוי ולקוות שהוא יעבור למשהו אחר: ברגע שהוצג מפתח, התשובה מבוססת על אותו מפתח.

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

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

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

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

נקודת הקצה היא https://mcp.youraiconnector.com/mcp, מאומתת עם הכותרת X-API-Key, בדיוק כפי שמתואר בחיבור עוזרי בינה מלאכותית (MCP).

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

דוגמה 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.

צעדים הבאים