AiHummer
Deutsch▾
AnmeldenKonto
v1.2.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanäle/Bitrix24

Bitrix24

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

Bitrix24 ist ein interner Instant-Messaging-Kanal für Mitarbeiter — dieselbe Rolle, die Telegram oder Slack für das Personal spielt. Ein AiHummer-Agent erscheint innerhalb Ihres Unternehmens Bitrix24 als Kollege, dem Mitarbeiter Nachrichten senden und den sie erwähnen können.

Der Kanal versendet als ein Verbindungselement aus dem Produkt Marktplatz und läuft nativ auf dem Host. Es wird über die Admin-Benutzeroberfläche konfiguriert, wie jeder andere Kanal auch.

[!NOTE] Der Bitrix24-Kanal erfordert einen aktiven Anlasser, Geschäft oder Unternehmen Lizenz. Im Community-Plan liefert die Installation des Connectors HTTP 402 „Upgrade erforderlich“ (Code plan_limit) — siehe Lizenzierung.

[!WARNING] Bitrix24 ist hier strikt ein interner Mitarbeiter-IM-Kanal. Es ist nicht Kunden-Omnichannel nicht Bitrix24 Offene Leitungen, nicht eine Warteschlange für Tickets, und nicht eine Betreiber-Eskalationsoberfläche. Verwenden Sie sie nicht, um externe zu leiten Kundengespräche.

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.

Eine menschenähnliche Agentenidentität

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.

Ports und Laufzeit

Port Zweck
8810 Connector-Dienst auf Loopback: Zustand und Deliver

Wie Nachrichten fließen

  • 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.

Was wird unterstützt

  • 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.

[!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.

Wohin als Nächstes