API LinkedIn dan Asisten AI (MCP) #

Segala hal yang Anda lakukan di halaman LinkedIn juga dapat dilakukan dari skrip atau asisten AI: prospek Anda, antrean permintaan koneksi, aturan ICP Anda (termasuk negara mana yang Anda terima dan seberapa besar jaringan prospek yang harus dimiliki), kotak masuk Anda, agen AI Anda, dan pengaturan Anda.

Tidak ada yang perlu disiapkan lagi. Ini menggunakan kunci API yang sama dengan DM Champ lainnya, jadi jika Anda sudah memanggil API kami atau memiliki asisten AI yang terhubung, Anda sudah siap.

Di mana menemukan kunci Anda #

Pengaturan → Integrasi → Kunci API. Jika Anda belum memilikinya, klik Hasilkan kunci API. Langkah-langkah lengkapnya ada di Akses API.

Tidak ada kunci LinkedIn terpisah untuk dibuat, dirotasi, atau dicabut. Kunci tersebut bertindak sebagai Anda, dengan izin yang sama seperti yang Anda miliki di aplikasi, jadi perlakukan kunci tersebut seperti kata sandi. Mencabutnya di Pengaturan akan langsung memutus semua skrip dan asisten yang terhubung.

Memanggil API secara langsung #

• URL Dasar: https://app.sdrpilot.ai/api/v1
• Header: X-API-Key: YOUR_API_KEY
• Deskripsi yang dapat dibaca mesin: https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (juga tersedia sebagai .json)

Dokumen OpenAPI bersifat publik dan menjelaskan setiap rute, sehingga sebagian besar alat API dan pembuat kode dapat mengimpornya secara langsung tanpa kunci.

Authorization: Bearer YOUR_API_KEY juga berfungsi. Yang tidak dapat Anda lakukan adalah mengirim kunci yang salah dan berharap kunci tersebut akan dialihkan ke hal lain: setelah kunci disajikan, jawaban akan didasarkan pada kunci tersebut.

Apa yang dikembalikan jika ada yang salah:

Menghubungkan asisten AI #

Alat LinkedIn berada di titik akhir MCP yang sama dengan DM Champ, dengan kunci API yang sama, sehingga asisten yang sudah Anda hubungkan akan mengambilnya secara otomatis. Jika Anda belum menghubungkannya, ikuti Hubungkan Asisten AI (MCP) dan gunakan titik akhir yang tercantum di sana.

Alat LinkedIn semuanya diawali dengan linkedin_, sehingga mudah ditemukan di daftar alat asisten Anda dan mudah diminta berdasarkan nama (“gunakan alat LinkedIn untuk menunjukkan kepada saya apa yang ada dalam antrean”). Tidak ada izin per alat: sebuah alat dapat melakukan apa pun yang dapat Anda lakukan di aplikasi.

Contoh 1 — hanya menerima prospek dari negara tertentu #

Profil ICP Anda menyimpan aturan yang harus dipenuhi oleh prospek. Ini menetapkan daftar izin untuk Belanda dan Belgia. Kode negara terdiri dari dua huruf, huruf besar.

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

Dua hal yang perlu diketahui. Isi badan adalah kumpulan aturan lengkap, bukan tambalan: aturan yang Anda hilangkan akan dimatikan. Dan jawabannya mencakup blok impact_on_queue yang memberi tahu Anda berapa banyak permintaan koneksi yang sudah dalam antrean yang akan gagal memenuhi aturan baru, misalnya {"examined": 389, "would_withdraw": 155}. Menyimpan aturan tidak akan menarik apa pun dengan sendirinya.

Dalam asisten, Anda cukup mengatakan: “Atur ICP saya agar hanya menerima Belanda dan Belgia, dan beri tahu saya apa dampaknya terhadap antrean saya.”

Contoh 2 — melihat apa yang ada dalam antrean #

Permintaan koneksi yang telah disetujui tetapi belum dikirim:

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

Setiap baris memuat nama orang, tajuk utama, perusahaan, lokasi, negara, jumlah koneksi dan pengikut mereka, serta skor. Anda dapat mempersempit daftar dengan country, min_score, max_score, dan source, serta menelusuri halamannya dengan limit dan cursor. Hanya permintaan yang mengantre dan menunggu persetujuan yang muncul di sini. Permintaan yang sudah dikirim adalah riwayat dan tidak dapat diubah.

Contoh 3 — menarik semua orang di luar negara Anda #

Setelah mengubah aturan Anda, periksa kembali antrean terhadap aturan tersebut. Tanpa apply=true, ini adalah pratinjau dan tidak mengubah apa pun:

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

Anda akan mendapatkan informasi tentang berapa banyak yang diperiksa, berapa banyak yang akan ditarik, dan rincian per aturan, seperti country dan network_too_small (jaringan prospek lebih kecil dari minimum Anda). Puas dengan hasilnya? Jalankan lagi dengan ?apply=true dan permintaan tersebut akan ditarik.

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

Jika Anda lebih suka menarik kumpulan tertentu, kirimkan id-nya sebagai gantinya, atau filter seperti {"filter":{"status":"queued","country":"NG"}} untuk mengosongkan semua yang cocok. Kirim id atau filter, jangan keduanya.

Pemecahan Masalah #

• 401 pada setiap panggilan — kunci hilang atau salah. Salin lagi dari Pengaturan → Integrasi → Kunci API.
• 403 meskipun kunci berfungsi di tempat lain — akun tersebut tidak ditautkan ke ruang kerja LinkedIn, atau LinkedIn belum diaktifkan untuk akun tersebut.
• 502 dmchamp_unreachable — gangguan sementara saat memeriksa kunci Anda. Tidak ada yang diteruskan; coba lagi.
• Aturan tidak cocok dengan apa pun — kode negara harus dalam bentuk dua huruf besar (NL, bukan Netherlands atau nl), dan kode bahasa harus dalam huruf kecil.
• Asisten tidak menampilkan alat LinkedIn — sambungkan kembali agar daftar alat dimuat ulang, dan periksa apakah Anda menggunakan kunci API yang sama.

Langkah Selanjutnya #

• Hubungkan Asisten AI (MCP) — siapkan Claude, ChatGPT, atau Cursor dengan kunci Anda.
• Akses API — buat atau rotasi kunci yang digunakan ini.