최근 개인 블로그 글을 여러 소셜 미디어에 자동으로 전송하는 시스템을 구축하고 있다. 얼마 전 메타의 스레드 API를 연동하여 자동 발행에 성공한 데 이어, 이번에는 비즈니스 중심 SNS의 대표 주자인 링크드인 자동 발행을 목표로 연동 작업을 시작했다.
스레드 연동 경험이 있으니 당연히 비슷할 것이라 가볍게 생각했다. 하지만 첫 단계부터 링크드인 개발자 포털은 나에게 전혀 다른 형태의 삽질을 선사하며 당혹감을 안겨주었다. 직접 부딪치고 삽질하며 해결한 링크드인 API 연동 과정을 꼼꼼하게 기록해 보려고 한다.
앱 생성부터 막히는 난관, 회사 페이지 필수 연결
가장 먼저 부딪힌 문제는 개발자 포털에서 앱을 생성하는 단계였다. 스레드의 경우 개인 계정 기반으로도 비교적 쉽게 앱이 만들어졌지만, 링크드인은 API 사용을 위한 앱을 생성할 때 반드시 실제 운영 중인 회사 페이지(LinkedIn Page)를 연결하도록 강제하고 있었다.
나는 개인 프로젝트의 자동화를 진행하는 것이라 따로 운영하는 회사 페이지가 전혀 없었다. 결국 앱을 만들기 위해 'JinsLab'이라는 새로운 회사 페이지를 임의로 신규 생성하는 과정을 거쳐야만 했다. 페이지가 존재해야만 비로소 앱 생성 프로세스를 진행할 수 있는 구조였다.
여기서 소소한 시행착오가 하나 더 있었다. 앱 이름을 직관적으로 설정하기 위해 상표명인 'LinkedIn' 문자열 자체를 포함하여 지으려 했으나, 상표권 보호 정책 때문에 앱 생성 단계에서 차단되었다. 고민 끝에 상표명을 제외하고 나의 프로젝트 정체성을 담은 'JinsLabConnect'로 앱 이름을 대체하여 등록할 수 있었다.
비활성화된 Auth 탭과 관리자 인증 해결하기
우여곡절 끝에 개발자 앱을 개설하고 소셜 자동 발행을 위한 권한 설정을 진행하려 했다. 그런데 개발자 포털 화면에서 가장 핵심적인 역할을 담당하는 Auth(인증) 탭이 회색으로 비활성화되어 마우스 클릭조차 되지 않는 현상이 발생했다.
회사 페이지를 제대로 연결했음에도 아무런 설정을 할 수 없어 한참을 헤맸다. 원인을 찾아보니 연결한 회사 페이지의 관리자 인증을 완료해야만 비로소 이 Auth 탭이 활성화되는 메커니즘을 가지고 있었다.
해결을 위해 앱 메뉴의 'Settings' 탭으로 이동했다. 그곳에 있는 'Verify' 버튼을 찾아 클릭했고, 페이지 관리자인 본인 인증 절차를 성공적으로 마친 뒤에야 비로소 기다리던 Auth 탭이 정상적으로 열리며 권한을 제어할 수 있게 되었다.
이것이 스레드 API 비교 시 가장 크게 다가온 링크드인만의 진입 장벽이었다. 메타의 경우 테스터 초대와 승인 단계가 유독 번거롭고 까다로웠던 반면, 링크드인은 회사 페이지 강제 연결과 관리자 인증이라는 고유의 보안 및 인증 절차가 상당히 까다롭게 설계되어 있었다.
스레드보다 간편했던 토큰 발급과 전용 템플릿 세팅
초기의 복잡한 인증 절차를 통과하자, LinkedIn OAuth 토큰 발급 자체는 의외로 훨씬 간편하고 직관적이었다. 스레드는 토큰 하나를 얻기 위해 수동으로 복잡한 요청 과정을 직접 제어해야 했지만, 링크드인은 개발자 포털 내에 전용 'OAuth 2.0 tools'가 훌륭하게 내장되어 있었다.
도구 화면에서 필요한 권한 스코프인 openid, profile, w_member_social 항목들을 체크하고 버튼을 누르자 별도의 서버 구축 없이도 유효한 액세스 토큰이 즉시 발급되었다. 이 발급 편의성만큼은 링크드인이 스레드보다 훨씬 개발자 친화적으로 잘 구현되어 있다는 인상을 받았다.
정상적으로 토큰을 확보한 뒤에는 링크드인의 플랫폼 환경에 최적화된 발행 규칙을 설계했다. 매일 글을 밀어 넣던 스레드 방식과 달리, 링크드인은 발행 빈도를 주 2~3회(월, 수, 금)로 제한하여 피드가 너무 스팸처럼 보이지 않도록 조율했다.
발행되는 콘텐츠의 훅(Hook) 문구 역시 스레드용과는 완전히 구별되도록 바꿨다. 링크드인 유저들의 성향에 맞추어 전문적인 인사이트와 차분한 회고 톤을 담아낼 수 있는 링크드인 전용 템플릿을 새로 제작하여 적용했다.
이번 링크드인 API 연동 과정을 거치며 소셜 API 연동은 플랫폼마다 마주하는 장벽의 종류가 완연히 다르다는 값진 경험을 얻었다. 메타는 개발자 등록과 테스터 단계가, 링크드인은 회사 페이지 인증 단계가 고비였지만, 막상 토큰을 얻는 과정 자체는 링크드인이 훨씬 가벼웠다. 각각의 특성을 이해하고 나니 앞으로의 소셜 연동 작업도 훨씬 유연하게 대응할 수 있을 것 같다.