DM Champ Docs

API LinkedIn i asystenci AI (MCP)

Wszystko, co robisz na stronach LinkedIn, można również wykonać za pomocą skryptu lub asystenta AI: Twoje leady, kolejka zaproszeń do sieci kontaktów, reguły ICP (w tym kraje, które akceptujesz, oraz wymagana wielkość sieci leada), skrzynka odbiorcza, Twoi agenci AI oraz ustawienia.

Nie trzeba niczego konfigurować. Używa to tego samego klucza API, co reszta DM Champ, więc jeśli już korzystasz z naszego API lub masz podłączonego asystenta AI, wszystko jest gotowe.

Gdzie znaleźć swój klucz

Ustawienia → Integracje → Klucz API. Jeśli jeszcze go nie masz, kliknij Wygeneruj klucz API. Pełna instrukcja znajduje się w Dostęp do API.

Nie ma osobnego klucza LinkedIn do tworzenia, rotacji czy unieważniania. Klucz działa w Twoim imieniu, z takimi samymi uprawnieniami, jakie masz w aplikacji, więc traktuj go jak hasło. Unieważnienie go w Ustawieniach natychmiast odcina dostęp dla wszystkich podłączonych skryptów i asystentów.

Bezpośrednie wywoływanie API

  • Podstawowy adres URL: https://app.sdrpilot.ai/api/v1
  • Nagłówek: X-API-Key: YOUR_API_KEY
  • Opis czytelny dla maszyny: https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (dostępny również jako .json)

Dokument OpenAPI jest publiczny i opisuje każdą ścieżkę, więc większość narzędzi API i generatorów kodu może go zaimportować bezpośrednio bez użycia klucza.

Authorization: Bearer YOUR_API_KEY również działa. Nie można jednak wysłać błędnego klucza w nadziei, że system przepuści żądanie dalej: gdy klucz zostanie przedstawiony, odpowiedź jest generowana na jego podstawie.

Co otrzymasz w przypadku błędu:

Odpowiedź Co to oznacza
401 Klucz jest brakujący, błędny lub nieakceptowany.
403 Klucz jest poprawny, ale to konto nie posiada obszaru roboczego LinkedIn lub nie ma jeszcze do niego dostępu.
429 Zbyt wiele odrzuconych prób w ciągu minuty dla tego klucza. Zwolnij.
502 dmchamp_unreachable Nie udało nam się sprawdzić Twojego klucza w tej chwili. Nigdy nie jest to traktowane jako autoryzacja. Spróbuj ponownie.

Podłączanie asystenta AI

Narzędzia LinkedIn znajdują się w tym samym punkcie końcowym MCP co DM Champ, z tym samym kluczem API, więc asystent, którego już podłączyłeś, wykryje je automatycznie. Jeśli jeszcze go nie podłączyłeś, postępuj zgodnie z instrukcją Podłączanie asystentów AI (MCP) i użyj wymienionego tam punktu końcowego.

Punkt końcowy to https://mcp.youraiconnector.com/mcp, uwierzytelniany za pomocą nagłówka X-API-Key, dokładnie tak, jak opisano w sekcji Podłączanie asystentów AI (MCP).

Narzędzia LinkedIn mają prefiks linkedin_, dzięki czemu łatwo je zidentyfikować na liście narzędzi asystenta i łatwo o nie poprosić po nazwie („użyj narzędzi LinkedIn, aby pokazać mi, co jest w kolejce”). Nie ma uprawnień dla poszczególnych narzędzi: narzędzie może zrobić wszystko to, co Ty w aplikacji.

Przykład 1 — akceptuj leady tylko z określonych krajów

Twój profil ICP zawiera zasady, które muszą spełniać leady. Ustawia to listę dozwolonych krajów: Holandię i Belgię. Kody krajów są dwuliterowe, pisane wielkimi literami.

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

Warto wiedzieć o dwóch rzeczach. Treść to kompletny zestaw zasad, a nie poprawka: pominięta zasada zostaje wyłączona. Odpowiedź zawiera blok impact_on_queue informujący, ile już zakolejkowanych próśb o nawiązanie kontaktu nie spełniłoby nowych zasad, na przykład {"examined": 389, "would_withdraw": 155}. Zapisanie zasad samo w sobie niczego nie wycofuje.

W asystencie wystarczy powiedzieć: „Ustaw mój profil ICP tak, aby akceptował tylko Holandię i Belgię, i powiedz mi, jak wpłynie to na moją kolejkę”.

Przykład 2 — sprawdź, co jest w kolejce

Prośby o nawiązanie kontaktu, które zostały zatwierdzone, ale jeszcze nie wysłane:

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

Każdy wiersz zawiera imię i nazwisko osoby, nagłówek, firmę, lokalizację, kraj, liczbę kontaktów i obserwujących oraz wynik. Możesz zawęzić listę za pomocą country, min_score, max_score i source, a także przeglądać ją strona po stronie za pomocą limit i cursor. Tutaj pojawiają się tylko prośby zakolejkowane i oczekujące na zatwierdzenie. Prośby już wysłane są historią i nie można ich zmienić.

Przykład 3 — wycofaj wszystkich spoza Twoich krajów

Po zmianie zasad ponownie sprawdź kolejkę pod ich kątem. Bez apply=true jest to podgląd, który niczego nie zmienia:

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

Otrzymasz informację, ile osób sprawdzono, ile zostałoby wycofanych oraz zestawienie według zasad, takie jak country i network_too_small (sieć leada była mniejsza niż Twoje minimum). Jesteś zadowolony z wyniku? Uruchom to ponownie z ?apply=true, a te prośby zostaną wycofane.

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

Jeśli wolisz wycofać konkretny zestaw, prześlij identyfikatory lub filtr, taki jak {"filter":{"status":"queued","country":"NG"}}, aby usunąć wszystko, co pasuje. Wyślij identyfikatory lub filtr, nie oba naraz.

Rozwiązywanie problemów

  • 401 przy każdym wywołaniu — klucz jest brakujący lub błędny. Skopiuj go ponownie z Ustawienia → Integracje → Klucz API.
  • 403 mimo że klucz działa gdzie indziej — to konto nie jest powiązane z obszarem roboczym LinkedIn lub LinkedIn nie został dla niego jeszcze włączony.
  • 502 dmchamp_unreachable — chwilowy problem przy sprawdzaniu klucza. Nic nie zostało przepuszczone; spróbuj ponownie.
  • Zasada do niczego nie pasuje — kody krajów muszą być w formie dwuliterowej wielkimi literami (NL, a nie Netherlands lub nl), a kody języków muszą być pisane małymi literami.
  • Asystent nie pokazuje narzędzi LinkedIn — połącz go ponownie, aby odświeżyć listę narzędzi, i sprawdź, czy używasz tego samego klucza API.

Następne kroki