Connector

Uygulamanı Slack, Resend ve ElevenLabs gibi üçüncü taraf servislerle bağla. Kimlik bilgileri şifrelenir ve işlemler önceden kimlik doğrulamalı olarak gelir.

Connector’lar, harici servisleri uygulamana ham API anahtarlarını kodda yönetmek zorunda kalmadan entegre etmeni sağlar. Bir bağlantıyı bir kez kurarsın, projenle ilişkilendirirsin ve uygulamanın içinden önceden hazırlanmış işlemleri çağırırsın. Kimlik bilgileri bekleme durumunda şifrelenir ve hiçbir zaman frontend koduna açık hâle getirilmez.

Mevcut connector’lar

Connector	Kategori	Kimlik doğrulama türü	Ne işe yarar
Resend	İletişim	API anahtarı	İşlemsel e-posta gönderme, toplu e-posta gönderme, doğrulanmış domain’leri listeleme
Slack	İletişim	OAuth	Mesaj gönderme, kanal ve kullanıcıları listeleme, mesajlara tepki verme, thread okuma
ElevenLabs	Yapay Zeka	API anahtarı	Metinden sese dönüştürme, mevcut sesleri listeleme, ses efekti üretme

Yeni connector’lar düzenli olarak eklenmektedir.

Connector’lar nasıl çalışır?

1. Bir bağlantı oluşturursun — kimlik bilgilerini sağlarsın (bir API anahtarı veya OAuth ile oturum açma)
2. Bağlantıyı bir projeyle ilişkilendirirsin — bu, projenin söz konusu kimlik bilgilerini kullanmasına yetki verir
3. Uygulamanın işlemleri çağırır — istek Proyecta Cloud üzerinden gider; Proyecta Cloud kimlik bilgilerini sunucu tarafında ekler

Uygulama kodun hiçbir zaman ham API anahtarına veya OAuth token’ına dokunmaz. Connector sistemi kimlik doğrulamayı, hız sınırlamayı ve denetim günlüğünü yönetir.

Bir connector kurma

1. Projenizi builder’da açın
2. Settings > Connectors bölümüne gidin
3. Katalogdan bir connector’a tıklayın (ör. Resend)
4. Kimlik bilgilerinizi girin:
   • API anahtarlı connector’lar (Resend, ElevenLabs): Gizli anahtarınızı yapıştırın
   • OAuth connector’ları (Slack): Oturum açın ve erişimi yetkilendirin
5. Bağlantıya bir ad verin (ör. “Production Resend”)
6. Bağlantı otomatik olarak test edilir ve geçerliyse Active olarak işaretlenir

Uygulamanızdan bir connector üzerinden okuma

Uygulamanız, API anahtarı hiçbir zaman bundle’a girmeden üçüncü taraf bir API’yi doğrudan tarayıcıdan okuyabilir. Kimlik bilgisi platformda şifreli olarak kalır; uygulamanız yalnızca connector’ı, işlemi ve tipli bir girdiyi belirtir, çağrıyı sizin adınıza platform yapar.

import { useConnectorData, useHttpRead } from '@/hooks/useConnector.ts';

// A connector's own read action, as a cached query
const { data, isLoading, error } = useConnectorData('eleven-labs', 'listVoices');

// The generic HTTP-read connector, by endpoint name
const { data: feed } = useHttpRead('news-feed', { limit: 10 });

Bilinmesi gereken iki koruma vardır ve bunlar bilinçlidir:

• Yalnızca okuma. Yalnızca platformun tarayıcı için güvenli olarak işaretlediği işlemlere erişilebilir — diğer her şey 403 döner. Yazma işlemleri (Slack’e mesaj atma, e-posta gönderme, karttan çekim yapma) tarayıcıdan hiçbir zaman erişilebilir değildir.
• URL veya host geçemezsiniz. Genel http-read connector’ında girdi { endpointKey, params } şeklindedir ve endpointKey’in arkasındaki URL’yi uygulama kodu değil, uygulama sahibi olarak siz yapılandırırsınız. Üçüncü taraf anahtarları kota ile ölçüldüğü için yanıtlar sunucu tarafında önbelleğe alınır ve hız sınırlamasına tabidir.

404, sahibin o connector’ı henüz bağlamadığı anlamına gelir — arayüzünüzde ele almaya değer durum budur.

Yapay zekâya bağlantıyı kurdurun

Connector kodunu elle yazmak zorunda değilsiniz. AI builder, projenize hangi connector’ların bağlı olduğunu bilir ve entegrasyonu sizin için oluşturabilir:

• "Kullanıcılar kayıt olduğunda bir hoş geldin e-postası gönder" — Resend connector’ını kullanır
• "Yeni bir sipariş geldiğinde Slack mesajı gönder" — Slack connector’ını kullanır
• "Makale sayfasında sesli anlatım oynat" — ElevenLabs connector’ını kullanır

Connector işlemleri referansı

Resend (connectorId: 'resend')

İşlem	Yan etki	Açıklama
sendEmail	yazma	Tek bir işlemsel e-posta gönderir
sendBatch	yazma	Aynı anda birden fazla e-posta gönderir
listDomains	okuma	Doğrulanmış gönderim domain’lerini listeler

Slack (connectorId: 'slack')

İşlem	Yan etki	Açıklama
postMessage	yazma	Bir kanala mesaj gönderir
listChannels	okuma	Çalışma alanındaki kanalları listeler
listUsers	okuma	Çalışma alanı üyelerini listeler
reactToMessage	yazma	Emoji tepkisi ekler
getThread	okuma	Bir thread’deki yanıtları getirir

ElevenLabs (connectorId: 'eleven-labs')

İşlem	Yan etki	Açıklama
textToSpeech	yazma	Metni ses dosyasına dönüştürür
listVoices	okuma	Mevcut sesleri listeler
generateSoundEffect	yazma	Yapay zekâ ses efekti üretir

Bağlantı durumları

Durum	Anlamı
Active	Kimlik bilgileri geçerli ve bağlantı kullanıma hazır
Broken	Kimlik bilgilerinin süresi dolmuş veya iptal edilmiş — geri yüklemek için güncelleyin

Güvenlik

• Kimlik bilgileri bekleme durumunda AES-256-GCM ile şifrelenir
• İşlemler, proje başına connector başına dakikada 1.000 istekle hız sınırlamasına tabidir
• Her işlem çağrısı denetim izi ile birlikte kaydedilir (bağlantı, işlem, süre, durum)
• Bağlantılar tüm çalışma alanı kapsamındadır

SSS

Aynı bağlantıyı birden fazla projede kullanabilir miyim?

Evet. Bağlantıyı bir kez oluşturun ve aynı çalışma alanındaki istediğiniz sayıda projeyle ilişkilendirin.

API anahtarımın süresi dolarsa veya iptal edilirse ne olur?

Bağlantı durumu Broken olarak değişir. Geri yüklemek için Settings > Connectors bölümünden kimlik bilgilerini güncelleyin.

Connector işlemlerini frontend’den çağırabilir miyim?

Uygulamanız kimlik bilgilerini hiçbir zaman tutmaz. Tarayıcı için güvenli okuma işlemleri, kimlik bilgilerini sunucu tarafında ekleyen Proyecta Cloud üzerinden proxy’lenir; böylece anahtar hiçbir zaman bundle’ınıza girmez. Yazma işlemleri ise tarayıcıdan hiç erişilebilir değildir.

Kendi özel connector’larımı ekleyebilir miyim?

Henüz değil. Özel connector tanımları yol haritasında yer almaktadır.

Yakında

• Ek connector’lar (Google, Twilio, SendGrid ve daha fazlası)
• Özel connector tanımları — kendi API’nizi getirin
• Bağlı servislerden gelen olaylar için webhook alımı
• OAuth gateway — istemci tarafından başlatılan akışlarda bile token’ları sunucu tarafında tutma