Entegrasyonlara Genel Bakış
Hedef Kitle: Admin, Geliştirici, Strateji Yöneticisi
Sayfa Türü: Referans + Nasıl Yapılır
Entegrasyon Yaklaşımı
COS, açık bir platform olarak tasarlanmıştır. COS'u mevcut sistemlerinizle şu yollarla bağlayabilirsiniz:
- REST API — COS verilerine tam programatik erişim
- CSV İçe/Dışa Aktarma — KPI'lar, kullanıcılar ve kaynaklar için yapılandırılmış veri alışverişi
- Webhook Bildirimleri (planlanan) — COS'ta bir şey gerçekleştiğinde harici sistemlere olay bildirimi gönderme
REST API
COS, harici sistemlerin veri okuyup yazmasına olanak tanıyan bir REST API sunar. Yaygın kullanım senaryoları:
| Kullanım Senaryosu | Açıklama |
|---|---|
| KPI verisi aktarma | İş zekası araçlarınızdan veya veri ambarınızdan COS KPI ölçümlerine metrik değerleri gönderin |
| OKR senkronizasyonu | OKR ilerleme verilerini yönetici panolarına veya raporlama araçlarına aktarın |
| Kullanıcı provizyon | Kullanıcıları İK sisteminizden veya kimlik sağlayıcınızdan senkronize edin |
| Onay otomasyonu | Harici iş akışı araçlarından onay akışlarını tetikleyin |
API ile başlamak için:
- Admin → API Anahtarları bölümünden API anahtarı alın
- Tüm istekler Bearer token kimlik doğrulaması kullanır
- Temel URL:
https://tenant-adiniz.cos.app/api/v1
Uç nokta referansı → API Genel Bakış
CSV İçe / Dışa Aktarma
Teknik olmayan ekipler için COS, CSV dosyaları aracılığıyla yapılandırılmış veri alışverişini destekler.
KPI Ölçümlerini İçe Aktarma
CSV ile KPI Kütüphanesi'ne KPI ölçüm değerlerini toplu içe aktarabilirsiniz:
- Kütüphane → KPI / IPF yolunu izleyin
- Güncellemek istediğiniz KPI'yı açın
- Ölçümleri İçe Aktar düğmesine tıklayın
- CSV şablonunu indirin (içerir: tarih, değer, notlar)
- Ölçüm verilerinizi doldurun
- Yükleyin ve onaylayın
OKR Verilerini Dışa Aktarma
OKR ilerlemesini sunumlarda veya harici raporlamada kullanmak için dışa aktarın:
- OKR → Kontrol Merkezi yolunu izleyin
- Gerekli filtreleri uygulayın (döngü, birim, durum)
- Dışa Aktar → Excel / CSV düğmesine tıklayın
BSC Verilerini Dışa Aktarma
- BSC görünümünüze gidin
- Skorkartı Excel formatında indirmek için Dışa Aktar düğmesine tıklayın
Planlanan Entegrasyonlar
Aşağıdaki entegrasyonlar COS yol haritasında yer almaktadır:
| Sistem | Tür | Durum |
|---|---|---|
| Slack | Bildirim iletimi — OKR check-in hatırlatıcıları, onay uyarıları | Planlandı |
| Microsoft Teams | Bildirim iletimi | Planlandı |
| Google Sheets | KPI ölçüm senkronizasyonu (çift yönlü) | Planlandı |
| Jira / Linear | İnisiyatif/görev takip senkronizasyonu | Planlandı |
| Salesforce | CRM KPI senkronizasyonu (gelir, boru hattı metrikleri) | Planlandı |
| İK sistemleri (BambooHR, Workday) | Kullanıcı provizyon senkronizasyonu | Planlandı |
Entegrasyon talebinde bulunmak veya öncelikleri oylamak için support@cos.app ile iletişime geçin.
Webhook Bildirimleri (Yakında)
Webhook'lar, COS'un gerçek zamanlı olay bildirimlerini harici sistemlere iletmesine olanak tanıyacak.
Planlanan olaylar:
okr.submitted— OKR onay için gönderildiokr.approved/okr.rejected— Onay kararı verildicheckin.created— Yeni check-in gönderildicycle.completed— OKR döngüsü kapatıldı
Webhook uç noktaları Admin → Entegrasyonlar → Webhook'lar ekranından yapılandırılabilecek.
Güvenlik Değerlendirmeleri
Tüm entegrasyonlar HTTPS üzerinden iletişim kurar. API anahtarları:
- Hizmet bazında kapsamlandırılır (kullanıcı bazında değil)
- Admin → API Anahtarları ekranından istediğiniz zaman iptal edilebilir
- Kaynak kod depolarına eklenmemeli — ortam değişkenlerini kullanın