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
-
Projeyi açın → Entegrasyonlar → Yeni webhook.
-
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. -
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
- Gelen webhook belirteçleri bölümünde Yeni belirteç düğmesine tıklayın.
- Ad (zorunlu, en fazla 160 karakter) ve Sağlayıcı: Özel (varsayılan) veya GitHub.
- 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
-
Genel API bölümünde Yeni belirteç düğmesine tıklayın.
-
Ad (zorunlu, en fazla 120 karakter) ve Yetenekler (en az bir;
projects:read,tasks:read,time:readönceden işaretlidir):Yetenek İzin verilenler projects:readBu projeyi okuyun. tasks:read/tasks:writeGörevleri okuma / oluşturma ve güncelleme. time:read/time:writeZaman girişlerini okuma / oluşturma. -
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
- 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ı.
- {Provider} yetkilendirmesi iletişim kutusunu Geri çağrıyı tamamla (veya Sonra) ile tamamlayın → Yerleşik entegrasyon bağlandı.
- 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.
- Yeni belirteç → Ad Website enquiries, Sağlayıcı Özel → Oluştur; belirteci web geliştiricisine verir.
- Web sitesi
{"title": "Quote request – reception desk", "priority": "high"}deftere işler. - 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. |