Erros comuns do LinkedIn

LinkedIn tem a API mais finicky entre as três plataformas do MVP. Aqui estão os erros que mais aparecem e como resolver cada um.

403 ACCESS_DENIED no registerUpload

LinkedIn registerUpload: 403
ACCESS_DENIED
Data Processing Exception while processing fields...

Causa: tentativa de publicar Document Post (PDF) ou imagem usando a API legacy /v2/assets?action=registerUpload num app que não tem o produto Marketing Developer Platform ativo.

Solução temporária: o Fala Cheese esconde Document Post do composer quando esse produto não está liberado. Use Texto, Imagem (via upload manual) ou Poll enquanto isso.

Solução permanente: pedir o produto Marketing Developer Platform no LinkedIn Developer App. Aprovação leva 1-4 semanas dependendo do caso de uso descrito.

426 NONEXISTENT_VERSION

LinkedIn poll falhou: 426
"Requested version 20240501 is not active"

Causa: o LinkedIn descontinuou a versão da API versionada que estávamos usando. LinkedIn mantém versões ativas por ~12 meses.

Solução: a gente atualiza o header LinkedIn-Version no driver pra uma versão mais recente. Geralmente sai num deploy em horas.

Se você está vendo esse erro num app self-hosted (não em app.falacheese.com.br), confira o valor de LINKEDIN-Version em lib/platforms/linkedin.ts.

redirect_uri does not match

The redirect_uri does not match the registered value

Causa: o URL configurado no Fala Cheese pra callback do OAuth não bate com o cadastrado no LinkedIn Developer App.

Solução: em linkedin.com/developers/apps → seu app → Auth tab → lista de "Authorized redirect URLs", adicione:

http://localhost:3000/api/oauth/linkedin/callback
https://app.falacheese.com.br/api/oauth/linkedin/callback

(localhost se você roda local, domínio prod se em produção)

LINKEDIN_CLIENT_ID não configurado

Causa: a variável de ambiente está vazia ou o dev server foi iniciado antes do .env.local ser preenchido.

Solução:

1. Confere que LINKEDIN_CLIENT_ID e LINKEDIN_CLIENT_SECRET estão preenchidos em .env.local
2. Reinicia o dev server (Ctrl+C + npm run dev) — Next.js só lê env no boot

Poll publicou só o texto, sem a enquete

Causa: bug no publisher onde o campo poll não estava sendo passado do Post.metadata pro driver. Foi corrigido em maio/2026.

Solução: garanta que você está rodando versão >= maio/2026 do app. Se você forka, confere lib/publisher.ts — ele precisa extrair poll do post.metadata e passar pro driver.publish().

Inbox de LinkedIn retorna vazio

Causa: Inbox precisa do escopo r_member_social, que vem com o produto Community Management API.

Limitação: Community Management API só pode ser único produto no app por motivo legal. Se seu app já tem Sign In + Share, não dá pra adicionar.

Solução: criar um segundo Developer App dedicado pro Community Management. Levaria 2 sets de credenciais e lógica de fallback no driver — pós-MVP.

Token expirado

LinkedIn access tokens duram 60 dias por padrão. Quando expirar, o Fala Cheese marca a conta como inactive e avisa por email.

Solução: vai em /app/settings/connections, clica em Reconectar na conta. Refaz o OAuth com 2 cliques, e tokens novos ficam válidos por mais 60 dias.

Onde pedir ajuda

Se nada acima resolveu, manda email pra contato@falacheese.com.br com:

• Texto exato do erro
• Print da tela (se UI)
• O que você estava tentando fazer

Respondemos em 24h úteis.