Bitrix24 Plugin

v1.0.x · aktualisiert 2026-10-14

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.

Die unten beschriebene Medienzustellung und gemeinsame OAuth-Verbindung benötigen signiertes Core 1.4.15 und den separat signierten Connector 1.1.1 nach Katalogveröffentlichung und Update. Ein installierter Connector 1.1.0 bestätigt diese Funktionen nicht.

Fakten

Feld	Wert
Version	1.1.1
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.

Konfigurieren Sie eigene Portalbenutzer in BITRIX24_AGENT_USER_IDS und das Portal in BITRIX24_PORTAL. Abteilungsrouting begrenzt den Mitarbeiterzugriff; das Agentenkonto ersetzt nicht die Person, die eine Aufgabe ausgelöst hat. Die optionale bestehende automatische Einrichtung verwendet BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Mit den genannten Versionen wählt BITRIX24_VAULT_CONNECTIONS einen vorhandenen, gültigen, autonomen OAuth-Berechtigungsnachweis seines Eigentümers. Verwenden Sie die unterstützte native Tresor-/Verbindungsverwaltung; nutzen Sie dieselbe Nachweis-ID in Werkzeugbindungen. Der tatsächliche Eigentümer registriert den laufenden Connector in dessen Arbeitsbereich über /v1/admin/connections/channel mit einem eigenen connection-token-Schlüssel. Setzen Sie endpoint und apiKey je Agentenbenutzer-ID in der geheimen Einstellung BITRIX24_VAULT_CONNECTIONS, niemals in Agentenprofilen oder Prompts. Nur der Tresor erneuert Tokens; Werkzeuge prüfen weiterhin Akteur und Freigaben. Siehe OAuth2.

Wie es verwendet wird

Eingang: der Poller liest Nachrichten. Medien werden als Bytes heruntergeladen und über /v1/inbound/media registriert; der Agent erhält media_id, nicht nur eine URL oder Dateimetadaten.
Ausgang: Deliver wandelt Markdown in BB-Code um und lädt echte Bytes über im.v2.File.upload hoch. Medienbestätigung benötigt echte FILE_ID und Nachrichten-IDs; Text oder Link ist kein Dateibeleg.

Bewahren Sie das dauerhafte Zustellungsjournal bei Updates auf. Eine wiederholte bestätigte Operation liefert den bisherigen Beleg. Teilweise oder unbekannte Effekte werden nicht automatisch erneut gesendet; prüfen Sie sie vor einem neuen Versuch.

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

Unterstützte Funktionen

Reaktionen und @-Erwähnungen.
Schreibanzeige und Antworten, wenn Konto und Anbieter im.dialog.writing und REPLY_ID unterstützen.
Eingehende Bilder, Audio, Sprache und Dateien gemäß den obigen Versionsanforderungen.
Nachrichtenbearbeitung/-löschung nur für ältere Integrationen mit eigener Bot-Identität; für normale OAuth-Benutzer werden sie nicht angekündigt.

Grenzen

[!WARNING] Interaktive Tastaturen, Schaltflächen und Threads werden nicht unterstützt.

Eine erzeugte oder vorbereitete Datei bestätigt keine Zustellung. Teilweise, fehlgeschlagene und unbekannte Ergebnisse müssen sichtbar bleiben.

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.
Host-nativ — läuft unter systemd, nicht in einem Container.