AiHummer
Türkçe▾
Oturum açHesap
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
API/Gelen ve Entegrasyon Tetikleyicileri

Gelen ve Entegrasyon Tetikleyicileri

v1.1.x · güncellendi 2026-07-27

OpenAI ile uyumlu API’nin ötesinde, AiHummer kabul eder gelen mesajlar bağlayıcılardan ve otomasyon platformlarından gelir ve bir sunucu tarafı olay akışı abonelik yapabilirsiniz. Bu uç noktalar, harici sistemlerin iş yükünü geçide nasıl ilettiği ve kullanıcı arayüzlerinin nasıl canlı kaldığıdır.

Gelen uç noktaları

Gelen uç noktalar, kanal bağlayıcılarının ve özel entegrasyonların bir mesajı dönüş motoruna iletme şeklidir. Bunlar bir HMAC paylaşılan gizli anahtar gönderildi X-AIHummer-Inbound-Secret başlık (AIHUMMER_INBOUND_SECRET settings-catalog anahtarı — Yönetim → Ayarlar altında yönetici kullanıcı arayüzünde veya ile yapılandırılır aihummer settings set, -de değil gateway.env).

Yöntem & yol Amaç
POST /v1/inbound/telegram Yerel Telegram gelen yükleri
POST /v1/inbound/generic E-posta→webhook, cron ve özel uygulamalar için genel gelen
POST /v1/inbound/binding/status Kanal bağlama durumunu rapor et

genel endpoint, herhangi bir kaynağı AiHummer’a beslemenin en basit yoludur. Kanal adı, sabit bir dış tanımlayıcı ve mesaj metni ile küçük bir JSON gövdesi gönderin:

curl https://your-aihummer.example/v1/inbound/generic \
  -H "X-AIHummer-Inbound-Secret: $AIHUMMER_INBOUND_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "external_id": "ticket-4821",
    "text": "A customer asks whether order #4821 has shipped."
  }'

[!NOTE] Genel gelen gönderici varsayılan bir çalışma alanına ihtiyaç duyar. Ayarla AIHUMMER_DEFAULT_WORKSPACE_ID böylece gelen mesajlar yönlendirilebilir.

[!WARNING] Gelen uç noktalar bir tarafından korunmaz ah- API anahtarı — bunlar buna dayanır X-AIHummer-Inbound-Secret HMAC. Bu sırları istemci tarafı kodundan uzak tutun ve Sızdırıyorsa döndür.

Entegrasyon tetikleyicileri (Zapier / Make)

POST /v1/integrations/trigger düşük kodlu otomasyon platformları için giriş noktasıdır, örneğin Zapier ve Yap. Uç nokta varsayılan olarak devre dışı: -e kadar AIHUMMER_INBOUND_TRIGGER_SECRET ayar yapılandırıldığında yanıt verir 501 Not Implemented. Bu bir ayrı gizli, -den farklı AIHUMMER_INBOUND_SECRET; tıpkı her ayarlar-kataloğu anahtarı gibi, yönetici kullanıcı arayüzünde (Yönetim → Ayarlar) veya ile ayarlanır aihummer settings set.

Bir kez yapılandırıldığında, uç nokta ya birini kabul eder X-AIHummer-Signature HMAC veya şu biçimde bir Bearer belirteci Authorization: Bearer <the AIHUMMER_INBOUND_TRIGGER_SECRET value>.

curl https://your-aihummer.example/v1/integrations/trigger \
  -H "Authorization: Bearer $AIHUMMER_INBOUND_TRIGGER_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "zapier",
    "external_id": "lead-99",
    "text": "New lead captured from the contact form."
  }'

Admin Sessions arka ucu

Bu iki rota, Admin Sessions sayfası için korunan dahili taşıma katmanıdır. Müşteriye yönelik desteklenen gömülebilir bir kanal değildir.

Yöntem ve yol Amaç
POST /v1/web/session Bir Admin Sessions konuşması açın veya yeniden bağlayın
GET /v1/web/stream Konuşma yanıtını SSE ile akışa alın

Olay akışı

GET /v1/events/stream dır devam ettirilebilir Geçit olaylarının Sunucu Tarafından Gönderilen Olaylar beslemesi. Uç noktanın iki zorunlu gereksinimi vardır:

  1. ?workspace_id=<id> parametre zorunludur — onsuz talep ile reddedildi 400. Bir kiracı güvenlik görevlisi, çalışma alanının kime ait olduğunu doğrular arananın kiracısı; başka birine ait workspace_id verimler 403.
  2. Kimlik doğrulama gereklidir — bir yönetici oturumu (çerez) veya bir ah- API birini içeri almak Authorization: Bearer başlık. Onsuz yanıt 401.

Geç ?since= önceki bağlantının bıraktığı yerden devam etmek için imleç, böylece yeniden bağlanma hiçbir olay kaybetmez.

# Subscribe from the beginning
curl -N -H "Authorization: Bearer ah-..." \
  "https://your-aihummer.example/v1/events/stream?workspace_id=<id>"

# Resume after a known cursor
curl -N -H "Authorization: Bearer ah-..." \
  "https://your-aihummer.example/v1/events/stream?workspace_id=<id>&since=<cursor>"

[!TIP] Her olayın taşıdığı değeri bir sonraki olarak kabul edin since imleç. Açık yeniden bağlan, o imleçten tekrar oynat, en az bir kez teslimatı garantilemek için tüketici.

Sonraki durak neresi