API Hook’lar – Mavi Masa ile Dış Sistemler Arasında Akıcı Entegrasyon
DestekMaviMasa, hem “gelen” hem de “giden” API destekleri aracılığıyla sistemlerinizle doğrudan entegre çalışabilir. Bu özellik, Mavi Masa’nın esnekliğini ve ölçeklenebilirliğini önemli ölçüde artırır.
🔗 API Hook Nedir?
API Hook’lar, Mavi Masa’da gerçekleşen bir olayı takip edip, otomatik olarak dış sistemlere HTTP isteği göndermek için kullanılan bir mekanizmadır.
📌 “Giden” API (Outbound API): Mavi Masa’nın kendi içinde bir olay meydana geldiğinde, dış uygulamaları bilgilendirmek için otomatik HTTP isteği gönderir.
📌 “Gelen” API (Inbound API): Dış sistemlerin Mavi Masa’ya yeni bir bilet oluşturmak, yanıt eklemek, bilet atamak veya kapatmak için doğrudan erişim sağlayabileceği RESTful web servis sistemidir.
🔧 Nasıl Çalışır?
Mavi Masa, belirli olaylara yanıt verecek şekilde ayarlanmış otomasyon kuralları ile dış uygulamalara veri gönderebilir.
Örnek senaryolar:
- Yeni bir bilet oluşturulduğunda, Slack kanalına bilgi gönder.
- Yüksek öncelikli bir bilet açıldığında, Discord webhooks’una bildirim at.
- Biletler, RSS beslemesine otomatik eklenir.
- Biletler bir iç sistem (in-house app)’e POST edilir.
✅ Herhangi bir HTTP API’ye bağlantısı olabilecek sistem, Mavi Masa ile entegre edilebilir.
🔐 Gerekli ise, kimlik doğrulama bilgileri (örneğin: API anahtarı, JWT, Basic Auth) de eklenir.
▶️ Ayar Nasıl Yapılır?
Mavi Masa’da bir API hook’u şu adımlarla tanımlayabilirsiniz:
- Yönetim Paneli → Otomasyon Kuralları bölümüne gedin.
- Yeni bir “Kural” oluşturun.
- Tetikleyici olarak “Bilet oluşturuluyor” seçin.
- Koşul olarak: “Bilet önceliği – Yüksek” gibi filtreleyin.
- Eylem olarak: “HTTP isteği gönder (POST)” seçin.
- Hedef URL’yi belirtin: http://myapp/api/sendmessage?text=new+ticket
- Gerekirse oturum açma bilgileri veya başlık alanı ile içerik doğrulaması yapın.
🌟 Örnek: Discord Webhook ile Entegrasyon
| Özellik | Değer |
|---|---|
| İstek Türü | POST |
| URL | https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN |
| Gönderilen Veri (JSON) | “` |
| { | |
| “content”: “🚨 Yeni yüksek öncelikli bilet oluşturuldu: #url#” | |
| } |
> ✅ **#url#** gibi **kısayollar** (replacement masks), otomatik olarak bilet bağlantısına dönüştürülür. > 📌 Diğer yaygın kısayollar: `#subject#`, `#priority#`, `#ticketId#`, `#userEmail#`, `#assignee#` --- ## 🛠️ Test ve Hata Ayıklama İçin Öneriler Eğer aldırmak istediğiniz dış sistem API’si ile entegrasyonu test etmek istiyorsanız: > 📌 **Postman**, **Yaak** veya **Insomnia** gibi REST istemcilerini kullanın. > 📌 Önce API endpoint’ine manuel bir POST/GET isteği gönderin ve yanıtı test edin. > 📌 İstek işe yarar hâle gelince, Mavi Masa’daki otomasyon kuralına aynı ayarları kopyalayın. > ✅ Bu yöntem, hem zaman kazandırır hem de hata tespiti sürecini basitleştirir. --- ## 💡 Özetle: > 🔹 **API Hook’lar**, Mavi Masa’nın dış sistemlere “düşük kodlu, yüksek etkili” entegrasyon imkanı tanır. > 🔹 **Yüksek öncelikli biletler**, **Slack**, **Discord**, **RSS** veya **iç sistemler** ile **anında bilgilendirilir.** > 🔹 **Yalnızca HTTP isteği göndermekle kalmaz, aynı zamanda verileri filtreleyebilir ve özelleştirebilirsiniz.** --- > ✅ **Sistemleriniz birbiriyle konuşsun.** > 🔄 **Mavi Masa, sadece bir bilet sistemi değil; destek ekibinizin birleşim merkezidir.** > 📌 Artık bir tek bir sistem düşünmeyin — tüm ekip araçlarını bir araya getirin. > 🔗 **API Hook’lar, bu bağlamı gerçekleştiren en güçlü anahtardır.**