Bağlantılar
Birçok iş akışı bloğu başka bir servise erişir — Slack, Gmail, Google Sheets, Notion, bir yapay zekâ sağlayıcısı vb. Bir blok bunu yapabilmeden önce, sizin adınıza oturum açma iznine ihtiyaç duyar.
Bağlantı, işte bu saklanmış izindir. Bağlantıyı Bağlantılar sekmesinde bir kez kurarsınız, sonra ihtiyaç duyan her bloğun içinde açılır menüden seçersiniz. Sırlar şifreli olarak saklanır ve yalnızca bir iş akışı çalışırken çözülür — size asla geri gösterilmez, ekleyen kişiye bile.
İki bağlantı türü
| Tür | Nasıl kurulur | Nerede görünür | Tipik servisler |
|---|---|---|---|
| Bağlı hesap | Açılan pencereden servise oturum açar ve erişimi onaylarsınız | Bağlı hesaplar | Google, Microsoft |
| API kimlik bilgisi | Servisin size verdiği anahtarı veya token'ı yapıştırırsınız | API kimlik bilgileri | OpenAI, Slack, Notion, Stripe, Tavily |
Kaydedildikten sonra ikisi de aynı şekilde çalışır: blok yalnızca bağlantıyı adıyla seçer.
:::info Arketic'in kendi adımları bağlantı gerektirmez Arketic içinde kalan bloklar — bilgi bankası arama, belge arama, Arketic web araması, Arketic asistanı, konuşma ve görsel blokları, görev oluşturma/güncelleme, uygulama içi bildirimler ve yerleşik Arketic AI modeli — hiçbir şey bağlamadan çalışır. Bağlantıya yalnızca bir blok Arketic dışına çıktığında ihtiyaç duyarsınız. :::
Bağlantılar Sekmesini Açma
İş Akışları → Bağlantılar'a gidin.
Sekme yukarıdan aşağıya dört bölümden oluşur:
- Sırların şifreli saklandığını ve yalnızca çalışma anında çözüldüğünü hatırlatan tek satırlık bir not.
- Sağda iki düğme — Hesap bağla ve Bağlantı ekle.
- "Bozuk bir şey var mı?" sorusuna bir bakışta yanıt veren bir sağlık özeti şeridi.
- İki raf — Bağlı hesaplar ve API kimlik bilgileri — her bağlantı için birer kart taşır.
Henüz hiçbir şey kurmadıysanız Henüz bağlantı yok başlığını, "İş akışı bloklarınızın otomatikleştirdiği servislere ulaşabilmesi için bir hesap bağlayın veya bir API anahtarı ekleyin." mesajını ve hemen altında iki düğmeyi görürsünüz.
Her rafın kendi boş durum ipucu da vardır:
| Raf | Boşken görünen ipucu |
|---|---|
| Bağlı hesaplar | Bağlı hesap yok. Google gibi OAuth servisleri için "Hesap bağla"yı kullanın. |
| API kimlik bilgileri | Henüz API anahtarı yok. Anahtar veya token ile kimlik doğrulayan servisler için bir tane ekleyin. |
Hesap Bağlama (Oturum Açma)
Bunu, anahtar yapıştırmak yerine oturum açtığınız servisler için kullanın.
- Hesap bağla'ya tıklayın.
- Menüden sağlayıcıyı seçin.
- Sağlayıcının kendi oturum açma sayfası bir açılır pencerede açılır. Oturum açın ve istenen erişimi onaylayın.
- Pencere kapanır ve Hesap bağlandı. mesajını görürsünüz. Yeni hesap Bağlı hesaplar rafında belirir.
Oturum Açabileceğiniz Sağlayıcılar
| Sağlayıcı | Durum |
|---|---|
| Kullanılabilir | |
| Microsoft | Kullanılabilir |
| Atlassian | Kullanılabilir. Paletteki hiçbir blok henüz Atlassian hesabı kullanmıyor |
| Slack | Yakında rozeti — henüz seçilemiyor |
| GitHub | Yakında rozeti — henüz seçilemiyor |
Yakında işaretli sağlayıcılar, çalışmayacak bir düğme yerine soluk ve Yakında ipucuyla gösterilir. Slack ve GitHub blokları bugün bunun yerine bir anahtarla çalışır — anahtarı Bağlantı ekle ile ekleyin.
Bağlı bir Google hesabı, oturum açarak çalışan tüm Google bloklarına hizmet eder — Gmail, Google Sheets, Google Drive, Google Calendar ve diğerleri; bağlı bir Microsoft hesabı ise Outlook, Microsoft Teams, Microsoft Excel, OneDrive, SharePoint ve Microsoft Planner bloklarına hizmet eder.
:::caution Açılır pencere açılmazsa Tarayıcınız engelliyor olabilir — Açılır pencere engellendi — açılır pencerelere izin verip tekrar deneyin. mesajını görürsünüz. Arketic için açılır pencerelere izin verin ve sağlayıcıya yeniden tıklayın. Oturum açma, erişim verilmeden biterse Arketic Bağlantı iptal edildi. der ve hiçbir şey kaydedilmez. Pencereyi kendiniz kapatırsanız deneme yalnızca sona erer. :::
Kurumunuz belirli bir oturum açma sağlayıcısının kurulumunu henüz tamamlamadıysa, Arketic sessizce hata vermek yerine bunu açıkça söyler. Yöneticinizden kurulumu tamamlamasını isteyin, sonra tekrar deneyin.
API Kimlik Bilgisi Ekleme (Anahtar veya Token)
Bunu, size yapıştırmanız için anahtar veya token veren servisler için kullanın.
- Bağlantı ekle'ye tıklayın. Bağlantı ekle galerisi açılır ve arama kutusu doğrudan odaklanmış gelir.
- Yazarak daraltın — yer tutucu şunu önerir: Bağlantılarda ara… (örn. Slack, Notion, OpenAI). Arama servis adına göre eşleşir.
- Servisin kartına tıklayın.
Her kartta ne bekleyeceğinizi söyleyen küçük bir etiket bulunur:
| Kart etiketi | Anlamı |
|---|---|
| Anahtar · test edilebilir | Bir anahtar yapıştırın — Arketic bunu otomatik denetleyebilir |
| Anahtar | Bir anahtar yapıştırın — bu servis otomatik denetim sunmuyor |
:::info Bazı servisler neden galeride yok Galeri, iş akışı bloklarınızın gerçekten kullanabileceği servisleri listeler. Bir şey arayıp “…” ile eşleşen sağlayıcı yok. görüyorsanız, onun için henüz bir blok yok demektir. :::
Yeni Kimlik Bilgisi Penceresi
Bir servis seçtiğinizde Yeni Kimlik Bilgisi penceresi açılır:
| Alan | Notlar |
|---|---|
| Sağlayıcı | Servislerin açılır listesi. Yalnızca pencereyi tek bir servise bağlı olmayan bir bloktan — örneğin bir Ajan veya API bloğundan — açtığınızda görünür. Galeriden ve servisini bilen bir bloktan açtığınızda servis zaten seçilidir ve alan gizlidir |
| Ad | Zorunlu. Bu bağlantı için kendi etiketiniz — ör. OpenAI anahtarım. En fazla 200 karakter |
| Sır alan(lar)ı | O servisin tanımladığı bir veya birkaç alan — ör. bir anahtar, bir token ya da anahtar artı bir hesap tanımlayıcısı. Sırlar maskeli alanlara yazılır |
Bazı servisler alanların altına anahtarla ilgili kısa bir not ekler. Oluştur'a tıklayın (çalışırken "Oluşturuluyor…" gösterir) veya vazgeçmek için İptal'e basın.
Oluşturduktan Hemen Sonra Ne Olur
- Test edilebilir bir servis için Arketic anında tek bir canlı denetim yapar ve Kimlik bilgisi doğrulandı — {servis} der. Denetim temiz dönmezse bağlantı yine de kaydedilir ve mesaj — Kaydedildi, ancak test sonucu … — sonucu söyler, böylece düzeltebilirsiniz.
- Otomatik denetimi olmayan bir servis içinse yalnızca Kimlik bilgisi oluşturuldu görürsünüz.
Eksik alanlar, hiçbir şey kaydedilmeden satır içinde işaretlenir (ör. Ad zorunludur).
:::tip Bağlantıları servise göre değil, işe göre adlandırın Servis başına birden fazla kimlik bilgisi saklayabilirsiniz. Bir blok içinde doğru olanı seçmek, ikisi de HubSpot adını taşıyan iki kayıt yerine Pazarlama HubSpot ve Destek HubSpot olduğunda çok daha kolaydır. :::
Sağlık: Neyin Hâlâ Çalıştığını Bilmek
Her bağlantı bir sağlık rozeti taşır; böylece ona bağlı bir iş akışının çalışıp çalışmayacağını bir bakışta görürsünüz.
| Rozet | Anlamı | Ne yapmalı |
|---|---|---|
| Bağlı | Çalışıyor | Bir şey yok |
| Geçersiz | Servis anahtarı veya token'ı reddetti | Anahtarı yeniden girin ya da hesabı yeniden bağlayın |
| İşlem gerekli | Saklanan kimlik bilgisinin süresi dolmuş | Yenilemek için yeniden bağlanın |
| Test edilmedi | Kaydedildi ama henüz denetlenmedi | Uygun bir zamanda Şimdi test et'i çalıştırın |
| Otomatik doğrulanamıyor | Bu servis otomatik denetim sunmuyor | İş akışını çalıştırarak çalıştığını doğrulayın |
Bir sorun olduğunda kart ve detay paneli, ham bir hata yerine sade dille bir gerekçe gösterir:
- Anahtar reddedildi (401) — yeniden girin
- Erişim reddedildi (403) — anahtarın yetkilerini kontrol edin
- Anahtarın biçimi hatalı görünüyor — fazladan boşluk olabilir
- Süresi doldu — yenilemek için tekrar bağlanın
- Sağlayıcı hatası (503) — testi tekrar deneyin
- Kimlik doğrulama başarısız — anahtarı yeniden girin
:::info Sağlık okunur, yeniden test edilmez Bağlantılar sekmesini açmak, her servise karşı canlı denetimler başlatmaz. Rozetler Arketic'in zaten bildiğini yansıtır. Bir şeyi bilerek yeniden denetlemek için o bağlantıda Şimdi test et'i kullanın. :::
Sağlık Özeti Şeridi
Rafların üstündeki tek satır durumunuzu özetler. Her şey yolundaysa yalnızca … bağlantının tamamı sağlıklı yazar. Aksi hâlde toplamı; kaçının sağlıklı, kaçının test edilmemiş ve kaçının ilgi beklediğine böler — bu son sayı tıklanabilir bir bağlantıdır.
- … tanesi ilgi bekliyor → bağlantısına tıklayın: her iki raf da yalnızca sorunlu bağlantılara göre filtrelenir.
- Filtre açıkken bir İlgi bekleyenler gösteriliyor rozeti belirir — hepsine dönmek için ona tıklayın.
İlgi bekleyen bağlantılar ayrıca varsayılan olarak rafın en üstüne sıralanır; böylece onları aramanız gerekmez.
Bir Bağlantı Kartını Okuma
Raftaki her kart şunları gösterir:
- Verdiğiniz ad, altında servis ve bağlantı türü (API anahtarı, OAuth hesabı, Bearer token veya Basic auth).
- Sağlık rozeti ve oturum açılmış bir hesap için ilk birkaç yetki kapsamı.
- Duruma göre değişen bir son satır: bir anahtar için Az önce test edildi, 5 dk önce test edildi, 2 sa önce test edildi, 3 gün önce test edildi veya Hiç test edilmedi, bir hesap için Bağlı.
- Bir sorun varsa gerekçe ve doğrudan kartın üzerinde tek tıklamalık Tekrar bağlan (hesap) veya Yeniden gir (anahtar) düğmesi.
Bir API kimlik bilgisi kartının üzerine geldiğinizde, hiçbir şey açmadan yeniden denetlemenizi sağlayan küçük bir Bağlantıyı test et düğmesi de belirir.
Detayları açmak için kartın başka bir yerine tıklayın.
Bir Raf Kalabalıklaşınca
Bir rafta sekizden fazla bağlantı olduğunda üstünde bir araç çubuğu belirir:
| Kontrol | İşlevi |
|---|---|
| Arama kutusu | O rafı bağlantı adına veya servise göre filtreler. Yer tutucusunda Bağlı hesaplarda ara… veya API kimlik bilgilerinde ara… yazar |
| Tümü / İlgi bekleyenler | Özet şeridindeki triyaj filtresinin aynısı |
| Sıralama açılır listesi | Sağlık (önce sorunlular, varsayılan), Yeni eklenen veya Ad A→Z |
Bir filtre geriye hiçbir şey bırakmazsa Filtrenizle eşleşen bağlantı yok. mesajını görürsünüz.
Bağlantı Detay Paneli
Detay panelini açmak için bir bağlantıya tıklayın. Kapatmak için Esc'e basın, arka plana tıklayın veya ×'i kullanın.
Sağlık
Sağlık rozeti, varsa sade dille gerekçe ve sorunu çözen aksiyon:
| Bağlantı türü | Düğme | Etkisi |
|---|---|---|
| API kimlik bilgisi | Şimdi test et | Tek bir canlı denetim yapar ve sonucu bildirir |
| İlgi bekleyen API kimlik bilgisi | Anahtarı yeniden gir | Yeni bir anahtar yapıştırabilmeniz için sır alanlarını yeniden açar |
| Bağlı hesap | Tekrar bağlan | Sağlayıcının oturum açma penceresini yeniden açar |
Altında, en son denetimin tarih ve saatiyle Son kontrol: yer alır.
Test sonuçları hemen bildirilir:
| Sonuç | Mesaj |
|---|---|
| Çalışıyor | Kimlik bilgisi geçerli. |
| Reddedildi | Sağlayıcı kimlik bilgisini reddetti. |
| Anlaşılamadı | Şu anda doğrulanamadı — daha sonra tekrar deneyin. |
| Denetim yok | Bu sağlayıcının test uç noktası yok. |
Kimlik
Kısa ve salt okunur bir özet: Sağlayıcı, Tür, (servis belirliyorsa) Bitiş veya Token bitişi, Eklendi tarihi ve oturum açılmış hesaplar için onayladığınız Yetki kapsamları. Alt nottaki kural yinelenir: Şifreli saklanır, yalnızca çalışma anında çözülür. Sır hiçbir zaman gösterilmez.
Tehlikeli Bölge
| Düğme | Onay | Sonuç |
|---|---|---|
| Kimlik bilgisini sil (API kimlik bilgisi) | Kimlik bilgisi silinsin mi? — ona işaret eden blokların, siz başka birini seçene kadar kimlik doğrulayamayacağı uyarısı. Sil ile onaylayın | Kimlik bilgisi silindi |
| Hesap bağlantısını kes (bağlı hesap) | Hesap bağlantısı kesilsin mi? — onu kullanan blokların, siz yeniden bağlanana kadar kimlik doğrulayamayacağı uyarısı. Bağlantıyı kes ile onaylayın | Hesap bağlantısı kesildi |
:::caution Bir bağlantıyı kaldırmak anında etkilidir Blokları ona işaret eden her iş akışı, bir sonraki çalıştırmadan itibaren kimlik doğrulayamaz. İş akışının çalışmaya devam etmesi gerekiyorsa önce o blokları başka bir bağlantıya yönlendirin. :::
Bir Blok İçinde Bağlantı Kullanma
Harici bir servise erişen bloklarda bir kimlik bilgisi alanı bulunur. Etiketi bloğa göre değişir: entegrasyon bloklarında ve API bloğunda Kimlik doğrulama, çoğu AI bloğunda Kimlik bilgisi, Ajan, Yönlendirici ve Değerlendirici bloklarında Sağlayıcı kimlik bilgisi, tetikleyicilerde ise özel bir ad — Bot token, Google hesabı, Posta kutusu hesabı gibi.
- Bloğun ayarlarını açın (bloğa çift tıklayın ya da üzerine geldiğinizde çıkan araç çubuğundaki Ayrıntıları aç'ı kullanın).
- Kimlik bilgisi açılır menüsünü açın. O servis için kullanabileceğiniz kayıtlı bağlantıları adlarıyla listeler — boş alanda Bir kimlik bilgisi seçin… yazar, hiç bağlantınız yoksa Tanımlı kimlik bilgisi yok der.
- Birini seçin ve bloğu kapatın.
İki kısayol size zaman kazandırır:
- Anahtar tabanlı servisler için açılır menünün altında bir Kimlik bilgisi ekle bağlantısı vardır. Aynı Yeni Kimlik Bilgisi penceresini açar ve oluşturulur oluşturulmaz yeni bağlantıyı sizin için seçer. Galeride kartı olmayan iki gizli değeri de bu yolla eklersiniz: Slack Tetikleyici'deki Slack Signing Secret ve WhatsApp Tetikleyici'deki Meta App Secret.
- Oturum açma tabanlı servisler için alan bunun yerine şunu hatırlatır: Bir hesabı İş Akışları → Bağlantılar altından bağlayın. — hesabı önce orada kurun, sonra buraya dönüp seçin.
:::tip Model blokları en yaygın istisnadır Ajan, Yönlendirici ve Değerlendirici bloklarında Model açılır menüsü, hiçbir bağlantı gerektirmeyen Arketic AI ile başlar. Harici bir yapay zekâ sağlayıcısının modelini kullanmak için önce Sağlayıcı kimlik bilgisi alanından o sağlayıcının bağlantısını seçin — modelleri bunun ardından Model listesinde görünür. :::
Bir Çalıştırma Durup Kimlik Bilgisi İsterse
Bir iş akışı çalışmaya başlayıp kimlik doğrulayamazsa, doğrudan başarısız olmak yerine duraklar. Editörde amber renkli bir bant Kimlik bilgisi gerekli — {servis} yazar ve ardından nedeni gösterir.
| Bağlantı | Bandın sunduğu | Ne yapmalı |
|---|---|---|
| Bir anahtar veya token | Anahtarı güncelle | Tıklayın, Kimlik Bilgisini Güncelle penceresinde anahtarı yeniden girin ve Güncelle'ye tıklayın. Çalıştırma kendiliğinden sürer ve kaldığı yerden devam eder |
| Çalıştırmanın tanıyamadığı bir anahtar (örneğin silinmiş bir anahtar) | Şu blokta bir kimlik bilgisi seçin: “blok”, sonra tekrar çalıştırın. — blok adı bir bağlantıdır | Bloğu açın, bir bağlantı seçin ve iş akışını yeniden çalıştırın |
| Bağlı bir hesap | Yeniden bağlanmanın bu banttan yapılamadığını söyleyen bir not | İş Akışları → Bağlantılar'a gidin, hesabı açıp Tekrar bağlan'ı kullanın, sonra iş akışını yeniden çalıştırın |
Tüm çalıştırma kontrolleri için İş Akışı Çalıştırma sayfasına bakın.
Nelere Bağlanabilirsiniz
Bir servis, bloğu olduğunda bağlanabilir. Aşağıda bulacağınız servisler, insanların genelde ne için kullandığına göre gruplanmıştır.
Oturum açarak (Hesap bağla):
| Hesap | Hizmet ettiği bloklar |
|---|---|
| Gmail, Gmail Tetikleyici, Google Sheets, Google Calendar, Google Drive, Google Docs, Google Tasks, Google Contacts, Google Forms, Google Slides, Google Groups, Google Meet, Google Vault, Google Ads, Google BigQuery | |
| Microsoft | Outlook, Outlook Tetikleyici, Microsoft Teams, Microsoft Excel, Microsoft Planner, OneDrive, SharePoint |
Bir anahtar veya token ile (Bağlantı ekle) — adlar galeri kartlarındaki adlardır:
| Grup | Servisler |
|---|---|
| Mesajlaşma ve e-posta | Slack, Telegram Bot, WhatsApp Cloud API, IMAP Mailbox, SMTP Server, Resend, SendGrid, Loops.so, Mailgun, Mailchimp |
| Anahtar kullanan Google servisleri | Google API Key — Google Maps, Google Translate, Google Books, Google PageSpeed ve YouTube için |
| Notlar ve bilgi | Notion, Obsidian |
| Geliştirme ve operasyon | GitHub, GitLab, Sentry, Linear, Asana, Vercel, Cloudflare, PagerDuty, incident.io, Rootly, LaunchDarkly, LangSmith, Tinybird |
| CRM, satış ve işe alım | HubSpot, Pipedrive, Attio, Intercom, Apollo, Hunter, LinkedIn, Greenhouse, Ashby, Rippling, DinamikCRM |
| Ödeme ve e-ticaret | Stripe, Shopify, RevenueCat |
| Yapay zekâ sağlayıcıları | OpenAI, Anthropic, Cohere, Mistral AI, Perplexity, Hugging Face, ElevenLabs, Replicate |
| Web arama ve araştırma | Tavily, Exa.ai, Jina AI, Firecrawl, Serper.dev, Linkup, Apify, Airweave, Brandfetch, Similarweb, Pulse |
| Toplantı ve planlama | Calendly, Fathom, Granola, Grain |
Aklınızdaki servisi galeride aratın. Çıkmıyorsa henüz bir iş akışı bloğu olarak sunulmuyor demektir; yöneticinize bildirin.
Bir Bağlantıyı Ekibinizle Paylaşma
Bir API kimlik bilgisi, birden fazla kişinin kendi anahtarına ihtiyaç duymadan aynı bağlantıyla iş akışı kurabilmesi için belirli ekip arkadaşlarınızla paylaşılabilir. Bağlantının detaylarını açın ve onu kullanabilecek kişileri ekleyin. Çıkardığınız kişi, o kimlik bilgisine bağlı blokları çalıştırma yetkisini anında kaybeder.
İyi Uygulamalar
- Anahtarlara ihtiyaç duyduğu en az yetkiyi verin. Anahtarı diğer serviste yalnızca iş akışınızın kullandığı izinlerle oluşturun. Sonradan Erişim reddedildi (403) ile reddedilen bir şey olursa ilk bakılacak yer o anahtarın izinleridir.
- Bağlantıları net adlandırın. Blok açılır menüsü yalnızca adı gösterir; dolayısıyla ad, doğru seçim yapmaya yetmelidir.
- İşlem gerekli ile canınız yanmadan ilgilenin. Gece çalışan zamanlanmış bir iş akışı size yeniden bağlanmanızı sormaz — sadece başarısız olur.
- Bir anahtarı değiştirdikten sonra test edin. Diğer serviste anahtarı yenilediğinizde burada Anahtarı yeniden gir'i kullanın ve ardından Şimdi test et'i çalıştırın; bir sonraki çalıştırmanın haber vermesini beklemeyin.
- Uyduğu yerde Arketic'in kendi bloklarını tercih edin. Bilgi bankası arama, görev aksiyonları ve bildirimler için bakımını yapacağınız hiçbir anahtar yoktur.
İlgili Sayfalar
- İş Akışı Oluşturma — bağlantının hizmet edeceği iş akışını kurun
- Bloklar — hangi bloklar bağlantı ister ve her biri ne yapar
- İş Akışı Çalıştırma — çalıştırma, duraklatma ve devam ettirme
- Kayıtlar — bir çalıştırma başarısız olduğunda adım adım ayrıntı
- İş Akışlarına Genel Bakış — İş Akışları sekmelerine bir bakış