URL base y autenticación
Todas las solicitudes se envían a:Authorization de cada solicitud:
401.
Crea un token en la app de Gologin: API & MCP > API > New Token, o en la sección API dentro de Connected accounts en el AI Assistant. Para crear un token se necesita un plan de pago y tener activada la autenticación de dos factores en Gologin.
Los envíos son simulaciones por defecto
Las invitaciones, los mensajes, los comentarios y las respuestas se envían solo cuando pasas"send": true. Sin ese parámetro, la solicitud es una simulación (dry run): comprueba el destino y te dice qué pasaría (quién es el destinatario, si es posible enviar una invitación, si ya existe una conversación) y no envía nada. Haz primero la simulación y luego repite la solicitud con "send": true.
La publicación de posts, las reacciones y la aceptación de invitaciones usan sus propios parámetros: publish, react y accept.
Conectar una cuenta
- Obtén el ID de tu workspace:
GET https://api.gologin.com/workspacescon el mismo token devuelve tus workspaces y suid. - Crea la cuenta:
- Para iniciar sesión, pasa una de estas opciones:
credentials(loginypassword),cookiesobrowserProfileId, un perfil de Gologin que ya tiene la sesión iniciada en LinkedIn. - Para la IP, pasa
proxyCountry(los códigos se obtienen conGET /available-countries) o tu propioproxy(host,porty, opcionalmente,protocol,username,password). Un perfil de Gologin vinculado usa su propio proxy. - Para importar las conversaciones existentes, añade
"importHistory": true.
- La cuenta se devuelve como
pendingmientras se realiza la configuración. ConsultaGET /accounts/{id}hasta questatuscambie:
Cada espera dura hasta 10 minutos. Si no se envía un código o no se confirma el inicio de sesión, la cuenta pasa a
auth_failed.
Buscar personas y enviar una invitación
- Busca.
GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growthdevuelveprofile_urlyprofile_idde cada persona. En lugar dequery, puedes pasarurl: un enlace de búsqueda de LinkedIn con sus filtros. - Revisa el perfil.
GET /linkedin/profile?accountId=ACCOUNT_ID&profileUrl=PROFILE_URLmuestrais_connected,is_pendingyis_available_to_connect. - Invita. Haz primero una simulación:
connectable_dry_run significa que la invitación se enviaría. not_connectable indica el motivo: already_connected, invite_pending o connect_unavailable. Repite la solicitud con "send": true. sent_verified significa que LinkedIn creó la invitación.
Enviar un mensaje
POST /linkedin/messages/send recibe accountId, message y uno de estos:
profileUrl: para escribir a una persona. Se busca la conversación con ella o se abre una si no existe; la respuesta indicaexisting_conversationonew_conversation. Si solo se puede llegar a la persona con un InMail de pago, recibesnot_messageableconpaid_inmail_required. Nunca se gasta un InMail de pago sin avisar.conversationId: para continuar una conversación: elconversation_idde/linkedin/inbox, un ID de hilo2-…o una URL de hilo.
sent_verified con message_id y conversation_id.
Leer conversaciones
GET /linkedin/inbox?accountId=ACCOUNT_IDmuestra las conversaciones de la cuenta, de la más reciente a la más antigua.GET /linkedin/messages/conversation?accountId=ACCOUNT_ID&conversationId=CONVERSATION_IDdevuelve los mensajes, del más antiguo al más reciente.limitconserva los más recientes.GET /workspaces/{workspaceId}/conversationsmuestra las conversaciones de todas las cuentas del workspace, yGET /workspaces/{workspaceId}/inbox/unreaddevuelve el recuento de no leídos.
Recibir mensajes nuevos en un webhook
{ accountId, workspaceId, event }. La entrega se reintenta si hay errores y el mismo evento puede llegar dos veces, así que deduplica por event.id. Para eliminar el webhook, envía {"url": null}. No se aceptan localhost ni direcciones internas.
Límites
Las acciones de la API cuentan para los mismos límites que en la app.GET /accounts/{id}/limitsdevuelve la etapa (stage) de la cuenta y todos los límites: el valor recomendado, tu propio valor, el valor aplicado, cuánto se ha usado yresetsAt, el momento en que la ventana tiene espacio para una acción más.PUT /accounts/{id}/limitscambia elstageo tus propios valores encustomLimits. Un valornullelimina tu propio valor.DELETE /accounts/{id}/limits/customrestablece todos los límites a los recomendados.GET /workspaces/{workspaceId}/accounts-usagemuestra cuántas cuentas puede conectar tu workspace y cuántas plazas están ocupadas.
Errores que conviene conocer
Calentar la sesión antes de un lote
Una sesión que no se usa se queda obsoleta, y la primera llamada después tarda varios segundos. Llama aPOST /accounts/{id}/warmup antes de un lote de llamadas o justo después de volver a iniciar sesión. La cuenta debe estar active.