DM Champ Docs

LinkedIn API og AI-assistenter (MCP)

Alt, hvad du gør på LinkedIn-siderne, kan også gøres fra et script eller en AI-assistent: dine leads, køen af forbindelsesanmodninger, dine ICP-regler (inklusive hvilke lande du accepterer, og hvor stort et leads netværk skal være), din indbakke, dine AI-agenter og dine indstillinger.

Der er ikke noget nyt, der skal konfigureres. Den bruger den samme API-nøgle som resten af DM Champ, så hvis du allerede kalder vores API eller har en AI-assistent tilsluttet, er du klar.

Hvor du finder din nøgle

Indstillinger → Integrationer → API-nøgle. Hvis du ikke har en endnu, skal du klikke på Generer API-nøgle. De fulde trin findes i API-adgang.

Der er ingen separat LinkedIn-nøgle, der skal oprettes, roteres eller tilbagekaldes. Nøglen fungerer som dig, med de samme tilladelser, som du har i appen, så behandl den som en adgangskode. Hvis du tilbagekalder den i Indstillinger, afbrydes alle tilsluttede scripts og assistenter øjeblikkeligt.

Kald af API’et direkte

  • Base-URL: https://app.sdrpilot.ai/api/v1
  • Header: X-API-Key: YOUR_API_KEY
  • Maskinlæsbar beskrivelse: https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (også tilgængelig som .json)

OpenAPI-dokumentet er offentligt og beskriver hver rute, så de fleste API-værktøjer og kodegeneratorer kan importere det direkte uden en nøgle.

Authorization: Bearer YOUR_API_KEY fungerer også. Hvad du ikke kan gøre, er at sende en forkert nøgle og håbe på, at den bliver godkendt af noget andet: Når en nøgle er præsenteret, baseres svaret på den nøgle.

Hvad der returneres, når noget er galt:

Svar Hvad det betyder
401 Nøglen mangler, er forkert formateret eller accepteres ikke.
403 Nøglen er gyldig, men den konto har intet LinkedIn-arbejdsområde eller har endnu ikke fået adgang.
429 For mange afviste forsøg på et minut for den nøgle. Sæt farten ned.
502 dmchamp_unreachable Vi kunne ikke tjekke din nøgle lige nu. Det betragtes aldrig som en godkendelse. Prøv igen.

Tilslutning af en AI-assistent

LinkedIn-værktøjerne findes på det samme MCP-endepunkt som DM Champ's, med den samme API-nøgle, så en assistent, du allerede har tilsluttet, finder dem automatisk. Hvis du ikke har tilsluttet en endnu, skal du følge Tilslut AI-assistenter (MCP) og bruge det endepunkt, der er angivet der.

Endepunktet er https://mcp.youraiconnector.com/mcp, godkendt med X-API-Key-headeren, præcis som beskrevet i Tilslut AI-assistenter (MCP).

LinkedIn-værktøjerne har alle præfikset linkedin_, så de er nemme at få øje på i din assistents værktøjsliste og nemme at bede om ved navn (“brug LinkedIn-værktøjerne til at vise mig, hvad der ligger i kø”). Der er ingen tilladelser pr. værktøj: et værktøj kan gøre alt det, du selv kan gøre i appen.

Eksempel 1 — acceptér kun leads fra bestemte lande

Din ICP-profil indeholder de regler, som leads skal overholde. Dette opretter en tilladelsesliste med Holland og Belgien. Landekoder er to bogstaver med store bogstaver.

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

To ting du skal vide. Brødteksten er det komplette regelsæt, ikke en rettelse: en regel, du udelader, bliver slået fra. Og svaret indeholder en impact_on_queue-blok, der fortæller dig, hvor mange allerede køede forbindelsesanmodninger der ikke ville overholde de nye regler, for eksempel {"examined": 389, "would_withdraw": 155}. At gemme regler trækker ikke automatisk noget tilbage.

I en assistent ville du blot sige: “Indstil min ICP til kun at acceptere Holland og Belgien, og fortæl mig, hvad det ville betyde for min kø.”

Eksempel 2 — se hvad der ligger i kø

Forbindelsesanmodninger, der er blevet godkendt, men endnu ikke sendt:

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

Hver række indeholder personens navn, overskrift, virksomhed, lokation, land, antal forbindelser og følgere samt scoren. Du kan indsnævre listen med country, min_score, max_score og source, og bladre igennem den med limit og cursor. Kun køede anmodninger og anmodninger, der afventer godkendelse, vises her. Anmodninger, der allerede er sendt, er historik og kan ikke ændres.

Eksempel 3 — træk alle uden for dine lande tilbage

Når du har ændret dine regler, skal du tjekke køen igen i forhold til dem. Uden apply=true er dette en forhåndsvisning, der ikke ændrer noget:

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

Du får svar på, hvor mange der blev undersøgt, hvor mange der ville blive trukket tilbage, og en opdeling pr. regel, såsom country og network_too_small (leadets netværk var mindre end dit minimum). Er du tilfreds? Kør det igen med ?apply=true, så bliver disse anmodninger trukket tilbage.

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

Hvis du hellere vil trække et specifikt sæt tilbage, skal du i stedet indsende id’erne eller et filter såsom {"filter":{"status":"queued","country":"NG"}} for at tømme alt, der matcher. Send enten id’er eller et filter, ikke begge dele.

Fejlfinding

  • 401 ved hvert kald — nøglen mangler eller er forkert. Kopiér den igen fra Indstillinger → Integrationer → API-nøgle.
  • 403 selvom nøglen virker andre steder — den konto er ikke knyttet til et LinkedIn-arbejdsområde, eller LinkedIn er endnu ikke aktiveret for den.
  • 502 dmchamp_unreachable — en midlertidig fejl ved tjek af din nøgle. Intet blev gennemført; prøv igen.
  • En regel matcher intet — landekoder skal være med to store bogstaver (NL, ikke Netherlands eller nl), og sprogkoder skal være med små bogstaver.
  • Assistenten viser ingen LinkedIn-værktøjer — genopret forbindelsen, så den genindlæser værktøjslisten, og tjek, at du bruger den samme API-nøgle.

Næste skridt