Sohbet sağlayıcısı webhook'ları
Slack, Microsoft Teams, Discord, Telegram ve GitHub'ın mesajları Veyra'ya nasıl ilettiği, her teslimatın nasıl doğrulandığı ve geçerli limitler.
Bir sohbet kanalı bağladığınızda sağlayıcı her mesajı ve olayı Veyra'ya şu adresten gönderir:
POST https://intelligence-api.veyra.so/api/chat-webhooks/{publicId}/{provider}provider; slack, microsoft-teams, discord, telegram ya da github değerlerinden biridir. publicId uç noktanızı tanımlar; konsol kurulum sırasında tam adresi doldurur, siz de onu sağlayıcının uygulama ayarlarına yapıştırırsınız.
Doğrulama
Veyra her teslimatı okumadan önce sağlayıcının kendi mekanizmasıyla doğrular:
| Sağlayıcı | Doğrulama yöntemi |
|---|---|
| Slack | Uygulamanın imzalama sırrı (X-Slack-Signature ve X-Slack-Request-Timestamp). |
| Microsoft Teams | İstekteki Bot Framework token'ı. |
| Discord | Uygulamanın açık anahtarı (Ed25519 imza başlıkları). |
| Telegram | Webhook kaydedilirken ayarlanan gizli token. |
| GitHub | GitHub App'in webhook sırrı (X-Hub-Signature-256). |
Doğrulamadan geçemeyen bir teslimat reddedilir ve içindeki hiçbir şey okunmaz. Doğrulama sırlarını kurulum sırasında bir kişi girer, asla bir agent girmez.
Limitler
Her uç nokta kaynak adres başına dakikada 600 isteğe kadar kabul eder. Yanıtlar X-RateLimit-Limit ve X-RateLimit-Remaining taşır; limit aşılınca Veyra Retry-After ile 429 döndürür ve sağlayıcılar kendi takvimlerine göre yeniden dener.
Yanıtlar
Veyra her sağlayıcının beklediği biçimde yanıt verir (örneğin Slack'in URL doğrulama sınaması ya da Discord'un etkileşim onayı). Desteklenmeyen ya da kendi rotası olan (e-posta, ses) bir sağlayıcı 400 alır.
Teslimat ve yeniden denemeler
Sağlayıcılar başarısız teslimatları yeniden dener. Veyra tekrarları sağlayıcının olay ya da teslimat kimliğinden tanır; böylece bir yeniden deneme asla ikinci bir görev ya da yanıt oluşturmaz.
Bir mesaja ne olur
- Gönderenin kimliği bağlı bir Veyra üyesiyle eşleştirilir. Bağlı olmayan gönderenler, kim olduklarını doğrulamaları için bir bağlantı alır.
- Yeni bir sohbet dizisi, uç noktanın agent'ı için bir görev olur; bir yanıt görevi sürdürür.
- Agent'ın yanıtı aynı diziye geri gönderilir.
Uç nokta yönetimi için API referansındaki Sohbet kanalları bölümüne bakın.