DM Champ Docs

LinkedIn-rajapinta ja tekoälyavustajat (MCP)

Kaikki, mitä teet LinkedIn-sivuilla, voidaan tehdä myös skriptin tai tekoälyavustajan kautta: liidit, yhteyspyyntöjono, ICP-säännöt (mukaan lukien hyväksytyt maat ja liidin verkoston vähimmäiskoko), postilaatikko, tekoälyagentit ja asetukset.

Mitään uutta ei tarvitse määrittää. Se käyttää samaa API-avainta kuin muu DM Champ, joten jos käytät jo rajapintaamme tai sinulla on yhdistetty tekoälyavustaja, olet valmis.

Mistä löydät avaimesi

Asetukset → Integraatiot → API-avain. Jos sinulla ei vielä ole avainta, napsauta Luo API-avain. Täydelliset ohjeet löytyvät kohdasta API-käyttöoikeus.

Erillistä LinkedIn-avainta ei tarvitse luoda, vaihtaa tai mitätöidä. Avain toimii sinuna samoilla käyttöoikeuksilla, jotka sinulla on sovelluksessa, joten käsittele sitä kuin salasanaa. Sen mitätöinti asetuksista katkaisee välittömästi yhteyden kaikkiin skripteihin ja avustajiin.

Rajapinnan kutsuminen suoraan

  • Perus-URL: https://app.sdrpilot.ai/api/v1
  • Otsake: X-API-Key: YOUR_API_KEY
  • Koneellisesti luettava kuvaus: https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (saatavilla myös muodossa .json)

OpenAPI-dokumentti on julkinen ja kuvaa jokaisen reitin, joten useimmat rajapintatyökalut ja koodigeneraattorit voivat tuoda sen suoraan ilman avainta.

Authorization: Bearer YOUR_API_KEY toimii myös. Et voi lähettää väärää avainta ja toivoa, että se ohjautuisi muualle: kun avain on esitetty, vastaus perustuu kyseiseen avaimeen.

Mitä tapahtuu, kun jokin menee vikaan:

Vastaus Mitä se tarkoittaa
401 Avain puuttuu, on virheellinen tai sitä ei hyväksytä.
403 Avain on voimassa, mutta tilillä ei ole LinkedIn-työtilaa tai pääsy ei ole vielä sallittu.
429 Liian monta hylättyä yritystä minuutissa kyseisellä avaimella. Hidasta tahtia.
502 dmchamp_unreachable Emme voineet tarkistaa avaintasi juuri nyt. Sitä ei koskaan pidetä hyväksyttynä. Yritä uudelleen.

Tekoälyavustajan yhdistäminen

LinkedIn-työkalut sijaitsevat samassa MCP-päätepisteessä kuin DM Champ:n, samalla API-avaimella, joten jo yhdistämäsi avustaja tunnistaa ne automaattisesti. Jos et ole vielä yhdistänyt avustajaa, seuraa ohjeita kohdassa Yhdistä tekoälyavustajat (MCP) ja käytä siellä lueteltua päätepistettä.

Päätepiste on https://mcp.youraiconnector.com/mcp, ja se todennetaan X-API-Key-otsakkeella, täsmälleen kuten kohdassa Yhdistä tekoälyavustajat (MCP) on kuvattu.

LinkedIn-työkalujen etuliitteenä on aina linkedin_, joten ne on helppo tunnistaa avustajasi työkaluluettelosta ja pyytää nimellä (“käytä LinkedIn-työkaluja näyttääksesi jonossa olevat kohteet”). Työkalukohtaisia käyttöoikeuksia ei ole: työkalu voi tehdä mitä tahansa, mitä sinäkin voit tehdä sovelluksessa.

Esimerkki 1 — hyväksy liidit vain tietyistä maista

ICP-profiilisi sisältää säännöt, jotka liidien on läpäistävä. Tämä asettaa sallittujen maiden listaksi Alankomaat ja Belgian. Maakoodit ovat kaksikirjaimisia ja isoilla kirjaimilla kirjoitettuja.

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

Huomioi kaksi asiaa. Runko on täydellinen joukko sääntöjä, ei päivitys: pois jätetty sääntö kytkeytyy pois päältä. Vastaus sisältää impact_on_queue-lohkon, joka kertoo, kuinka moni jo jonossa oleva yhteyspyyntö ei läpäisisi uusia sääntöjä, esimerkiksi {"examined": 389, "would_withdraw": 155}. Sääntöjen tallentaminen ei itsessään peruuta mitään.

Avustajalle voit yksinkertaisesti sanoa: “Aseta ICP-profiilini hyväksymään vain Alankomaat ja Belgia, ja kerro, mitä se tarkoittaisi jonolleni.”

Esimerkki 2 — katso, mitä jonossa on

Yhteyspyynnöt, jotka on hyväksytty, mutta joita ei ole vielä lähetetty:

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

Jokaisella rivillä on henkilön nimi, otsikko, yritys, sijainti, maa, yhteyshenkilöiden ja seuraajien määrä sekä pistemäärä. Voit rajata luetteloa käyttämällä country, min_score, max_score ja source, ja selata sitä limit ja cursor avulla. Vain jonossa olevat ja hyväksyntää odottavat pyynnöt näkyvät tässä. Jo lähetetyt pyynnöt ovat historiaa, eikä niitä voi muuttaa.

Esimerkki 3 — peruuta kaikkien niiden pyynnöt, jotka ovat maittesi ulkopuolella

Kun olet muuttanut sääntöjäsi, tarkista jono niitä vasten uudelleen. Ilman apply=true-parametria tämä on esikatselu, joka ei muuta mitään:

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

Saat vastauksena tiedon siitä, kuinka monta kohdetta tarkistettiin, kuinka monta peruttaisiin, sekä erittelyn säännöittäin, kuten country ja network_too_small (liidin verkosto oli pienempi kuin asettamasi vähimmäismäärä). Oletko tyytyväinen tulokseen? Suorita toiminto uudelleen ?apply=true-parametrilla, niin kyseiset pyynnöt peruutetaan.

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

Jos haluat mieluummin peruuttaa tietyn joukon, lähetä sen sijaan tunnisteet (ids) tai suodatin, kuten {"filter":{"status":"queued","country":"NG"}}, poistaaksesi kaiken, mikä täsmää. Lähetä joko tunnisteet tai suodatin, ei molempia.

Vianmääritys

  • 401 jokaisessa kutsussa — avain puuttuu tai on väärä. Kopioi se uudelleen kohdasta Asetukset → Integraatiot → API-avain.
  • 403, vaikka avain toimii muualla — kyseistä tiliä ei ole linkitetty LinkedIn-työtilaan tai LinkedIniä ei ole vielä otettu käyttöön kyseiselle tilille.
  • 502 dmchamp_unreachable — tilapäinen häiriö avaimen tarkistuksessa. Mitään ei päästetty läpi; yritä uudelleen.
  • Sääntö ei täsmää mihinkään — maakoodien on oltava kaksikirjaimisia ja isoilla kirjaimilla (NL, ei Netherlands tai nl), ja kielikoodien on oltava pienillä kirjaimilla.
  • Avustaja ei näytä LinkedIn-työkaluja — yhdistä se uudelleen, jotta työkaluluettelo latautuu uudelleen, ja tarkista, että käytät samaa API-avainta.

Seuraavat vaiheet