Genel gelen
Genel gelen, AiHummer’a evrensel giriş noktasıdır. Kaynağınız için özel olarak oluşturulmuş bir kanal olmadığında — bir e-posta-Webhook aktarımı, bir cron işi, dahili bir araç — mesajı tek bir uç noktaya gönderirsiniz ve bu mesaj, diğer kanal mesajları gibi dönüş motoruna girer.
Uç nokta
Tek bir JSON gönder POST geçide doğru:
POST /v1/inbound/generic
Content-Type: application/json
X-AIHummer-Inbound-Secret: <hmac>
{
"channel": "my-app",
"external_id": "user-42",
"text": "Hello from my custom integration"
}
Gövde üç alan taşır:
channel— kaynağa seçtiğiniz mantıksal bir kanal adı.external_id— son kullanıcı veya konuşma için sabit bir tanımlayıcı.text— mesaj içeriği.
Kimlik doğrulama
Uç nokta tarafından güvence altına alınmıştır HMAC içinde taşındı X-AIHummer-Inbound-Secret başlık, paylaşılanlardan türetilmiş AIHUMMER_INBOUND_SECRET. Geçerli bir imzası olmayan istekler reddedilir, bu nedenle yalnızca sırrı elinde bulunduran çağıranlar mesaj gönderebilir.
[!NOTE] Geçitin varsayılan bir çalışma alanı yapılandırılmış olmalıdır (
AIHUMMER_DEFAULT_WORKSPACE_ID) genel gelen mesajları göndermek için.
Ek kanal konektörleri
AiHummer ek kanal bağlayıcıları sunar. Her biri Marketplace’ten yüklenir, kendi portunda ana bilgisayar yerel olarak çalışır ve gelen mesajları iletir /v1/inbound/generic.
| Bağlayıcı | Liman | Notlar |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Matris | 8803 | |
| Sinyal | 8804 | gerektirir signal-cli yan araba |
| Microsoft Teams | 8805 | |
| E-posta (IMAP/SMTP) | 8806 | |
| WhatsApp Bulut API | 8807 |
[!NOTE] Bağlayıcılar Market’ten yüklenir; bazıları ek bir hizmet gerektirir (örneğin,
signal-cliSignal için).
Tarayıcı uzantısı
AiHummer ayrıca bir tarayıcı uzantısı da gönderir, bir Manifest V3 yan panel sohbet yüzeyi. Bu bir müvekkili /v1/chat/completions kişisel kullanarak ah- API anahtarı — sunucu tarafı kanalı değil. Bunu yönlendirme için gelen bir kaynak olarak kullanmak yerine kişisel, tarayıcı içi sohbet için kullanın.
Sonra nereye?
- Üretim sohbeti için bakınız Telegram ve MAKS.
- Personel IM için, bkz. Bitrix24.
- API’ye karşı mı inşa ediyorsunuz? Bakın sohbet/tamamlamalar.