İlk entegrasyonunuzu bağlama

Bu rehberde: Entegrasyonlar sayfasını tanırsınız. Üç farklı bağlantı türünü örnekle görürsünüz: LinkedIn (izin ekranı), Telegram (token yapıştırma), Serper (API anahtarı). Bağlantıyı test edip doğru projeye atarsınız.

⏱ 10 dakika

Entegrasyon nedir?#

Entegrasyon, OrqLabs'ın sizin adınıza kullandığı bir dış hesaptır. Örneğin LinkedIn sayfanız, Telegram botunuz, Google Analytics mülkünüz.

Hesap bağlamadan ajanlar yalnızca taslak üretir. Yayınlamak, mesaj almak ve ölçmek için en az bir hesap bağlamanız gerekir.

Entegrasyonlar sayfası#

Sol menüden Entegrasyonlar sayfasını açın. 28 sağlayıcı kartı kategorilere göre listelenir.

• ① Kategoriler: Sosyal medya, Mesajlaşma, Analitik ve SEO, Araştırma, CRM ve veri, Yardımcılar, LLM anahtarları (BYOK).
• ② Bağlı bir hesapta yeşil Bağlı rozeti ve hesap adı görünür. Bağlı kartlarda Bağlantıyı test et, Düzenle ve Bağlantıyı kes vardır.
• ③ Bağla düğmesi bağlantı penceresini açar.
• ④ Kurulum rehberi bağlantısı, o sağlayıcının adım adım rehberini yan panelde açar.

Her kartta bir kapsam etiketi de görürsünüz: proje bazlı (tek markaya ait) veya organizasyon geneli (tüm markalar paylaşır).

Dikkat: Bir kartta "Bu OAuth uygulaması platformda henüz yapılandırılmamış" yazıyorsa platform yöneticisi o sağlayıcının uygulama bilgilerini (META_APP_ID, LINKEDIN_CLIENT_ID gibi) henüz girmemiştir. Bu durumda token veya API anahtarı ile bağlanan sağlayıcılardan (Telegram, Serper) başlayın.

Üç bağlantı türü#

Örnek 1: LinkedIn (izin ekranı)#

1. Entegrasyonlar sayfasında LinkedIn kartında Bağla düğmesine basın. Bağlantı penceresi açılır.
2. Proje alanından markanızı seçin. LinkedIn proje bazlıdır.
3. LinkedIn ile devam et düğmesine basın. LinkedIn'in izin sayfası açılır. İstenen izinler: openid, profile, w_member_social, r_organization_social, w_organization_social.
4. Kişisel profilinizi veya yönettiğiniz şirket sayfasını seçin ve Allow deyin. OrqLabs'a geri dönersiniz.
5. Kart artık Bağlı görünür. Adres satırında ?connected=<id> ile yeni bağlantı vurgulanır.
6. Bağlantıyı test et düğmesine basın. Profil adınız ve token'ın kalan süresi görünür.

LinkedIn izni 60 gün geçerlidir. Süre yaklaşınca bildirim alırsınız; Yeniden yetkilendir ile uzatırsınız. Ayrıntı: LinkedIn.

Örnek 2: Telegram (token)#

1. Telegram'da @BotFather ile sohbet açın. /newbot yazın. Bot adı ve bot ile biten kullanıcı adı verin. BotFather size 123456789:AAF... biçiminde bir token verir.
2. Entegrasyonlar sayfasında Telegram Bot kartında Bağla düğmesine basın.
3. Proje alanından markanızı seçin.
4. Bot Token alanına token'ı yapıştırın. Toplu duyuru yapacaksanız Default channel / chat ID (optional) alanını da doldurun.
5. Bağla düğmesine basın. OrqLabs botun bilgisini okur ve webhook adresini Telegram'a otomatik kaydeder. Kart Bağlı olur.
6. Telegram'da botunuza "merhaba" yazın. Gelen Kutusu sayfasında konuşma görünür.

Geliştirici notu: Webhook adresi {PUBLIC_WEBHOOK_URL}/api/v1/webhooks/telegram/<integrationId> kalıbındadır. Üretimde https://api.orqlabs.com/...; yerel geliştirmede ngrok http 4000 ile herkese açık HTTPS adres gerekir.

Ayrıntı: Telegram.

Örnek 3: Serper (API anahtarı)#

1. serper.dev adresinde hesap açın. Dashboard sayfasında API anahtarınız görünür. 2.500 ücretsiz sorgu verilir.
2. Entegrasyonlar sayfasında Serper (Google Search API) kartında Bağla düğmesine basın. Bu sağlayıcı organizasyon genelidir; proje seçilmez.
3. API key alanına anahtarı yapıştırın ve Bağla düğmesine basın.
4. Bağlantıyı test et düğmesine basın. Küçük bir arama yapılır; kalan kota gösterilir.

Artık web araması yapan tüm ajanlar (Content Creator, Lead Researcher, Market Analyst, Competitor Analyst, SEO & Traffic) ve data.webSearch node'u çalışır.

Bağlı hesabın ayrıntı paneli#

Bağlı bir karta tıkladığınızda ayrıntı paneli açılır.

• ① Durum: Bağlı, Yeniden yetkilendirme gerekli veya Hata.
• ② Bağlantıyı test et: sağlayıcıya küçük bir istek atar.
• ③ Webhook adresi: mesaj alan sağlayıcılarda (WhatsApp, Slack, Discord) bu adresi sağlayıcı konsoluna girersiniz. Telegram'da OrqLabs kendisi kaydeder.
• ④ Doğrulama token'ı: Meta ürünlerinde (WhatsApp, Messenger) sağlayıcıya girdiğiniz parola.
• ⑤ Bağlantıyı kes: hesabı kaldırır. Bu hesabı kullanan iş akışları bir sonraki çalıştırmada hata verir.

Test sonuçlarını okuma#

Test başarılıysa "Bağlantı başarılı" görürsünüz. Başarısızsa mesaj bir kodla başlar:

Doğru kapsamı seçmek#

Yanlış projeye bağladıysanız karta tıklayın; ayrıntı panelindeki Proje alanını değiştirip Kaydet deyin. İş akışlarındaki bağlantı kimliği değişmez.

Node ve ajanlarda hesap seçimi#

• İş akışı editöründe bir yayın node'u seçtiğinizde Bağlı hesap listesi çıkar. Yalnızca uygun sağlayıcının bağlı hesapları görünür.
• Ajan node'larında Entegrasyonlar çoklu seçimi boşsa ajan projenin tüm hesaplarını kullanabilir.
• Ajanlar sayfasından tek çalıştırmada aynı seçim Entegrasyonlar alanındadır.

Plan limitleri ve güvenlik#

• Bağlı entegrasyon sayısı: FREE 2, STARTER 8, PRO 30.
• Kimlik bilgileri AES-256-GCM ile şifrelenir. API bunları hiçbir zaman geri döndürmez.
• Yalnızca Sahip ve Yönetici bağlayabilir ve kaldırabilir.

Sık sorulan sorular#

Şifremi OrqLabs'a veriyor muyum? İzin ekranı (OAuth) yönteminde hayır. Sağlayıcının kendi sayfasında izin verirsiniz; OrqLabs yalnızca bir erişim izni alır. Token ve API anahtarı yöntemlerinde de şifrenizi değil, sağlayıcının ürettiği ayrı bir anahtarı girersiniz.

Bağlantı bir gün kendiliğinden kopar mı? İzinlerin süresi dolabilir (örneğin LinkedIn 60 gün). Süre yaklaşınca bildirim alırsınız. Yeniden yetkilendir ile yenilersiniz; iş akışlarınız bozulmaz.

Aynı platformdan iki hesap bağlayabilir miyim? Evet. Her hesap ayrı bir kart olur. Node'larda hangisini kullanacağınızı seçersiniz.

"Bağla" düğmesi pasif, neden? Ya plan limitine ulaştınız ya da o OAuth sağlayıcısı platformda yapılandırılmamış. Kartın üzerindeki uyarıyı okuyun.

Sonraki adım#

• İlk iş akışınız
• Entegrasyonlara genel bakış
• Sözlük: OAuth, token, webhook