LinkedIn

Bu rehberde: LinkedIn profilinizi veya şirket sayfanızı bağlarsınız. Platform yöneticisi LinkedIn Developer Portal'da uygulama oluşturur; siz Bağla deyip izin verirsiniz. Şirket sayfası adına paylaşım için ayrı bir Community Management API uygulaması gerekir; kurulumu Şirket sayfası adına paylaşım bölümündedir.

⏱ 20 dakika (uygulama oluşturma dahil)

Kimlik kartı#

Ne işe yarar?#

• Kişisel profile veya yönettiğiniz şirket sayfasına metin, görsel, video ve çoklu görsel gönderileri yayınlar. Sınır 3.000 karakter; ilk 210 karakter "devamını gör" öncesinde görünür.
• Şirket sayfası gönderilerinin gösterim, tıklama, beğeni, yorum ve paylaşımını okur.

Yorum okuma ve yanıtlama LinkedIn'de yoktur; Community Manager bu hesabı kullanmaz.

Ön koşullar#

• Bir LinkedIn üye hesabı ve yayın için bir LinkedIn Page (şirket sayfası). Uygulama oluşturmak için de bir sayfa gerekir.
• Şirket sayfasına yayın için izin veren üyenin sayfada Super admin veya Content admin rolü.
• developer.linkedin.com erişimi.
• Şirket sayfası yayını ve analitiği için Community Management API ürünü olan ayrı bir LinkedIn uygulaması (LINKEDIN_PAGES_CLIENT_ID, LINKEDIN_PAGES_CLIENT_SECRET). LinkedIn bu ürünü yalnızca başka ürünü olmayan yeni bir uygulamaya verir.
• Kişisel profile yayın için platform yöneticisinin LINKEDIN_CLIENT_ID ve LINKEDIN_CLIENT_SECRET tanımlamış olması.
• OrqLabs'ta Sahip veya Yönetici rolü.

Adım adım kurulum#

A) LinkedIn Developer Portal (platform yöneticisi, bir kez)#

1. developer.linkedin.com → My apps → Create app.
2. ① App name: izin ekranında görünen ad (örneğin "OrqLabs – Marka").
3. ② LinkedIn Page: uygulamanın bağlanacağı şirket sayfası. Gizlilik politikası adresi ve kare logo da ekleyin.
4. ③ Sözleşmeyi onaylayıp Create app.
5. Settings sekmesinde Verify → Generate URL. Bağlantıyı sayfa yöneticisine gönderin; yönetici Verify dediğinde uygulama doğrulanır. Doğrulanmamış uygulamalar bazı ürünlere başvuramaz.

6. Products sekmesinde şu ürünleri ekleyin:
   • ① Share on LinkedIn → Request access. Anında onaylanır; kişisel profile yayın izni verir.
   • ② Sign In with LinkedIn using OpenID Connect → Request access. Anında onaylanır; bağlı üyeyi tanımlar.
   • ③ Community Management API bu uygulamaya eklenemez: LinkedIn bu ürünü yalnızca başka ürünü olmayan yeni bir uygulamaya verir. Şirket sayfası için aşağıdaki Şirket sayfası adına paylaşım bölümünü izleyin.

7. Auth sekmesinde ① Client ID ve ② Primary Client Secret değerlerini kopyalayın (Show ile görüntüleyin).

8. Aynı sekmede OAuth 2.0 settings → Authorized redirect URLs → ① Add redirect URL: https://api.orqlabs.com/api/v1/integrations/oauth/linkedin/callback. Tam adresi bağlantı penceresinden kopyalayın. ② Update.
9. Aynı sekmedeki kapsam listesinde eklediğiniz ürünlerin kapsamlarının göründüğünü doğrulayın.
10. Yönetici değerleri LINKEDIN_CLIENT_ID ve LINKEDIN_CLIENT_SECRET olarak tanımlar ve API'yi yeniden başlatır.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar sayfasında LinkedIn kartında Bağla düğmesine basın.
2. ① Proje seçin.
3. ② Bağla. LinkedIn izin ekranı açılır: uygulamanın adı, logosu ve istenen izinler. Şirket sayfası için sayfada Super admin veya Content admin olan hesapla giriş yapın.
4. Allow düğmesine basın.
5. OrqLabs'a geri dönersiniz. Kart Bağlı olur. Community Management API uygulaması tanımlıysa yönetici olduğunuz ilk şirket sayfası paylaşım hedefi olur; değilse gönderiler kişisel profilinize gider.
6. Ayrıntı panelindeki Gönderiler nereye gidiyor? bölümü hedefi açıkça gösterir: "Şirket sayfası: …" veya "Kişisel profil: …". Birden fazla sayfa yönetiyorsanız Paylaşım hedefi listesinden sayfayı seçip Kaydet deyin.
7. Bağlantıyı test et ile doğrulayın.

Şirket sayfası adına paylaşım (Community Management API)#

Şirket sayfanız (ör. OrqLabs) adına paylaşım için LinkedIn'in Community Management API ürünü gerekir. LinkedIn bu ürünü yalnızca başka ürünü olmayan yeni bir uygulamaya verir; bu yüzden mevcut uygulamanın (Share on LinkedIn + OpenID Connect) yanına ikinci bir uygulama açılır. Development tier günde uygulama başına 500 çağrı verir; bir markanın paylaşımları için yeterlidir.

1. developer.linkedin.com → My apps → Create app. LinkedIn Page alanında şirket sayfanızı seçin (ör. "OrqLabs – Sayfa"). Uygulamayı oluşturan kişi sayfada yönetici olmalıdır.
2. Settings → Verify → Generate URL; sayfa yöneticisi bağlantıyı açıp onaylar. Sayfa doğrulanmadan ürün başvurusu yapılamaz.
3. ① Products → Community Management API → Request access. Development tier erişim formunu şirketin yasal bilgileriyle (resmî şirket adı, adres, web sitesi, kullanım amacı) doldurun. Bu uygulamaya başka ürün eklemeyin.
4. ② Auth → OAuth 2.0 settings → Authorized redirect URLs → Add redirect URL: https://api.orqlabs.com/api/v1/integrations/oauth/linkedin/callback → Update.
5. Onay geldikten sonra Auth sekmesinde OAuth 2.0 scopes listesinde w_organization_social, r_organization_social ve rw_organization_admin göründüğünü kontrol edin.
6. ③ Aynı sekmeden Client ID ve Primary Client Secret değerlerini kopyalayın.
7. Platform yöneticisi değerleri LINKEDIN_PAGES_CLIENT_ID ve LINKEDIN_PAGES_CLIENT_SECRET olarak tanımlar ve API'yi yeniden başlatır. İsteğe bağlı LINKEDIN_PAGES_SCOPES varsayılan olarak w_organization_social r_organization_social rw_organization_admin kullanır.
8. Kullanıcılar LinkedIn'i yeniden bağlar (ayrıntı panelinde Yeniden yetkilendir veya kartta Bağla). Sayfa yöneticisi hesabıyla giriş yapılmalıdır. Ayrıntı panelinde "Şirket sayfası: …" görünmelidir.

Notlar:

• Bu uygulama tanımlıyken yeni LinkedIn bağlantıları onu kullanır; tanımlı değilse ilk uygulama (kişisel profil) kullanılır. Eski bağlantılar kendi uygulamalarıyla çalışmaya devam eder.
• Bu uygulamada OpenID Connect olmadığı için OrqLabs üyenin adını okuyamayabilir; şirket sayfası adına paylaşım bundan etkilenmez.
• LINKEDIN_ORGANIZATION_ACCESS=true yalnızca ilk uygulamanın kendisinde Community Management API varsa kullanılır; ayrı uygulamada gerekmez.

İzinler ve kapsamlar#

LinkedIn kişisel profil gönderilerinin analitiğini açmaz; Metrik al kişisel bağlantılarda yalnızca temel sayıları döndürür. Tam istatistik şirket sayfası için okunur.

Uygulama incelemesi#

• Uygulama doğrulaması (Verify): sayfa yöneticisinin onayı gerekir.
• Share on LinkedIn ve OpenID Connect: anında onay, inceleme yok.
• Community Management API: yalnızca ürünsüz, ayrı bir uygulamaya eklenir; Development tier erişim formu şirketin yasal bilgilerini ister. Onay ve LINKEDIN_PAGES_CLIENT_ID/SECRET tanımı sonrasında mevcut bağlantıları Yeniden yetkilendir; eski izinler yeni kapsamları içermez.
• Şirket sayfasına yayın için üye sayfada Super admin veya Content admin olmalıdır.

Limitler#

Bağlantıyı test etme#

② Bağlantıyı test et üyenin adını, yönetici olduğu şirket sayfalarını ve iznin kalan gün sayısını gösterir. Şirket sayfası listesi boşsa ya Community Management API onayı yoktur ya da üye sayfada yönetici değildir.

Kimlik bilgilerini yenileme#

• İzin 60 gün geçerlidir. LinkedIn otomatik yenilemeyi yalnızca belirli ortaklık programlarına açar. Yenileme yoksa OrqLabs süre dolmadan 7 gün önce bildirim gönderir; Yeniden yetkilendir ile 60 gün daha uzatırsınız.
• Üye LinkedIn'de Settings & Privacy → Data privacy → Permitted services altından uygulamayı kaldırırsa izin anında geçersiz olur.
• Yeni kapsam eklendiğinde (Community Management API onayı sonrası) yeniden yetkilendirin.
• Yayın yapan üye şirketten ayrılıyorsa bağlantıyı başka bir yöneticiyle yeniden kurun; iş akışları bozulmaz.

Sık karşılaşılan hatalar#

Sık sorulan sorular#

Kişisel profilimden mi şirket sayfamdan mı yayınlanır? Ayrıntı panelindeki Gönderiler nereye gidiyor? bölümü gösterir. Şirket sayfası için Community Management API uygulaması gerekir; birden fazla sayfanız varsa Paylaşım hedefi listesinden seçersiniz.

60 günde bir yeniden bağlanmak zorunda mıyım? Standart uygulamalarda evet. Süre yaklaşınca bildirim alırsınız; bir tıkla yenilersiniz.

LinkedIn'de yorumları yanıtlar mı? Hayır. LinkedIn bu yeteneği sağlamaz.

Sonraki adım#

• Entegrasyonlara genel bakış
• İlk entegrasyonunuzu bağlama
• Sosyal medya node'ları