URL base e autenticação
Todas as requisições vão para:Authorization de cada requisição:
401.
Crie um token no app do Gologin: API & MCP > API > Novo Token, ou na seção API em Contas conectadas no Assistente de IA. Um token pode ser criado em um plano pago com a autenticação em duas etapas ativada no Gologin.
Os envios são simulações por padrão
Convites, mensagens, comentários e respostas só são enviados quando você passa"send": true. Sem isso, a requisição é uma simulação (dry run): ela verifica o destino e informa o que aconteceria - quem é o destinatário, se é possível enviar um convite, se já existe uma conversa - e não envia nada. Faça primeiro a simulação e depois repita a requisição com "send": true.
A publicação de posts, as reações e a aceitação de convites usam suas próprias flags: publish, react e accept.
Conectar uma conta
- Obtenha o ID do seu workspace:
GET https://api.gologin.com/workspacescom o mesmo token retorna seus workspaces e oidde cada um. - Crie a conta:
- Para fazer login, passe um destes:
credentials(loginepassword),cookiesoubrowserProfileId- um perfil do Gologin que já está conectado ao LinkedIn. - Para o IP, passe
proxyCountry(os códigos vêm deGET /available-countries) ou seu próprioproxy(host,porte, opcionalmente,protocol,username,password). Um perfil do Gologin vinculado usa o próprio proxy. - Para importar conversas existentes, adicione
"importHistory": true.
- A conta retorna como
pendingenquanto a configuração é executada. ConsulteGET /accounts/{id}até que ostatusmude:
Cada espera dura até 10 minutos. Um código não enviado ou um login não confirmado termina então em
auth_failed.
Encontrar pessoas e enviar um convite
- Busque.
GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growthretornaprofile_urleprofile_idde cada pessoa. Em vez dequery, você pode passarurl- um link de busca do LinkedIn com seus filtros. - Verifique o perfil.
GET /linkedin/profile?accountId=ACCOUNT_ID&profileUrl=PROFILE_URLmostrais_connected,is_pendingeis_available_to_connect. - Convide. Faça primeiro uma simulação:
connectable_dry_run significa que o convite seria enviado. not_connectable informa o motivo: already_connected, invite_pending ou connect_unavailable. Repita a requisição com "send": true. sent_verified significa que o LinkedIn criou o convite.
Enviar uma mensagem
POST /linkedin/messages/send recebe accountId, message e um destes:
profileUrl- para escrever a uma pessoa. A conversa com ela é localizada ou, se não existir, aberta; a resposta trazexisting_conversationounew_conversation. Se apenas um InMail pago puder alcançar a pessoa, você recebenot_messageablecompaid_inmail_required. Um InMail pago nunca é gasto silenciosamente.conversationId- para continuar uma conversa: oconversation_idde/linkedin/inbox, um ID de thread2-…ou uma URL de thread.
sent_verified com message_id e conversation_id.
Ler conversas
GET /linkedin/inbox?accountId=ACCOUNT_IDlista as conversas da conta, da mais recente para a mais antiga.GET /linkedin/messages/conversation?accountId=ACCOUNT_ID&conversationId=CONVERSATION_IDretorna as mensagens, da mais antiga para a mais recente.limitmantém apenas as mais recentes.GET /workspaces/{workspaceId}/conversationslista as conversas de todas as contas do workspace, eGET /workspaces/{workspaceId}/inbox/unreadretorna as contagens de não lidas.
Receber novas mensagens em um webhook
{ accountId, workspaceId, event }. A entrega é repetida em caso de erro e o mesmo evento pode chegar duas vezes, por isso remova duplicatas usando event.id. Para remover o webhook, envie {"url": null}. Localhost e endereços internos não são aceitos.
Limites
As ações da API contam para os mesmos limites do app.GET /accounts/{id}/limitsretorna o estágio da conta e todos os limites: o valor recomendado, o seu próprio valor, o valor aplicado, quanto já foi usado eresetsAt- quando a janela terá espaço para mais uma ação.PUT /accounts/{id}/limitsaltera ostageou os seus próprios valores emcustomLimits. Um valornullremove o seu próprio valor.DELETE /accounts/{id}/limits/customredefine todos os limites para os recomendados.GET /workspaces/{workspaceId}/accounts-usagemostra quantas contas o seu workspace pode conectar e quantas vagas estão ocupadas.
Erros que vale conhecer
Aquecer a sessão antes de um lote
Uma sessão que fica sem uso expira, e a primeira chamada depois disso leva alguns segundos. ChamePOST /accounts/{id}/warmup antes de um lote de chamadas ou logo depois de fazer login novamente. A conta precisa estar active.