Bitrix24

Was der Agent kann

• Empfängt jede Nachricht in den Chats, in denen der Bot Mitglied ist, und behält sie als Kontext für spätere Antworten.
• Lädt Anhänge aus Nachrichten herunter (bis 50 MB) und arbeitet damit.
• Antwortet mit Bitrix24-Formatierung und zeigt eine Tippanzeige. Dateien in einen Bitrix24-Chat senden kann der Agent noch nicht.

Zugriff und Abrechnung

Die Verbindung nutzt den eingehenden Webhook des Portals: Jeder Aufruf läuft als der Bitrix24-Benutzer, der den Webhook erstellt hat. Darüber wird ein eigener Chatbot registriert. Der Webhook wird verschlüsselt gespeichert und nie an den Browser zurückgegeben.

Der Eigentümer der Verbindung bezahlt. Das Verbinden eines Portals kostet einmalig 10 Energie; der Verbrauch pro Mitarbeiter steht auf der Verbindungskarte (Energie nach Benutzer).

So verbinden Sie

In Bitrix24

1. Melden Sie sich als Administrator im Portal an: Nur ein Administrator kann Webhooks erstellen.
2. Öffnen Sie Anwendungen, Entwicklerressourcen, Sonstiges, Eingehender Webhook.
3. Aktivieren Sie in den Webhook-Rechten "Chatbots erstellen und verwalten (imbot)". Ohne dieses Recht schlägt die Verbindung fehl.
4. Speichern und kopieren Sie die ganze URL, etwa https://portal.bitrix24.ru/rest/1/abc…/. Sie enthält bereits Portaldomain und Token.

Im Dashboard

1. Öffnen Sie Integrationen, Bitrix24 und klicken Sie auf Bitrix24 verbinden.
2. Fügen Sie den Webhook in das Feld Eingehender Webhook ein, geben Sie den Botnamen an und klicken Sie auf Erstellen.
3. Fügen Sie den Bot zu den Portal-Chats hinzu, in denen er arbeiten soll.

Die Verbindungskarte bietet Verbindungstest, Deaktivieren, Webhook oder Namen ändern, Löschen und die Mitgliederliste. Deaktivieren stoppt den Bot.

Chats und Bereiche

Jeder Portal-Chat, der dem Bot schreibt, und jeder Direktdialog mit ihm wird automatisch zu einem eigenen Bereich des Verbindungseigentümers. Externe Dienste werden mit diesen Bereichen pro Bereich, per Tag oder per Integration verknüpft (siehe Dienste mit Bereichen verbinden). Yandex Disk lässt sich mit neuen solchen Bereichen automatisch verknüpfen.

Wann der Bot antwortet

• Im Direktdialog: auf jede Nachricht.
• Im Gruppenchat: wenn der Bot erwähnt, beim Namen ("Octo") oder mit einem für den Bereich festgelegten Spitznamen gerufen wird.

Grenzen

• Eine Verbindung pro Portal und Eigentümer.
• Der Bot prüft alle 3 Sekunden auf neue Nachrichten und verlangsamt sich selbst, wenn Bitrix24 um eine Pause bittet.
• Es gelten die Ausgabenlimits des Eigentümers: pro Bereich oder pro Mitarbeiter.

Fehlerbehebung

"Der Webhook wurde abgelehnt: Recht imbot erteilen"

Erstellen Sie den eingehenden Webhook mit aktiviertem "Chatbots erstellen und verwalten (imbot)" neu und fügen Sie die neue URL ein.

"Das sieht nicht wie eine REST-Webhook-URL aus"

Fügen Sie die ganze URL mit /rest/, Benutzernummer und Token ein, nicht nur die Portaldomain.

"Portal nicht erreichbar" oder ein HTTP-Fehler

Prüfen Sie die Portaladresse im Webhook und dass der Webhook in Bitrix24 noch existiert.

"Nicht genug Energie zum Verbinden (10 nötig)"

Laden Sie auf und versuchen Sie es erneut.

"Für dieses Portal existiert bereits eine Verbindung"

Nutzen Sie die vorhandene Karte: Dort können Sie Webhook oder Botnamen ändern.

Der Bot schweigt in einem Chat

Ist der Bot im Chat? Wurde er erwähnt oder beim Namen gerufen? Wartet der Autor auf Freigabe (siehe Markierung auf der Verbindungskarte)? Ist die Verbindung aktiv?