API LinkedIn și asistenți AI (MCP) #

Tot ceea ce faceți pe paginile LinkedIn poate fi realizat și dintr-un script sau un asistent AI: clienții potențiali, coada de cereri de conectare, regulile ICP (inclusiv ce țări acceptați și cât de mare trebuie să fie rețeaua unui client potențial), căsuța de e-mail, agenții AI și setările dumneavoastră.

Nu există nimic nou de configurat. Se folosește aceeași cheie API ca pentru restul DM Champ, deci dacă apelați deja API-ul nostru sau aveți un asistent AI conectat, sunteți gata de utilizare.

Unde puteți găsi cheia #

Setări → Integrări → Cheie API. Dacă nu aveți încă una, faceți clic pe Generare cheie API. Pașii compleți se află în Acces API.

Nu există o cheie LinkedIn separată de creat, rotit sau revocat. Cheia acționează în numele dumneavoastră, cu aceleași permisiuni pe care le aveți în aplicație, așa că tratați-o ca pe o parolă. Revocarea acesteia din Setări întrerupe instantaneu orice script sau asistent conectat.

Apelarea directă a API-ului #

• URL de bază: https://app.sdrpilot.ai/api/v1
• Antet: X-API-Key: YOUR_API_KEY
• Descriere lizibilă de către mașină: https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (disponibilă și ca .json)

Documentul OpenAPI este public și descrie fiecare rută, astfel încât majoritatea instrumentelor API și generatoarelor de cod îl pot importa direct fără o cheie.

Authorization: Bearer YOUR_API_KEY funcționează de asemenea. Ceea ce nu puteți face este să trimiteți o cheie greșită și să sperați că va fi acceptată pentru altceva: odată ce o cheie este prezentată, răspunsul se bazează pe acea cheie.

Ce se întâmplă când ceva nu este în regulă:

Conectarea unui asistent AI #

Instrumentele LinkedIn se află pe același punct final MCP ca și cele ale DM Champ, cu aceeași cheie API, deci un asistent pe care l-ați conectat deja le va prelua automat. Dacă nu ați conectat încă unul, urmați Conectare asistenți AI (MCP) și utilizați punctul final listat acolo.

Instrumentele LinkedIn au toate prefixul linkedin_, deci sunt ușor de identificat în lista de instrumente a asistentului tău și ușor de solicitat pe nume („folosește instrumentele LinkedIn pentru a-mi arăta ce este în coadă”). Nu există permisiuni per instrument: un instrument poate face tot ceea ce poți face și tu în aplicație.

Exemplul 1 — acceptă doar lead-uri din anumite țări #

Profilul tău ICP conține regulile pe care lead-urile trebuie să le îndeplinească. Aceasta stabilește o listă permisă formată din Țările de Jos și Belgia. Codurile de țară sunt formate din două litere, cu majuscule.

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"]}}'

Două lucruri de reținut. Corpul cererii reprezintă setul complet de reguli, nu o actualizare: o regulă pe care o omiți este dezactivată. Iar răspunsul include un bloc impact_on_queue care îți spune câte cereri de conectare deja aflate în coadă nu ar respecta noile reguli, de exemplu {"examined": 389, "would_withdraw": 155}. Salvarea regulilor nu retrage nimic de la sine.

Într-un asistent, ai spune pur și simplu: „Setează-mi ICP-ul să accepte doar Țările de Jos și Belgia și spune-mi ce ar însemna asta pentru coada mea.”

Exemplul 2 — vezi ce este în coadă #

Cereri de conectare care au fost aprobate, dar nu au fost încă trimise:

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

Fiecare rând conține numele persoanei, titlul, compania, locația, țara, numărul de conexiuni și urmăritori, precum și scorul. Poți restrânge lista cu country, min_score, max_score și source și poți naviga prin ea cu limit și cursor. Doar cererile aflate în coadă și cele care așteaptă aprobarea apar aici. Cererile deja trimise sunt istoric și nu pot fi modificate.

Exemplul 3 — retrage pe toată lumea din afara țărilor tale #

După modificarea regulilor, verifică din nou coada în raport cu acestea. Fără apply=true, aceasta este o previzualizare și nu modifică nimic:

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

Primești înapoi numărul de persoane examinate, câte ar fi retrase și o defalcare pe regulă, cum ar fi country și network_too_small (rețeaua lead-ului era mai mică decât minimul tău). Ești mulțumit de rezultat? Rulează din nou cu ?apply=true și acele cereri vor fi retrase.

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

Dacă preferi să retragi un set specific, postează ID-urile în schimb sau un filtru precum {"filter":{"status":"queued","country":"NG"}} pentru a elimina tot ce se potrivește. Trimite ID-uri sau un filtru, nu ambele.

Depanare #

• 401 la fiecare apel — cheia lipsește sau este greșită. Copiaz-o din nou din Setări → Integrări → Cheie API.
• 403 deși cheia funcționează în altă parte — acel cont nu este conectat la un spațiu de lucru LinkedIn sau LinkedIn nu este încă activat pentru acesta.
• 502 dmchamp_unreachable — o problemă temporară la verificarea cheii tale. Nu a fost permis nimic; reîncearcă.
• O regulă nu se potrivește cu nimic — codurile de țară trebuie să fie sub formă de două litere cu majuscule (NL, nu Netherlands sau nl), iar codurile de limbă trebuie să fie cu minuscule.
• Asistentul nu afișează instrumente LinkedIn — reconectează-l pentru a reîncărca lista de instrumente și verifică dacă folosești aceeași cheie API.

Pașii următori #

• Conectare Asistenți AI (MCP) — configurează Claude, ChatGPT sau Cursor cu cheia ta.
• Acces API — generează sau rotește cheia pe care o folosește acesta.