Bağlantılar
Birçok workflow block'u başka bir servise erişir — Slack, Gmail, Google Sheets, Notion, bir AI sağlayıcısı vb. Bir block bunu yapabilmeden önce, sizin adınıza oturum açma iznine ihtiyaç duyar.
Bağlantı (connection) işte bu saklanmış izindir. Bağlantıyı Connections merkezinde bir kez kurarsınız, sonra ihtiyaç duyan her block'un içinde açılır menüden seçersiniz. Sırlar şifreli olarak saklanır ve yalnızca bir workflow ç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 |
|---|---|---|---|
| Connected account | Açılan pencereden servise oturum açar ve erişimi onaylarsınız | Connected accounts | Google, Microsoft, Atlassian |
| API credential | Servisin size verdiği anahtarı veya token'ı yapıştırırsınız | API credentials | OpenAI, Slack, Notion, Stripe, Tavily |
Kaydedildikten sonra ikisi de aynı şekilde çalışır: block yalnızca bağlantıyı adıyla seçer.
:::info Arketic'in kendi adımları bağlantı gerektirmez Arketic içinde kalan block'lar — bilgi bankası arama, belge arama, Arketic web araması, 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 block Arketic dışına çıktığında ihtiyaç duyarsınız. :::
Connections merkezini açma
Workflows → Connections'a gidin.
Merkez 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 buton — Connect account ve Add connection.
- "Bozuk bir şey var mı?" sorusuna bir bakışta yanıt veren bir sağlık özeti şeridi.
- İki raf — Connected accounts ve API credentials — her bağlantı için birer kart taşır.
Henüz hiçbir şey kurmadıysanız No connections yet başlığını, "Connect an account or add an API key so your workflow blocks can reach the services they automate." mesajını ve hemen altında iki butonu görürsünüz.
Her rafın kendi boş durum ipucu da vardır:
| Raf | Boşken görünen ipucu |
|---|---|
| Connected accounts | No connected accounts. Use "Connect account" for OAuth services like Google. |
| API credentials | No API keys yet. Add one for services that authenticate with a key or token. |
Hesap bağlama (oturum açma)
Bunu, anahtar yapıştırmak yerine oturum açtığınız servisler için kullanın.
- Connect account'a 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 Account connected. mesajını görürsünüz. Yeni hesap Connected accounts rafında belirir.
Oturum açabileceğiniz sağlayıcılar
| Sağlayıcı | Durum |
|---|---|
| Kullanılabilir | |
| Microsoft | Kullanılabilir |
| Atlassian | Kullanılabilir — Confluence ve Jira'yı kapsar |
| Slack | Soon rozeti — henüz seçilemiyor |
| GitHub | Soon rozeti — henüz seçilemiyor |
Soon işaretli sağlayıcılar, çalışmayacak bir buton yerine soluk ve Coming soon ipucuyla gösterilir.
:::caution Açılır pencere açılmazsa Tarayıcınız engelliyor olabilir — Popup blocked — allow popups and try again. 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. Pencereyi tamamlamadan kapatırsanız Arketic yalnızca Connection was cancelled. der ve hiçbir şey kaydedilmez. :::
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.
- Add connection'a tıklayın. Add a connection galerisi açılır ve arama kutusu doğrudan odaklanmış gelir.
- Yazarak daraltın — yer tutucu şunu önerir: Search connections… (e.g. 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ı |
|---|---|
| Key · testable | Bir anahtar yapıştırın — Arketic bunu otomatik denetleyebilir |
| Key | Bir anahtar yapıştırın — bu servis otomatik denetim sunmuyor |
| Connect · soon | Yalnızca oturum açmayla çalışan servis, burada henüz kullanılamıyor (kart devre dışıdır ve Connect-only provider — coming soon ipucunu gösterir) |
:::info Bazı servisler neden galeride yok Galeri, workflow block'larınızın gerçekten kullanabileceği servisleri listeler. Bir şey arayıp No provider matches "…" görüyorsanız, onun için henüz bir block yok demektir. :::
New Credential penceresi
Bir servis seçtiğinizde New Credential açılır:
| Alan | Notlar |
|---|---|
| Provider | Pencereyi, servisini zaten bilen bir block'tan açtıysanız önceden dolu ve gizlidir |
| Name | Zorunlu. Bu bağlantı için kendi etiketiniz — ör. My OpenAI key. 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 |
Create'e tıklayın (çalışırken Creating… gösterir) veya vazgeçmek için Cancel'a basın.
Create'ten hemen sonra ne olur
- Testable bir servis için Arketic anında tek bir canlı denetim yapar ve Credential verified — {servis} der. Denetim temiz dönmezse bağlantı yine de kaydedilir ve mesaj sonucu söyler, böylece düzeltebilirsiniz.
- Otomatik denetimi olmayan bir servis içinse yalnızca Credential created görürsünüz.
Eksik alanlar, hiçbir şey kaydedilmeden satır içinde işaretlenir (ör. Name is required).
:::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 block 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 workflow'un çalışıp çalışmayacağını bir bakışta görürsünüz.
| Rozet | Anlamı | Ne yapmalı |
|---|---|---|
| Connected | Çalışıyor | Bir şey yok |
| Invalid | Servis anahtarı veya token'ı reddetti | Anahtarı yeniden girin ya da hesabı yeniden bağlayın |
| Action needed | Saklanan kimlik bilgisinin süresi dolmuş | Yenilemek için yeniden bağlanın |
| Not tested | Kaydedildi ama henüz denetlenmedi | Uygun bir zamanda Test now çalıştırın |
| Can't auto-verify | Bu servis otomatik denetim sunmuyor | Workflow'u ç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:
- Key rejected (401) — re-enter it
- Access denied (403) — check the key's permissions
- Key format looks wrong — check for stray spaces
- Expired — reconnect to refresh
- Provider error (5xx) — try testing again
- Authentication failed — re-enter the key
:::info Sağlık okunur, yeniden test edilmez Connections 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 Test now kullanın. :::
Sağlık özeti şeridi
Rafların üstündeki tek satır durumunuzu özetler. Her şey yolundaysa yalnızca All … connections healthy yazar. Aksi hâlde toplamı; kaçının sağlıklı, kaçının denetlenmemiş ve kaçının ilgi bekliyor olduğuna böler — bu son sayı tıklanabilir bir bağlantıdır.
- … need(s) attention → bağlantısına tıklayın: her iki raf da yalnızca sorunlu bağlantılara göre filtrelenir.
- Filtre açıkken bir Showing needs attention 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 key, OAuth account, Bearer token veya Basic auth).
- Sağlık rozeti ve oturum açılmış bir hesap için ilk birkaç erişim kapsamı (scope).
- Duruma göre değişen bir son satır: bir anahtar için Tested 5m ago / Never tested, bir hesap için Connected / Expires in 3d.
- Bir sorun varsa gerekçe ve doğrudan kartın üzerinde tek tıklamalık Reconnect (hesap) veya Re-enter (anahtar) butonu.
Bir API credential kartının üzerine geldiğinizde, hiçbir şey açmadan yeniden denetlemenizi sağlayan küçük bir Test connection butonu da belirir.
Detayları açmak için kartın başka bir yerine tıklayın.
Bir raf kalabalıklaşınca
Bir rafta birkaç bağlantıdan fazlası olduğunda üstünde bir araç çubuğu belirir:
| Kontrol | İşlevi |
|---|---|
| Arama kutusu | O rafı bağlantı adına veya servise göre filtreler |
| All / Needs attention | Özet şeridindeki triyaj filtresinin aynısı |
| Sıralama | Health (önce sorunlular, varsayılan), Recently added veya Name A→Z |
Bir filtre geriye hiçbir şey bırakmazsa No connections match your filter. 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.
Health
Sağlık rozeti, varsa sade dille gerekçe ve sorunu çözen aksiyon:
| Bağlantı türü | Buton | Etkisi |
|---|---|---|
| API credential | Test now | Tek bir canlı denetim yapar ve sonucu bildirir |
| İlgi bekleyen API credential | Re-enter key | Yeni bir anahtar yapıştırabilmeniz için sır alanlarını yeniden açar |
| Connected account | Reconnect | Sağlayıcının oturum açma penceresini yeniden açar |
Altında, en son denetimin tarih ve saatiyle Last checked yer alır.
Test sonuçları hemen bildirilir:
| Sonuç | Mesaj |
|---|---|
| Çalışıyor | Credential is valid. |
| Reddedildi | Provider rejected the credential. |
| Anlaşılamadı | Could not verify right now — try again later. |
| Denetim yok | This provider has no test endpoint. |
Identity
Kısa ve salt okunur bir özet: Provider, Type, (servis belirliyorsa) son kullanma bilgisi, Added tarihi ve oturum açılmış hesaplar için onayladığınız Scopes. Alt nottaki kural yinelenir: Encrypted at rest, decrypted only at run time. The secret is never shown.
Danger zone
| Buton | Onay | Sonuç |
|---|---|---|
| Delete credential (API credential) | Delete credential? — ona işaret eden block'ların, siz başka birini seçene kadar kimlik doğrulayamayacağı uyarısı | Credential deleted |
| Disconnect account (connected account) | Disconnect account? — onu kullanan block'ların, siz yeniden bağlanana kadar kimlik doğrulayamayacağı uyarısı | Account disconnected |
:::caution Bir bağlantıyı kaldırmak anında etkilidir Block'ları ona işaret eden her workflow, bir sonraki çalışmadan itibaren kimlik doğrulayamaz. Workflow'un çalışmaya devam etmesi gerekiyorsa önce o block'ları başka bir bağlantıya yönlendirin. :::
Bir block içinde bağlantı kullanma
Harici bir servise erişen block'larda bir kimlik bilgisi alanı bulunur — block'a göre Authentication veya Credential olarak etiketlenir.
- Block'un ayarlarını açın (block'a çift tıklayın ya da üzerine geldiğinizde çıkan tepsideki Open details'i kullanın).
- Kimlik bilgisi açılır menüsünü açın. O servis için kayıtlı bağlantılarınızı adlarıyla listeler — boş istem Select a credential… yazar, hiç bağlantınız yoksa No credentials configured der.
- Birini seçin ve block'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 + Add credential bağlantısı vardır. Servisi önceden seçilmiş hâlde aynı New Credential penceresini açar ve oluşturulur oluşturulmaz yeni bağlantıyı sizin için seçer.
- Oturum açma tabanlı servisler için alan bunun yerine şunu hatırlatır: Connect an account under Workflows → Connections — hesabı önce orada kurun, sonra buraya dönüp seçin.
:::tip Model block'ları en yaygın istisnadır Agent, Router ve Evaluator block'larında Model açılır menüsü, hiçbir bağlantı gerektirmeyen Arketic AI'ya varsayılan gelir. Orada yalnızca harici bir AI sağlayıcısının modeline geçerseniz kimlik bilgisine ihtiyacınız olur. :::
Bir çalışma durup kimlik bilgisi isterse
Bir workflow çalışmaya başlayıp kimlik doğrulayamazsa, doğrudan başarısız olmak yerine duraklar. Editörde amber renkli bir bant Credential required — {servis} yazar ve anahtar tabanlı servisler için bir Update key aksiyonu sunar: anahtarı satır içinde yeniden girin, sonra çalışmayı Resume edin; kaldığı yerden devam eder. Oturum açılmış hesaplar içinse hesabı yeniden bağlayın ve block'ta yeniden seçin.
Tüm çalışma kontrolleri için Workflow Çalıştırma sayfasına bakın.
Nelere bağlanabilirsiniz
Galeri geniş bir servis yelpazesini kapsar. Aşağıda, insanların genelde ne için kullandığına göre gruplanmış birkaç örnek var:
| Grup | Servisler |
|---|---|
| Mesajlaşma & e-posta | Slack, Discord, Telegram, WhatsApp, Microsoft Teams, Gmail, Outlook, SMTP, IMAP, Resend, SendGrid, Loops, Twilio, Mailgun, Mailchimp, Postmark |
| Belgeler & üretkenlik | Notion, Google Sheets, Google Docs, Google Drive, Google Calendar, Google Slides, Google Forms, Google Tasks, Google Contacts, Microsoft Excel, OneDrive, SharePoint, Airtable, Coda, Confluence, Obsidian |
| Geliştirme & issue takibi | GitHub, GitLab, Bitbucket, Jira, Jira Service Management, Linear, Asana, ClickUp, Monday, Trello, Azure DevOps, Jenkins, CircleCI, Sentry |
| CRM & satış | HubSpot, Pipedrive, Attio, Salesforce, Intercom, Apollo, Hunter |
| Ödeme & e-ticaret | Stripe, Shopify, Square |
| AI sağlayıcıları | OpenAI, Anthropic, Perplexity, Mistral, Cohere, HuggingFace, ElevenLabs, Replicate |
| Web arama & araştırma | Tavily, Exa, Jina, Firecrawl, Serper, Linkup, Perplexity, DuckDuckGo, Wikipedia, arXiv, Apify |
| Planlama | Calendly, Cal.com |
| Altyapı & analitik | Cloudflare, DigitalOcean, PagerDuty, Opsgenie, Datadog, Segment, PostHog, Mixpanel, Amplitude |
Liste büyümeye devam ediyor — aklınızdaki servisi galeride aratın.
İyi uygulamalar
- Anahtarlara ihtiyaç duyduğu en az yetkiyi verin. Anahtarı diğer serviste yalnızca workflow'unuzun kullandığı izinlerle oluşturun. Sonradan Access denied (403) ile reddedilen bir şey olursa ilk bakılacak yer o anahtarın izinleridir.
- Bağlantıları net adlandırın. Block açılır menüsü yalnızca adı gösterir; dolayısıyla ad, doğru seçim yapmaya yetmelidir.
- Action needed ile canınız yanmadan ilgilenin. Gece çalışan zamanlanmış bir workflow 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 Re-enter key kullanın ve ardından Test now çalıştırın; bir sonraki çalışmanın haber vermesini beklemeyin.
- Uyduğu yerde Arketic'in kendi block'ları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
- Workflow Oluşturma — bağlantının hizmet edeceği workflow'u kurun
- Block'lar — hangi block'lar bağlantı ister ve her biri ne yapar
- Workflow Çalıştırma — çalıştırma, duraklatma ve devam ettirme
- Loglar — bir çalışma başarısız olduğunda adım adım detay
- Workflow'lara Genel Bakış — Workflows sekmelerine bir bakış