Dois minutos, e vale fazer antes de qualquer coisa: quase todo problema de integração depois acaba sendo uma das duas coisas que isso prova.
1. Crie uma chave
Criar chave no painel. Você vê a chave inteira uma vez. Ponha num lugar de onde o seu código leia do ambiente e não de um arquivo do repositório.
2. Pergunte o que você tem
curl "https://makehybrid.com/linkedin/connect/accounts" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Uma resposta significa que a chave é válida e o plano está ativo, e a lista que volta é cada conta do LinkedIn que a sua organização conectou. Duas coisas provadas e o único dado de entrada de que toda outra chamada precisa — o id da conta — numa requisição só, que não encosta no LinkedIn.
3. Aprenda o formato dos erros agora
{"type":"errors/payment_required","status":402,"detail":"..."}
- 401 — a chave está faltando, errada ou revogada.
- 402 — o plano não está pago, ou o período de teste acabou.
- 404 — não está lá, ou não é seu. A mesma resposta de propósito.
- 429 — requisições demais, ou o LinkedIn limitando a conta.
- 503 — o salto na frente do LinkedIn não respondeu; o corpo carrega o status cru que ele viu.
Escreva um handler contra esse formato e toda rota do catálogo está coberta. O campo detail é escrito para ser mostrado a uma pessoa, então mostrá-lo costuma ser a coisa certa.
Perguntas frequentes
Posso fazer a primeira chamada por um chat?
Pode. Conecte o seu assistente e pergunte quais contas estão conectadas; ele faz o mesmo tipo de chamada e lê a resposta de volta. Fazer uma vez à mão ainda vale a pena, porque o formato do erro que você vê aqui é o que um agente de IA também vai ler.
Uma sala de projeto precisa desta chave?
Não para abrir uma sala nem para perguntar a um agente de IA integrado. Só um agente seu que age no LinkedIn precisa de uma chave, e a sala cria essa por conta própria.