Webhook'lara genel bakış
Veyra Intelligence'ın aldığı ve gönderdiği her webhook (rutin tetikleyicileri, sohbet sağlayıcıları, GitHub, e-posta, ses, eklentiler ve HTTP agent uyandırmaları) ve her birinin kimliğinin nasıl doğrulandığı.
Webhook'lar, olayları yoklamaya gerek kalmadan Veyra ile diğer sistemler arasında taşır. Bazıları gelir (sisteminiz ya da bir sağlayıcı Veyra'ya bir şey olduğunu söyler); biri gider (Veyra, sizin sunucularınızda çalışan bir agent'ı uyandırır).
Gelen
| Webhook | Adres | Kimlik doğrulama | Ne için kullanılır |
|---|---|---|---|
| Rutin tetikleyicisi | POST /api/routine-triggers/public/{publicId}/fire |
Bearer sırrı, HMAC imzası ya da sağlayıcı imzası | Bir rutini sistemlerinizden, alarmlardan ya da CI'dan başlatmak. |
| Sohbet sağlayıcıları | POST /api/chat-webhooks/{publicId}/{provider} |
Sağlayıcının kendi imzası | Slack, Teams, Discord, Telegram ve GitHub'ın agent'larla konuşmasını sağlamak. |
| GitHub pull request incelemeleri | Sohbet sağlayıcısı ya da rutin tetikleyicisi | GitHub imzası ya da bearer sırrı | Pull request'leri agent'lara inceletmek. |
| E-posta | POST /api/chat-webhooks/agentmail/{publicId} |
Svix imzası | Bir agent'ın gelen kutusu için e-posta almak. |
| Ses | POST /api/voice-webhooks/{publicId}/events ve /tools |
Ses sağlayıcısının imzası | Agent'larla telefon görüşmeleri. |
| Eklenti webhook'ları | POST /api/plugins/{pluginId}/webhooks/{endpointKey} |
Eklentinin tanımladığı şekilde | Bir eklentiye olay iletmek. |
Gelen tüm webhook'lar https://intelligence-api.veyra.so adresine gönderilir. Bir webhook kurduğunuzda konsol, publicId dahil tam adresi gösterir. Adresi gizli tutun: bazı modlarda sırrın bir parçasıdır.
Giden
| Webhook | Gönderildiği yer | Ne için kullanılır |
|---|---|---|
| Agent uyandırmaları | Bir HTTP agent'ının çalışma ortamı ayarlarındaki URL | Bir agent'ın işini kendi sunucularınızda çalıştırmak. |
Hepsi için geçerli kurallar
- Yalnızca HTTPS. Düz HTTP kabul edilmez.
- İmzalar ham gövde üzerinde denetlenir. İmzalama ile gönderme arasında JSON'u yeniden serileştirmeyin.
- Yükler veridir. Bir webhook'tan gelen içerik agent'lara talimat olarak değil, her zaman veri olarak işaretlenmiş şekilde ulaşır.
- Yeniden denemeler güvenlidir; yeter ki sabit bir idempotency anahtarı gönderin (rutin tetikleyicileri) ya da sağlayıcı kendi teslimat kimliğini eklesin (GitHub, Svix). Tekrarlar tanınır ve iki kez çalıştırılmaz.
- Her teslimat kaydedilir; kabul edilsin ya da reddedilsin, ait olduğu organizasyonun aktivite günlüğüne yazılır.