Bitrix24 Plugin

v1.2.x · aktualisiert 2026-07-05

Das Bitrix24-Plugin verbindet Ihren Agenten mit Bitrix24 als internen Instant-Messaging-Kanal für Mitarbeiter. Mitarbeiter senden dem Agenten Nachrichten auf die gleiche Weise, wie sie einem Kollegen Nachrichten senden würden, und der Agent antwortet im Chat von Bitrix24.

[!WARNING] Bitrix24 hier ist ein interner Mitarbeiter-IM-Kanal — wie Telegram oder Slack für Mitarbeiter. Es ist nicht Kunden-Omnichannel: Es gibt keine offenen Leitungen, nein Ticket-Warteschlange und keine Eskalation an den Operator. Verwenden Sie dieses Plugin nicht, um eine Front zu betreiben Kundendienst-Hotline.

Das Plugin läuft host-nativ und kommuniziert über das Gateway aihummer.connector.v1 Vertrag. Das Verhalten des Endbenutzerkanals befindet sich auf der Kanalseite Bitrix24; diese Seite behandelt das Plugin selbst.

Fakten

Feld	Wert
Version	1.0.0
Port	8810
Laufzeit	Host-nativ

Was es ist

Eine zweiseitige Brücke zwischen dem Bitrix24-Chat und AiHummer. Der Agent erscheint als menschenähnliche Identität in Bitrix24 — jeder Agent authentifiziert sich mit seiner eigenen OAuth-Identität anstelle eines generischen Bot-Kontos — sodass sich Gespräche anfühlen, als würde man mit einem Kollegen sprechen. Der Zugriff folgt den Richtlinien der Organisation Abteilungsbaum-ACL, sodass die Reichweite eines Agenten Ihre Bitrix24-Struktur respektiert.

Neben OAuth-Identitäten werden andere Bereitstellungspfade unterstützt: automatische Erstellung von Agentenkonten über ein Portal-Administrator-Login (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) und Bindung an vorab erstellte Bitrix24-Benutzer durch feste IDs (BITRIX24_AGENT_USER_IDS).

Wie es verwendet wird

Eingehend: Ein Pull-Poller holt neue Nachrichten ab und leitet sie weiter an die Generischer eingehender Endpunkt des Gateways, an dem der Router den Zielagenten auflöst.
Ausgehend: Antworten werden über die idempotente Schnittstelle des Connectors gesendet Liefern Schritt, der das Markdown des Agenten in Bitrix24 umwandelt BB-Code und garantiert, dass eine Nachricht nicht zweimal gesendet wird.

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

Unterstützte Funktionen

Das Plugin unterstützt reichhaltiges, menschenähnliches Chat-Verhalten:

Reaktionen
Nachricht bearbeiten und löschen
Eingabeindikatoren
@-Erwähnungen
Medien

Grenzen

[!WARNING] Das menschenähnliche Modell handelt absichtlich nicht einige Bitrix24-Bots einbeziehen Merkmale:

Keine interaktiven Tastaturen / Tasten und Keine Threads.

Eingehende Medien und Sprache werden nicht weitergeleitet — eingehend ist nur Text. A Kollegenstil-Identität empfängt und beantwortet Text; Anhänge und Stimme Notizen, die an den Agenten gesendet werden, werden nicht in einen Turn weitergeleitet.

Installation

Installieren Sie Bitrix24 mit einem Klick aus dem Marketplace in der Admin-Oberfläche. Der hosteigene Deployer lädt das Plugin herunter, führt seinen Installationsschritt aus, rendert eine isolierte systemd-Einheit und wartet auf den Gesundheitszustand, bevor er es als bereit markiert – siehe Installation & Updates. Sie verbinden dann die OAuth-Identität jedes Agents und ordnen die Abteilungsbaum-ACL zu.

Sicherheit und Grenzen

Nur interne Mitarbeiter-IM — nicht kundenorientiert über alle Kanäle.
Agentenweise menschenähnliche OAuth-Identität — Agenten sind keine generischen Bot-Konten.
Abteilungsbaum-ACL — Reach respektiert Ihre Organisationsstruktur.
Idempotente Lieferung — Markdown wird in BB-Code umgewandelt und niemals zweimal gesendet.
Nur Text eingehend; keine Tastaturen/Threads.
Host-nativ — läuft unter systemd, nicht in einem Container.