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ığı.

Veyra Docs TeamGüncellendi 1 dk okumaSürüm 2 · Geçmiş

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.
Webhook'lar