Dos minutos, y merece la pena hacerlo antes que nada: casi todo problema de integración posterior resulta ser una de las dos cosas que esto comprueba.
1. Crea una clave
Crear clave en el panel. Ves la clave entera una vez. Ponla en un sitio del que tu código lea del entorno y no de un archivo del repositorio.
2. Pregunta qué tienes
curl "https://makehybrid.com/linkedin/connect/accounts" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Una respuesta significa que la clave es válida y el plan está activo, y la lista que devuelve es cada cuenta de LinkedIn que tu organización ha conectado. Dos cosas comprobadas y el único dato de entrada que necesita toda otra llamada — el id de cuenta — en una sola petición que no toca LinkedIn para nada.
3. Aprende ya la forma de los errores
{"type":"errors/payment_required","status":402,"detail":"..."}
- 401 — falta la clave, es incorrecta o está revocada.
- 402 — el plan no está pagado, o la prueba ha terminado.
- 404 — no está, o no es tuyo. La misma respuesta a propósito.
- 429 — demasiadas peticiones, o LinkedIn limitando la cuenta.
- 503 — el salto que hay delante de LinkedIn no contestó; el cuerpo lleva el estado desnudo que vio.
Escribe un manejador contra esa forma y cubres todas las rutas del catálogo. El campo detail está escrito para enseñárselo a una persona, así que enseñarlo suele ser lo correcto.
Preguntas frecuentes
¿Puedo hacer la primera llamada desde un chat?
Sí. Conecta tu asistente y pregunta qué cuentas están conectadas; hace el mismo tipo de llamada y te lee la respuesta. Hacerlo una vez a mano sigue valiendo la pena, porque la forma del error que ves aquí es la que también leerá un agente de IA.
¿Una sala de proyecto necesita esta clave?
No para abrir una sala ni para preguntar a un agente de IA integrado. Solo un agente tuyo que actúe en LinkedIn necesita una clave, y la sala crea esa por sí misma.