Bu rehberde: Hesap ve planlar, iş akışları, ajanlar ve modeller, entegrasyonlar, mesajlaşma, müşteri adayları, maliyet ve veri güvenliği hakkında en sık sorulan 35 sorunun kısa yanıtları.
⏱ 15 dakika
Kısaca
Aradığınız yanıtı bulamazsanız Sözlük sayfasına ve Sık karşılaşılan hatalar rehberine bakın.
Hesap ve planlar
OrqLabs'u ücretsiz deneyebilir miyim?
Evet. FREE plan: 1 proje, 3 iş akışı (1 aktif), ayda 100 çalıştırma ve 50 ajan çalıştırması, 2 entegrasyon, 10 bilgi bankası belgesi, 200 konuşma, aylık $5 LLM bütçesi ve yalnızca ekonomi katmanı modeller (claude-haiku-4-5, gpt-5-nano, gpt-4.1-mini). BYOK kapalıdır.
Planlar arasındaki temel fark ne? Model katmanları ve kotalar. STARTER dengeli modelleri ve BYOK'u açar ($50 bütçe, 3 proje, 8 entegrasyon); PRO amiral gemisi modelleri açar ($400, 15 proje, 30 entegrasyon, 40 aktif iş akışı). Tüm sayılar: Organizasyonlar ve planlar.
Birden fazla markayı tek hesapta yönetebilir miyim? Evet; her marka bir Projedir. Sosyal hesaplar, WhatsApp numarası, GA4 mülkü ve strateji belgesi projeye aittir. Ajanslar için PRO planda 15 proje bulunur; raporlar ve kullanım proje bazında filtrelenir.
Roller neler? OWNER (her şey, faturalama, silme), ADMIN (üyeler, entegrasyonlar, ayarlar), MEMBER (iş akışı, ajan, onay, gelen kutusu), VIEWER (salt okunur). Platform düzeyinde SUPER_ADMIN yönetim panelini kullanır.
Ekip arkadaşımı nasıl davet ederim?
Ayarlar → Üyeler → Davet et (e-posta + rol). Davet linki /invite/<token> ile kabul edilir. Plan members limiti geçerlidir (FREE 1, STARTER 3, PRO 15).
İş akışları
İş akışı neden çalışmadı?
Sırayla: durum ACTIVE mi (DRAFT/PAUSED çalışmaz), timezone doğru mu, doğrulama hatası var mı, plan runsPerMonth veya activeWorkflows limiti dolmuş mu, worker çalışıyor mu (yönetici). Çalıştırmalar sekmesinde kayıt yoksa tetikleyici hiç ateşlenmemiştir.
Test çalıştırması gerçek gönderi yapar mı?
Hayır. Test modunda social.publish, social.schedule, messaging.send, messaging.broadcast, utility.webhookOut dry-run çalışır. Ancak AI ve ajan node'ları gerçek LLM çağrısı yapar ve maliyet oluşturur.
Bir node'un çıktısını başka node'da nasıl kullanırım?
{{ $json.alan }} geçerli item'ı, {{ $node["Node adı"].json.alan }} başka node'un ilk item'ını, .all() tüm item'larını verir. Tam liste: İfade sözdizimi.
Onay bekleyen çalıştırma ne kadar bekler?
utility.approval.timeoutHours (varsayılan 72). Süre dolunca otomatik reddedilir ve rejected dalı çalışır. Bekleyen run kota tüketmez.
Aynı iş akışını iki tetikleyiciyle başlatabilir miyim?
Bir iş akışında tek tetikleyici olur. Ortak mantığı ayrı iş akışına alın ve utility.runWorkflow ile iki farklı tetikleyicili iş akışından çağırın.
Şablonu değiştirirsem başkalarını etkiler mi? Hayır. Kullan düğmesi kopya oluşturur; şablon dosyası değişmez.
Node adını değiştirdim, ifadeler bozuldu mu?
Editör $node["Eski ad"] referanslarını otomatik günceller; data.code içindeki metinleri elle düzeltin.
Ajanlar ve modeller
Hangi modeli seçmeliyim?
Sınıflandırma ve chatbot → economy; içerik, lead, outreach → balanced (claude-sonnet-5, gpt-5-mini); strateji, araştırma, SEO → flagship (claude-opus-5, gpt-5). Fiyat tablosu ve örnekler: Model seçimi ve fiyatlandırma.
Model seçmediğimde ne kullanılır?
Node modelId → iş akışı settings.defaultModelId → organizasyon varsayılanı → platform varsayılanı (claude-opus-5). Plan katmanı izin vermiyorsa aynı katmanın en ucuz izinli modeli kullanılır.
Ajan "budget_exceeded" ile bitti; verilerim kayboldu mu?
Hayır. O ana kadarki output, summary ve rapor kaydedilir. budgetUsd veya maxSteps artırın ya da görevi daraltın.
Ajan bellek tutuyor mu?
Kayıtlı ajanlar (Agents → Kaydet) çalıştırmalar arasında memory tutar (son işlenen id'ler, görülen domain'ler, konu geçmişi). Ad-hoc çalıştırmalar tutmaz. Belleği Ajan → Bellek → Sıfırla ile temizlersiniz.
Ajanın Türkçe yazmasını nasıl garanti ederim?
Proje locale: tr-TR, languages: [tr], görev metnini Türkçe yazın; Content Creator'da language: tr. Kayıtlı ajanda systemPromptAppend: "Her zaman Türkçe yaz."
Kendi Anthropic/OpenAI anahtarımı kullanabilir miyim? STARTER ve üstü planlarda evet (Entegrasyonlar → BYOK). Bu çağrıları sağlayıcı doğrudan sizin hesabınıza faturalar. OrqLabs onları kullanım sayfasında bilgi amaçlı gösterir ama aylık LLM bütçenize ve platform harcama tavanlarına saymaz; harcama sınırını sağlayıcı hesabınızda (Anthropic Console / OpenAI Limits) belirleyin. Bilgi bankası embedding'leri için OpenAI anahtarı (platform veya BYOK) gerekir.
Strateji belgesi nedir, ben yazmalı mıyım? Projenin ajanlar arası ortak planı (konu ağırlıkları, kanallar, saatler, KPI'lar). Boş başlayabilirsiniz; Analytics Strategist ilk çalıştırmada önerir, onaylarsınız. Elle de düzenlenir. Ajanlar analitiği nasıl kullanır.
Entegrasyonlar
"Platform yapılandırması eksik" ne demek?
OAuth sağlayıcısının uygulama kimlik bilgileri (META_APP_ID, INSTAGRAM_APP_ID, X_CLIENT_ID, LINKEDIN_CLIENT_ID, GOOGLE_CLIENT_ID, TIKTOK_CLIENT_KEY) .env'de tanımlı değil. Platform yöneticisi eklemelidir. Token/API key sağlayıcıları (WhatsApp, Telegram, Serper…) etkilenmez.
Redirect URI hatası alıyorum.
Sağlayıcı konsoluna https://api.orqlabs.com/api/v1/integrations/oauth/<provider>/callback adresini birebir (http/https, sondaki /) girmelisiniz. Tam URI bağlantı penceresinde gösterilir.
Webhook doğrulanmıyor (WhatsApp/Messenger).
PUBLIC_WEBHOOK_URL herkese açık ve HTTPS olmalı (geliştirmede ngrok), verify token panelden kopyalanmalı, uygulama Live modda olmalı. WhatsApp rehberindeki hata tablosu.
Token süresi dolunca ne olur?
OAuth token'ları otomatik yenilenir. Yenileme başarısızsa kart "Yeniden yetkilendirme gerekli" olur, integration.error olayı ve bildirim gelir; Yeniden bağla aynı integrationId'yi korur.
Instagram'a neden yayın yapılmıyor? Instagram medya zorunludur (JPEG, herkese açık URL) ve hesap profesyonel (İşletme veya İçerik üreticisi) olmalıdır; Facebook Sayfası gerekmez. Günlük 100 API gönderisi sınırı vardır.
Bir entegrasyonu silersem iş akışları ne olur?
O hesabı kullanan node'lar bir sonraki çalıştırmada INVALID verir. Silmeden önce Kullanım sekmesine bakın; hesabı değiştirmek için node'da yeni hesap seçin.
Mesajlaşma
Bot 24 saat sonra WhatsApp'ta yanıt veremiyor.
Meta'nın 24 saat müşteri hizmetleri penceresi kapanmıştır; yalnızca onaylı şablon gönderilebilir (messaging.send.templateName). WhatsApp şablonları.
İnsan devraldığında bot tamamen susar mı?
Evet, o konuşma için. trigger.messageReceived tetiklenmez. Bota geri ver ile devam eder.
Web sitemde chatbot kullanabilir miyim?
Evet; POST /orgs/:orgId/webchat/:projectId/messages uç noktası hazır ve entegrasyon gerekmez. Panelden kopyalanabilir hazır widget kodu henüz yok; şimdilik geliştiriciniz bu uç noktayla sitenize bir sohbet kutusu ekleyebilir.
Toplu WhatsApp mesajı gönderebilir miyim?
Onaylı Marketing şablonu ve alıcı opt-in'i ile evet (Kampanyalar veya messaging.broadcast). Türkiye'de tüketicilere ayrıca İYS onayı gerekir. Broadcast ve izin.
Lead'ler
Lead'ler neden tekilleştirildi / birleşti? E-posta → telefon → web sitesi eşleşmesi mevcut kaydı günceller. Aynı şirketten farklı kişiler için e-posta veya telefon zorunlu tutun.
Skor nasıl hesaplanır?
Lead Qualifier uyum (40), bütçe sinyali (25), niyet (20), ulaşılabilirlik (15) ağırlıklarıyla 0-100 puan verir ve scoreReason yazar; criteria ile kurallar eklenir. İnsan elle değiştirebilir.
CSV içe aktarımında hangi sütunlar gerekir?
En az name ve email veya phone. Diğerleri: company, website, title, status, score, tags (; ile), source, notes; bilinmeyenler custom.*.
CRM'imle iki yönlü senkron var mı?
Tek yönlü (OrqLabs → CRM) leads.crmSync ile; CRM → OrqLabs için API veya trigger.webhook. CRM senkronizasyonu.
Faturalama ve maliyet
Maliyet nasıl hesaplanır?
Token × model fiyatı (1M token başına USD) + önbellek token'ları. Her çağrı UsageRecord olur; Ayarlar → Kullanım'da model/ajan/proje/gün kırılımı. Kullanım ve maliyet takibi.
Aylık bütçem dolarsa ne olur? %80'de uyarı; %100'de yeni LLM çağrıları reddedilir, LLM içermeyen iş akışları çalışmaya devam eder. Ay başında sıfırlanır. Plan tavanını aşan bütçe için plan yükseltin.
Test çalıştırmaları ücretsiz mi? Yayın/mesaj dry-run olur ama LLM çağrıları gerçektir. Testlerde economy model seçin.
Planımı nasıl değiştiririm? Ayarlar → Faturalama → Planı değiştir. Ödeme sayfasına yönlendirilirsiniz; ödeme tamamlanınca plan hemen güncellenir. Kurumsal (ENTERPRISE) plan için bizimle iletişime geçin.
Veri ve güvenlik
Kimlik bilgilerim nasıl saklanıyor? AES-256-GCM ile şifreli; API asla döndürmez; loglara yazılmaz. Güvenlik ve gizlilik.
LLM sağlayıcıları verilerimi eğitimde kullanır mı?
Anthropic ve OpenAI API verileri varsayılan olarak model eğitiminde kullanılmaz (sağlayıcı API politikaları). claude-fable-5-1 30 günlük veri saklama ayarı gerektirir. BYOK ile veri sizin sağlayıcı hesabınızda işlenir.
KVKK silme talebini nasıl işlerim?
Lead'i silin (DELETE /orgs/:orgId/leads/:id; aktiviteler silinir, konuşmalar anonimleştirilir), konuşmayı silin, bilgi bankasından belgeyi kaldırın; dış CRM/sağlayıcı kopyaları için ayrı işlem. 30 gün içinde yanıt verin.
Verilerimi dışa aktarabilir miyim?
Lead'ler CSV (/leads/export), kullanım CSV, raporlar API ile JSON, konuşmalar API ile. Tam organizasyon dışa aktarımı için destek ile iletişime geçin.
Self-host edebilir miyim? Hayır. OrqLabs yalnızca bulut hizmeti (orqlabs.com) olarak sunulur; kendi sunucunuza kurulan bir sürümü yoktur. Altyapı, güncellemeler, yedekler ve güvenlik sıkılaştırması bizim sorumluluğumuzdadır.