API de LinkedIn y asistentes de IA (MCP) #

Todo lo que hace en las páginas de LinkedIn también puede realizarse desde un script o un asistente de IA: sus clientes potenciales, la cola de solicitudes de conexión, sus reglas de ICP (incluyendo qué países acepta y qué tan grande debe ser la red de un cliente potencial), su bandeja de entrada, sus agentes de IA y su configuración.

No hay nada nuevo que configurar. Utiliza la misma clave de API que el resto de DM Champ, por lo que si ya llama a nuestra API o tiene un asistente de IA conectado, ya está listo.

Dónde encontrar su clave #

Configuración → Integraciones → Clave de API. Si aún no tiene una, haga clic en Generar clave de API. Los pasos completos se encuentran en Acceso a la API.

No hay una clave de LinkedIn separada para crear, rotar o revocar. La clave actúa como usted, con los mismos permisos que tiene en la aplicación, así que trátela como una contraseña. Revocarla en Configuración corta instantáneamente el acceso a cualquier script o asistente conectado.

Llamar a la API directamente #

• URL base: https://app.sdrpilot.ai/api/v1
• Encabezado: X-API-Key: YOUR_API_KEY
• Descripción legible por máquina: https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (también disponible como .json)

El documento OpenAPI es público y describe cada ruta, por lo que la mayoría de las herramientas de API y generadores de código pueden importarlo directamente sin necesidad de una clave.

Authorization: Bearer YOUR_API_KEY también funciona. Lo que no puede hacer es enviar una clave incorrecta y esperar que pase a otra cosa: una vez que se presenta una clave, la respuesta se basa en esa clave.

Qué sucede cuando algo sale mal:

Conectar un asistente de IA #

Las herramientas de LinkedIn residen en el mismo punto final MCP que las de DM Champ, con la misma clave de API, por lo que un asistente que ya haya conectado las detectará automáticamente. Si aún no ha conectado ninguno, siga Conectar asistentes de IA (MCP) y utilice el punto final que aparece allí.

Las herramientas de LinkedIn tienen el prefijo linkedin_, por lo que son fáciles de identificar en la lista de herramientas de su asistente y fáciles de solicitar por su nombre (“usa las herramientas de LinkedIn para mostrarme lo que está en cola”). No existen permisos por herramienta: una herramienta puede hacer todo lo que usted puede hacer en la aplicación.

Ejemplo 1: solo aceptar leads de ciertos países #

Su perfil de ICP contiene las reglas que los leads deben cumplir. Esto establece una lista de permitidos para los Países Bajos y Bélgica. Los códigos de país son de dos letras, en mayúsculas.

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

Dos cosas a tener en cuenta. El cuerpo es el conjunto completo de reglas, no un parche: una regla que omita se desactivará. Y la respuesta incluye un bloque impact_on_queue que le indica cuántas solicitudes de conexión ya en cola no cumplirían las nuevas reglas, por ejemplo {"examined": 389, "would_withdraw": 155}. Guardar las reglas no retira nada por sí solo.

En un asistente, simplemente diría: “Establece mi ICP para aceptar solo los Países Bajos y Bélgica, y dime qué efecto tendría eso en mi cola”.

Ejemplo 2: ver lo que está en cola #

Solicitudes de conexión que han sido aprobadas pero aún no enviadas:

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

Cada fila contiene el nombre de la persona, el titular, la empresa, la ubicación, el país, su número de conexiones y seguidores, y la puntuación. Puede restringir la lista con country, min_score, max_score y source, y navegar por ella con limit y cursor. Aquí solo aparecen las solicitudes en cola y pendientes de aprobación. Las solicitudes ya enviadas son historial y no se pueden cambiar.

Ejemplo 3: retirar a todos los que están fuera de sus países #

Después de cambiar sus reglas, vuelva a comprobar la cola con ellas. Sin apply=true, esto es una vista previa y no cambia nada:

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

Recibirá información sobre cuántos se examinaron, cuántos serían retirados y un desglose por regla, como country y network_too_small (la red del lead era más pequeña que su mínimo). ¿Está satisfecho? Ejecútelo de nuevo con ?apply=true y esas solicitudes serán retiradas.

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

Si prefiere retirar un conjunto específico, publique los ids en su lugar, o un filtro como {"filter":{"status":"queued","country":"NG"}} para eliminar todo lo que coincida. Envíe ids o un filtro, no ambos.

Solución de problemas #

• 401 en cada llamada — la clave falta o es incorrecta. Cópiela de nuevo desde Ajustes → Integraciones → Clave API.
• 403 aunque la clave funciona en otros lugares — esa cuenta no está vinculada a un espacio de trabajo de LinkedIn, o LinkedIn aún no está habilitado para ella.
• 502 dmchamp_unreachable — un problema temporal al comprobar su clave. No se permitió el paso de nada; inténtelo de nuevo.
• Una regla no coincide con nada — los códigos de país deben tener el formato de dos letras en mayúsculas (NL, no Netherlands o nl), y los códigos de idioma deben estar en minúsculas.
• El asistente no muestra herramientas de LinkedIn — vuelva a conectarlo para que recargue la lista de herramientas y compruebe que está utilizando la misma clave API.

Próximos pasos #

• Conectar asistentes de IA (MCP) — configure Claude, ChatGPT o Cursor con su clave.
• Acceso a la API — genere o rote la clave que utiliza esto.