Solavel Belgeler
Türkçe

Entegrasyonlar

Son güncelleme

Projenin Entegrasyonlar sekmesi bir projeyi diğer sistemlere bağlar:

  • Giden webhook'lar, proje olaylarını (görev oluşturma, sprint başlatma, belge oluşturma…) size ait HTTPS uç noktasına gönderir; alıcının güvenebilmesi için imzalanırlar.
  • Gelen webhook belirteçleri, harici bir sistemin (form aracı, GitHub, betik) projede görev veya yorum oluşturmasını sağlar.
  • Herkese Açık API belirteçleri, başka sisteme SolaProjects API'si üzerinden proje görevleri ve zamanında kapsamı sınırlı okuma veya yazma erişimi verir.
  • Yerel sağlayıcı hazırlığı, hazır bağlantıları (Slack, Microsoft Teams, GitHub, GitLab, Google Calendar, Google Drive, OneDrive, Zapier / IFTTT) ve her birinin bağlanabilir olup olmadığını gösterir.

Projenin başka araçla iletişim kurması gerektiğinde kullanın; örneğin görev güncellemelerini müşteri paneline göndermek veya web sitesi sorularını görevlere çevirmek. Proje yöneticileri ve idarecileri kurar; genellikle BT irtibatınızla proje başına bir kez yapılır.

İki sayfa Entegrasyonlar adını taşır. Bu sayfa proje sekmesini kapsar. Kenar çubuğunun Çalışma Alanı bölümündeki Entegrasyonlar öğesi (/projects/settings/integrations), kuruluşun SolaCount bağlantısıdır — aşağıdaki Kuruluş SolaCount bağlantısı ile Bütçe ve finans sayfasına bakın.

#Nerede bulunur?

Yan çubuk Proje bölümü → Entegrasyonlar (Otomasyonlar ile AI arasında)
URL /projects/{project}/integrations
Komut paleti Entegrasyonlar · {project name}, Geçerli proje altında

Kim görür:

  • Plan: entegrasyonlar Premium plan özelliğidir (Enterprise da kapsar). Alt planlarda sekme gizlidir. Ücretli planın süresi dolarsa sekme kaybolur ve yenileyene kadar webhooklar sunulmaz.
  • Rol: sekmeyi yalnızca projeyi düzenleyebilenler yükleyebilir (bkz. İzinler). Diğerleri "Entegrasyonlar yüklenemedi." ve Yeniden dene görür.

#Ekran turu

#Üst bilgi kartı

Entegrasyonlar — Giden webhook'lar, gelen belirteçler ve teslim geçmişi.

Kutucuk Anlamı
Giden Aktif giden webhook'lar.
Gelen belirteçler Aktif, iptal edilmemiş gelen belirteçler.
Son teslimatlar Son teslimatlar bölümünde listelenen teslimat denemeleri.
Başarısız teslimatlar Bunların arasındaki başarısız denemeler (sıfırdan büyükse kırmızı).

#Giden webhook'lar kartı

Proje olaylarını HMAC-SHA256 imzasıyla harici HTTPS uç noktasına POST olarak gönderin. Sağ üstte Yeni webhook bulunur.

Her webhook kartı ad, uç nokta URL'si, bir durum rozeti (Etkin, Devre dışı veya Arşivlendi), abone olunan her olay için bir etiket ve {n} teslimat · {n} başarısız bilgisini gösterir. Satır işlemleri (arşivlenmiş webhook'larda yok): Düzenle, Test, Gizli anahtarı döndür, Arşivle.

Boş durum: Giden webhook yok — Harici sisteme olay göndermek için bir tane oluşturun.

#Gelen webhook belirteçleri kartı

Harici sistemlerin gizli belirteçle POST göndererek görev/yorum oluşturmasına izin verin. Sağ üstte Yeni belirteç bulunur.

Her belirteç kartı: ad, sağlayıcı (Özel veya GitHub) · son kullanım {date} veya hiç kullanılmadı, Etkin, Etkin Değil veya İptal Edildi rozeti. Eylemler (iptal edilmiş belirteçlerde yok): Yenile, İptal et.

Boş durum: Gelen jeton yok — Gelen webhook'ları kabul etmek için bir jeton oluşturun.

#Herkese açık API kartı

Belgelenmiş proje, görev ve zaman kaydı uç noktaları için kapsamı sınırlı taşıyıcı belirteçler oluşturun. Düğmeler: Dokümantasyon (OpenAPI başvurusunu yeni sekmede açar) ve Yeni belirteç.

Her belirteç kartında: ad, son kullanım {date} / hiç kullanılmadı, durum rozeti ve her yetenek için bir etiket bulunur. İşlemler: Yenile, İptal et.

Boş durum: API jetonu yok — Genel API için bir jeton oluşturun.

#Son teslimatlar kartı

Giden teslimat denemeleri ve sonuçları. Sayıyla birlikte rozet.

Sütun Anlamı
Ne zaman Teslimat tarihi.
Web kancası Webhook adı veya Arşivlenmiş webhook.
Olay Olay türü, örn. task.status_changed.
Durum Teslim edildi (yeşil), Beklemede (sarı, bekliyor veya yeniden deneniyor), Başarısız (kırmızı), Atlandı.
Denemeler SolaProjects kaç kez denedi.
Yanıt Uç noktanızın döndürdüğü HTTP durum kodu; yanıt alınmadığında hata veya —.
(düğme) Teslim edilmemiş her teslimat için Yeniden dene kullanın.

Boş durum: Henüz iletim yok — Bir olay tetiklendiğinde veya test gönderdiğinizde iletim denemeleri burada görünür.

#Yerel sağlayıcı hazırlık kartı

Sağlayıcıya özel entegrasyonların bağlantı durumu ve kurulum ön koşulları. Her sağlayıcı için bir kart:

Sağlayıcı Ne işe yarar
Slack Proje bildirimlerini Slack adresine gönderin ve Slack üzerinden görev komutları alın.
Microsoft Teams Proje bildirimlerini Teams kanallarına gönderin ve Teams eylemlerini destekleyin.
GitHub Depo olaylarını, sorunları, çekme isteklerini ve commit'leri proje görevlerine bağlayın.
GitLab GitLab birleştirme isteklerini, sorunlarını ve işlem hattı olaylarını proje görevlerine bağlayın.
Google Calendar Proje kilometre taşlarını ve görev tarihlerini Google Calendar ile senkronize edin.
Google Drive Proje dokümanlarını Google Drive klasörleri ile ekleyin veya senkronize edin.
OneDrive Proje dokümanlarını OneDrive klasörleri ile ekleyin veya senkronize edin.
Zapier / IFTTT SolaProjects tetikleyicilerini ve eylemlerini kodsuz platformlara açın.

Her kutucuk bir durum (Kullanılabilir, Bekliyor, Etkin, Başarısız), yetenek ve Canlı sağlayıcı yapılandırması algılandı. veya Yerel simülatör kullanılabilir; üretim kimlik bilgileri etkinleştirme ayarlarıdır. gösterir (sağlayıcı kuruluşunuz için henüz canlı değildir). Ayrıca Eksik kurulum nedeniyle engellendi: …, Etkinleştirme notları: …, OAuth geri çağrısı bekleniyor., Son hata: …, son mesaj veya alınan son olay gösterilebilir.

#Gönderebileceğiniz olaylar

Webhook formunda bir veya daha fazlasını işaretleyin:

Olay Gönderilme zamanı
task.created Bir görev oluşturulur (gelen webhook'tan olanlar dahil).
task.updated Bir görev düzenlenir.
task.status_changed Bir görevin durumu değişir.
task.completed Bir görev tamamlandı olarak işaretlenir.
task.blocked Bir görev engellenmiş olarak işaretlenir.
comment.created Bir görev yorumu eklenir.
doc.created Bir proje belgesi oluşturulur.
time_entry.created Zaman kaydedildi.
milestone.completed Bir kilometre taşı tamamlandı.
sprint.started / sprint.completed Bir sprint başlar / tamamlanır.
share_link.created Misafir paylaşım bağlantısı oluşturulur.
automation.run_failed / automation.rule_failed Bir otomasyon çalışması başarısız olur.
ai.suggestion_applied Bir yapay zeka önerisi uygulandı.

Her istek, X-SolaProjects-Event (olay türü), X-SolaProjects-Delivery (teslim kimliği), X-SolaProjects-Signature (imzalama sırrınızla ham gövdenin HMAC-SHA256 değeri) ve User-Agent: SolaProjects-Webhooks/1.0 başlıklarını içeren bir JSON POST isteğidir. Bir isteğe güvenmeden önce imzasını doğrulayın.

Yeniden denemeler. Başarısız teslimat yaklaşık 1, 5, 15 ve 60 dakika sonra otomatik yeniden denenir; beşinci denemeden sonra Başarısız kalır. Elle yeniden denemek için Yeniden dene kullanın.

#Görevler

#Giden bir webhook oluşturun

  1. Projeyi açın → Entegrasyonlar → Yeni webhook.

  2. Yeni giden webhook alanlarını doldurun:

    Alan Gerekli Kurallar / varsayılanlar Notlar
    Ad Evet En fazla 160 karakter. örn. Müşteri kontrol paneli.
    Uç nokta URL'si (HTTPS) Evet Geçerli URL, en fazla 2.048 karakter, herkese açık HTTPS. Yer tutucu https://example.com/hooks/solaprojects. Yerel ve özel ağ adresleri reddedilir: "Herkese açık HTTPS uç noktası kullanın. Yerel ve özel ağ URL'leri engellenir."
    Olaylar Evet En az bir. Yukarıdaki tabloya bakın.
    Aktif — Varsayılan olarak işaretli. Kaydederken Devre dışı olarak kaydetmek için işareti kaldırın.
  3. Oluştur düğmesine tıklayın. Giden web kancası oluşturuldu. mesajını ve İmzalama sırrı iletişim kutusunu görürsünüz: “Bunu şimdi saklayın — yalnızca bir kez gösterilir ve sonra alınamaz.” Kopyala (Panoya kopyalandı.) düğmesine tıklayın, sırrı alıcı sistemde saklayın, ardından Tamam.

#Bir webhook'u düzenleyin, test edin, döndürün ve arşivleyin

Eylem Adımlar Sonuç
Düzenle Adı, URL'yi, etkinlikleri veya Etkin → Kaydet seçeneğini değiştirin. Giden webhook güncellendi.
Test Test seçeneğine tıklayın. Test teslimatı kuyruğa alındı. Son teslimatlar içinde bir satır görünür.
Gizli anahtarı döndür Gizli anahtarı yenile işlemini onaylayın — "Mevcut gizli anahtar artık çalışmayacak. Bağlı hizmetleri yeni gizli anahtarla güncelleyin." Gizli anahtar yenilendi. ve yeni gizli anahtar bir kez gösterilir.
Arşivle Webhook'u arşivle işlemini onaylayın — "Bu giden webhook artık proje olaylarını iletmeyecek." Webhook arşivlendi. Arşivlendi rozeti; artık teslimat yapılmaz; geçmiş korunur.

#Gelen webhook belirteci oluşturun

  1. Gelen webhook belirteçleri bölümünde Yeni belirteç düğmesine tıklayın.
  2. Ad (zorunlu, en fazla 160 karakter) ve Sağlayıcı: Özel (varsayılan) veya GitHub.
  3. Oluştur → Gelen belirteç oluşturuldu. seçin. Bir kez gösterilen Gelen webhook belirtecini kopyalayın: "Bunu gelen webhook URL'nizde belirteç olarak kullanın. Yalnızca bir kez gösterilir."

Harici sistem daha sonra JSON gövdesiyle POST /api/projects/webhooks/incoming/{token} gönderir (gönderen başına dakikada 60 istek sınırı):

Sağlayıcı Gövde Ne olur
Özel {"title": "...", "description": "...", "priority": "high"} Yapılacak durumunda özel görev oluşturur (varsayılan öncelik medium; başlık 180 karakterle sınırlanır). Yanıtta yeni task_key bulunur.
Özel {"task_key": "ALN-14", "comment": "..."} Bu göreve dahili bir yorum ekler.
GitHub Sorun veya sorun yorumu olayı İş kaydı göreve dönüşür; başlığında görev anahtarı (ör. ALN-14) olan iş kaydındaki yorum, o görevin yorumu olur.

Diğer her şey "Webhook reddedildi." mesajıyla reddedilir; iptal edilmiş veya yanlış belirteç de aynı yanıtı alır. Görevlerin ve yorumların yazarı, belirteci oluşturan kişidir.

Yenile, yeni erişim belirteci oluşturur ve eskisini hemen iptal eder (Belirteç yenilendi.). İptal et, Belirteci iptal et onayını sorar: "Bu belirteci kullanan istekler artık erişemeyecek." → Belirteç iptal edildi.

#Genel bir API token'ı oluşturun

  1. Genel API bölümünde Yeni belirteç düğmesine tıklayın.

  2. Ad (zorunlu, en fazla 120 karakter) ve Yetenekler (en az bir; projects:read, tasks:read, time:read önceden işaretlidir):

    Yetenek İzin verilenler
    projects:read Bu projeyi okuyun.
    tasks:read / tasks:write Görevleri okuma / oluşturma ve güncelleme.
    time:read / time:write Zaman girişlerini okuma / oluşturma.
  3. Oluştur → API belirteci oluşturuldu. Proje API belirtecini kopyalayın: "Bunu /api/v1 için Bearer belirteci olarak kullanın. Yalnızca bir kez gösterilir."

API üzerinden oluşturulan görevler, uygulamada oluşturulanlarla aynı otomasyonları ve web kancalarını tetikler. Yenile → Tokenı yenile onayı (“Mevcut token çalışmayı durduracak. Bağlı hizmetleri yeni tokenla güncelleyin.”) → API tokenı yenilendi. İptal et → API tokenı iptal edildi.

#Başarısız bir teslimatı yeniden deneyin

Son iletimler bölümünde satırdaki Yeniden dene düğmesine tıklayın → İletim yeniden denendi. Biraz sonra Durum ve Yanıt alanlarını kontrol edin.

#Yerel bir sağlayıcıya bağlanın

  1. Sağlayıcı kartında kanalı seçin (örneğin Slack için #projects) ve Bağlan düğmesine tıklayın → {Provider} bağlantısı başlatıldı.
  2. {Provider} yetkilendirmesi iletişim kutusunu Geri çağrıyı tamamla (veya Sonra) ile tamamlayın → Yerleşik entegrasyon bağlandı.
  3. Bağlandıktan sonra Test gönder ({Provider} test mesajı gönderildi.), Yenile ({Provider} yenilendi.) veya Bağlantıyı kes ({Provider} bağlantısı kesildi.) kullanın.

Simülatör modundaki kartlar, sağlayıcı canlıya geçmeden kurulumu kontrol etmek için Olayı simüle et ve Hata da gösterir; gerçek hizmete bağlanmazlar.

#Durumlar

Nesne Durumlar
Giden webhook Aktif, Devre dışı (Aktif işareti kaldırılarak kaydedildi), Arşivlendi
Teslimat Bekliyor, Teslim edildi, Başarısız, Atlandı
Gelen / API belirteci Aktif, Pasif, İptal edildi
Yerel sağlayıcı Mevcut, Beklemede, Etkin, Başarısız

#İzinler

Rol Sekmeyi açın Webhook'ları, token'ları, sağlayıcıları oluştur / değiştir
Kuruluş sahibi Evet Evet
Projeler Yöneticisi Evet Evet
Burada proje Yöneticisi olan Projeler Yöneticisi Evet Evet
Projeler Üyesi, proje Görüntüleyicisi, misafirler Hayır Hayır

Kuruluşunuzda entegrasyon düzenleme kapatılmışsa sekme salt okunurdur (Yeni, satır işlemleri veya Yeniden dene yoktur). Reddedilen değişiklikte "Entegrasyon düzenlemeleri devre dışı veya buna izin verilmiyor."; güncelliğini yitirmiş sayfada "Lütfen sayfayı yenileyip tekrar deneyin." görünür. Gizli anahtarlar ve belirteçler tek seferlik iletişim kutusundan sonra sahipler için bile yeniden gösterilmez.

#Kuruluş SolaCount bağlantısı

Çalışma Alanı kenar çubuğundaki Entegrasyonlar (/projects/settings/integrations) farklı bir sayfadır. SolaProjects’in SolaCount’a bağlı olup olmadığını gösterir (Bağlı, Bağlanmaya hazır, Entegrasyon duraklatıldı, Bağlantı kesildi — geçmiş korundu, …); kuruluş sahibi veya Finans yöneticisinin bağlanmasına, duraklatmasına, bağlantıyı kesmesine ya da kontrol etmesine izin verir. Tek bir proje Ayarlar sekmesinden kapsam dışında kalabilir (Entegrasyonlar kartı → İç proje / finans devre dışı). Bütçe ve finans ile SolaProjects genel bakışı sayfalarına bakın.

#Uygulamalı örnekler

#Örnek 1 — Talepler göreve dönüşür (günlük)

{User 1 name}, {Showroom project name} (DEMO-FIT) için web sitesi taleplerinin görev olarak gelmesini ister.

  1. Yeni belirteç → Ad Website enquiries, Sağlayıcı Özel → Oluştur; belirteci web geliştiricisine verir.
  2. Web sitesi {"title": "Quote request – reception desk", "priority": "high"} deftere işler.
  3. ALN-31 Quote request – reception desk görevi Yapılacak durumunda, özel ve Yüksek öncelikli olarak görünür. Belirteç kartında son kullanım 6 Ekim yazar.

#Örnek 2 — Bir hatayla birlikte müşteri panosu akışı (tam senaryo)

{User 2 name}, {Organization name}'nin site panosunu bağlar.

Adım Eylem Sonuç
1 Yeni webhook: Saha paneli, https://hooks.company.example.com/projects, olaylar task.status_changed, task.completed, milestone.completed. Giden webhook oluşturuldu. İmzalama sırrı panoya kopyalandı.
2 Test. Test teslimatı kuyruğa alındı.; satır Teslim edildi, Yanıt 200.
3 {User 1 name} ALN-12'yi Tamamlandı sütununa taşır. İki teslimat: task.status_changed ve task.completed, ikisi de Teslim edildi.
4 Gösterge paneli bakım nedeniyle kullanılamıyor. Sonraki teslimat Beklemede, ardından Yanıt 503 ile Başarısız gösterir; başlıkta kırmızı Başarısız teslimatlar 1 bulunur. Yaklaşık 1, 5, 15, 60 dakika sonra yeniden denenir.
5 Kontrol paneline dön; {User 2 name} Yeniden dene düğmesine tıklar. Teslimat yeniden denendi. → Teslim edildi.
6 BT, gizli anahtarın sızdırıldığından şüpheleniyor. {User 2 name} Anahtarı yenile seçeneğine tıklar ve onaylar. Gizli anahtar yenilendi.; yeni gizli anahtar bir kez gösterilir; BT paneli günceller.

#Bağlantı nasıl kurulur

Yer Bağlantı
Görevler Gelen belirteçler ve API görev ve yorum oluşturur; görev değişiklikleri olay gönderir.
Planlama Kilometre taşı tamamlanması ile sprint başlatma/tamamlama olayları gönderir.
Otomasyonlar SolaProjects içinde çalıştırın; başarısız çalıştırmalar olay olarak gönderilebilir.
Misafir paylaşım bağlantıları share_link.created olayı.
Yapay Zeka ai.suggestion_applied olayı.
Zaman takibi time_entry.created olayı; zaman API yetenekleri.
Ayarlar Proje bazında SolaCount finans anahtarı.

#İpuçları ve yaygın sorunlar

Sorun Neden Çözüm
Sekme eksik. Plan Premium'un altında veya süresi dolmuş. Yükseltin veya yenileyin.
Herkese açık bir HTTPS uç noktası kullanın… URL http, localhost veya özel bir adres olabilir. Herkese açık bir HTTPS URL'si kullanın.
Bir gizli anahtarı veya token'ı kaybettiniz. Yalnızca bir kez gösterilir. Döndür ve diğer sistemi güncelleyin.
4xx koduyla Başarısız olan teslimatlar. Uç noktanız isteği reddediyor (genellikle imza kontrolü). Uç noktanın geçerli gizli anahtarı kullandığını kontrol edin.
Webhook reddedildi. gelen çağrılarda. İptal edilmiş/hatalı belirteç veya gövdede title ya da task_key + comment yok. Token ve gövdeyi kontrol edin.
Yorum GitHub'dan eklenmedi. Sorun başlığında görev anahtarı yok. Anahtarı (örn. ALN-14) sorun başlığına yazın.
API erişimi reddedildi döndürür. Belirteçte yetki yok veya iptal edilmiş. Uygun yetkilerle bir belirteç oluşturun.
Sağlayıcı şunu diyor: Yerel simülatör kullanılabilir… Kuruluşunuz için henüz canlı değil. Etkinleştirme için Solavel desteğine başvurun.