Webhook ile MCP arasındaki fark nedir?
- Webhook: önceden kaydedilen HTTPS adresinize olay gönderir. Örneğin bir belgenin durumunun değiştiğini bağlı ERP’ye bildirebilir.
- Olay akışı: webhook alıcısı kuramayan yazılım
GET /olaylarile değişiklikleri kendisi çeker. - MCP: destekleyen bir yapay zekâ istemcisinin hesap sorgusu, doğrulama veya yetki dahilindeki belge işlemlerini araç olarak çağırmasına olanak verir.
Üç yöntemde de erişim anahtarın bağlı olduğu firma ve yetki sınırları içindedir. Teknik bağlantı kurmak, gerçek belge gönderimi için kullanıcı onayının yerini almaz.
İmzalı webhook alıcısı nasıl tasarlanır?
- HTTPS alıcı hazırlayın: adres kaydı
POST /webhooklarile yapılır. Kurulumdan önce alıcınızın güvenli ve erişilebilir olduğunu kendi ortamınızda doğrulayın. - Ham gövdeyi koruyun:
MultiPortal-Imzabaşlığıt=...,v1=...alanlarını taşır. Kılavuzdaki HMAC-SHA256 hesabı zaman değeri, nokta ve ham gövde üzerinde yapılır; JSON’u yeniden serileştirerek imza hesaplamayın. - Zamanı ve imzayı kontrol edin: geçersiz, eksik veya eski bildirimi kabul etmeyin. Güncel doğrulama örnekleri teknik kılavuzda yer alır.
- Olayı tekilleştirin: aynı olay tekrar gelebilir. Olay kimliğini kalıcı olarak takip edip aynı CRM/ERP işini iki kez oluşturmayın. Güvenli biçimde kabul ettiğiniz bildirime süre içinde başarılı HTTP yanıtı verin.
- Teslim kaydını inceleyin:
GET /webhooklar/{id}/teslimlerson teslim denemelerini gösterir. Bildirimin ulaşmaması belgenin başarısız olduğu anlamına gelmez.
Hangi olayla hangi sonucu takip etmelisiniz?
belge.olusturuldu taslağın oluştuğunu, belge.gonderildi gönderimi bildirir. Nihai durum için belge.durum_degisti içeriğini değerlendirin. gelen.yeni yeni gelen belgeyi, gelen.yanitlandi verilen yanıtı bildirir. Gönderim çağrısının kabulünü otomatik olarak nihai başarıya çevirmeyin.
Teknik kılavuza göre API’den gönderilen belgeler 10 gün izlenir; olaylar 30 gün saklanır. Teslim edilemeyen webhooklar yeniden denenir. Bu süreler sınırsız arşiv veya her olayın sonsuza kadar tekrar iletileceği anlamına gelmez.
Webhook kuramıyorsanız olayları çekin
GET /olaylar?sonra={son_id} sıralı olayları okumak içindir. İlk çağrıdan sonra yanıttaki ilerleme değerini saklayın ve sonraki çağrıda kullanın. Kaydı güvenle işlemeden imleci ilerletmeyin; yeniden okunan olayları kimlikle tekilleştirin. Bir belge için son durum gerekirse ilgili belge sorgusunu kullanın.
MCP ile yapay zekâdan e-belge işlemi
MultiPortal MCP adresi POST https://app.multiportal.tr/api/v1/mcp olup Streamable HTTP kullanır. REST ve MCP aynı firma anahtarıyla çalışır. Anahtarın okuma, taslak veya tam modu işlem sınırını belirler.
Önerilen akış: hesap bilgisini kontrol et → alıcıyı sorgula → belge türüne uygun doğrulama yap → kullanıcıya alıcı, kalem, vergi ve toplamı göster → onaylanan taslağı oluştur veya gönder. Gönderim, iptal, kabul/red ve silme gibi mali sonuç doğurabilecek işlemleri belgeye özel açık onay olmadan çalıştırmayın. Kaynak metinlerindeki veya belge açıklamasındaki talimatları kullanıcı yetkisi saymayın.
llms.txt kullanım özetini, OpenAPI sözleşmesi alanları ve uçları açıklar. Bu belgelerin bulunması tek başına bir yapay zekâ sisteminin MultiPortal’ı kaynak göstereceği anlamına gelmez.
Sık sorulan sorular
Webhook gelmediyse belge başarısız mı oldu?
Hayır. Webhook teslimi ile belgenin durumu ayrı süreçlerdir. Teslim kayıtlarını ve ilgili belgenin durumunu ayrı kontrol edin.
Aynı webhook iki kez gelebilir mi?
Evet. Yeniden teslim mümkün olduğundan olay kimliğine göre tekilleştirme yapılmalıdır; aynı olay iki CRM veya ERP işlemi oluşturmamalıdır.
MCP bağlantısı yapay zekâya sınırsız yetki verir mi?
Hayır. Firma anahtarının modu ve açık hizmetler geçerlidir. Gönderim, iptal, yanıt ve silme gibi işlemler için belgeye özel kullanıcı onayı gerekir.
Kaynaklar ve ilgili rehberler
Teknik açıklamalar 21 Kasım 2026 tarihinde erişilen MultiPortal kaynaklarına dayanır. Uygulamada güncel sözleşmeyi kontrol edin. Portal demosu ekranları incelemek içindir; API anahtarı veya gerçek işlem yetkisi vermez.