Bitrix24 eklentisi

v1.0.x · güncellendi 2026-10-14

Bitrix24 eklentisi, temsilcinizi Bitrix24’e dahili bir çalışan anlık mesajlaşma kanalı olarak bağlar. Personel, ajansa bir meslektaşına mesaj atar gibi mesaj gönderir ve ajan Bitrix24 sohbeti içinde yanıt verir.

[!WARNING] İşte burada bir Bitrix24 var dahili çalışan anlık mesajlaşma kanalı — Telegram veya Slack gibi personel için. Bu değil müşteri çok kanallı: Açık Hat yok, hayır bilet kuyruğu ve operatör yükseltmesi yok. Bu eklentiyi öne çıkarmak için kullanmayın müşteri destek hattı.

Eklenti, ana bilgisayar yerelinde çalışır ve ağ geçidine üzerinden konuşur aihummer.connector.v1 sözleşme. Son kullanıcı kanal davranışı kanal sayfasında Bitrix24; bu sayfa eklentinin kendisini kapsar.

Aşağıdaki medya ve ortak OAuth davranışı, imzalı Core 1.4.15 ve katalogda ayrı yayımlanıp güncellenmiş, imzalı 1.1.1 bağlayıcısını gerektirir. Kurulu 1.1.0 bu özelliklerin mevcut olduğunu doğrulamaz.

Gerçekler

Alan	Değer
Sürüm	1.1.1
Liman	8810
Çalışma zamanı	ana bilgisayar-tabanlı

Ne olduğu

Bitrix24 sohbet ile AiHummer arasında iki yönlü bir köprü. Temsilci olarak görünür insana benzer kimlik Bitrix24’te — her ajan, genel bir bot hesabı yerine kendi OAuth kimliğiyle kimlik doğrulaması yapar — böylece konuşmalar bir meslektaşla konuşuyormuş gibi hissedilir. Erişim, organizasyonun kurallarına uygundur departman ağacı ACL, bu nedenle bir ajanın erişimi Bitrix24 yapınıza saygı gösterir.

Özel portal kullanıcılarını BITRIX24_AGENT_USER_IDS, portalı BITRIX24_PORTAL ile ayarlayın. Departman yönlendirmesi çalışan erişimini sınırlar; ajan hesabı görevi başlatan kişinin yerini almaz. İsteğe bağlı mevcut otomatik hazırlama BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD kullanır.

Belirtilen sürümlerde BITRIX24_VAULT_CONNECTIONS, sahibine ait mevcut, geçerli, özerk OAuth kimlik bilgisini seçer. Desteklenen yerel kasa/bağlantı yönetimini kullanın; aynı kimlik bilgisi ID’sini araç bağlamalarında kullanın. Gerçek sahibi, çalışan bağlayıcıyı çalışma alanında özel connection-token anahtarıyla /v1/admin/connections/channel üzerinden kaydeder. Ajan kullanıcı ID’sine göre endpoint ve apiKey değerlerini gizli BITRIX24_VAULT_CONNECTIONS ayarına koyun, ajan profillerine veya istemlere değil. Tokenleri yalnızca kasa yeniler; araçlar başlatan kişi ve paylaşımı kontrol eder. Bkz. OAuth2.

Nasıl kullanılır

Gelen: yoklayıcı mesajları okur. Medya bayt olarak indirilip /v1/inbound/media üzerinden kaydedilir; ajan yalnızca URL veya dosya bilgisi değil, media_id alır.
Giden: Deliver Markdown’u BB-code’a çevirir ve gerçek baytları im.v2.File.upload üzerinden yükler. Medya onayı gerçek FILE_ID ve mesaj ID’leri gerektirir; metin veya bağlantı dosya makbuzu değildir.

Güncellemelerde kalıcı teslimat günlüğünü koruyun. Onaylanmış işlemin tekrarı önceki makbuzu döndürür. Kısmi veya bilinmeyen etkiler otomatik yeniden gönderilmez; tekrar denemeden önce kontrol edin.

employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

Desteklenen özellikler

Tepkiler ve @-bahsetmeler.
Hesap ve sağlayıcı im.dialog.writing ile REPLY_ID desteklediğinde yazma göstergesi ve yanıtlar.
Yukarıdaki sürüm gereksinimleriyle gelen görüntüler, ses, konuşma ve dosyalar.
Mesaj düzenleme/silme yalnızca ayrı bot kimliği olan eski entegrasyonlarda; normal OAuth kullanıcıları için duyurulmaz.

Sınırlar

[!WARNING] Etkileşimli klavyeler, düğmeler ve konu dizileri desteklenmez.

Üretilmiş veya hazırlanmış dosya onaylanmış teslimat değildir. Kısmi, başarısız ve bilinmeyen sonuçlar görünür kalmalıdır.

Kurulum

Yönetici kullanıcı arayüzünden pazaryerinden Bitrix24’ü tek tıklamayla kurun. Sunucu-yerel dağıtıcı eklentiyi indirir, kurulum adımını çalıştırır, bir sandbox’lı systemd birimi oluşturur ve hazır olarak işaretlemeden önce sağlık durumunu bekler — bakınız Kurulum ve güncellemeler. Daha sonra her ajanın OAuth kimliğini bağlar ve departman ağacı ACL’sini haritalarsınız.

Güvenlik ve sınırlar

Sadece dahili çalışan IM — müşteri çok kanallı değil.
Ajan başına insan benzeri OAuth kimliği — ajanlar genel bot hesapları değildir.
Bölüm-ağacı ACL — reach, organizasyon yapınıza saygı gösterir.
Host-yerel — bir konteyner içinde değil, systemd altında çalışır.