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.

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

Bir sohbet kanalı bağladığınızda sağlayıcı her mesajı ve olayı Veyra'ya şu adresten gönderir:

HTTP
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

  1. 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.
  2. Yeni bir sohbet dizisi, uç noktanın agent'ı için bir görev olur; bir yanıt görevi sürdürür.
  3. 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.

GelenSohbet kanallarıWebhook'lar