Yandex Messenger

Was der Agent kann

• Empfängt jede Nachricht in den Chats, in denen der Bot ist, und speichert Anhänge (bis 50 MB).
• Antwortet mit Text, reagiert, zeigt eine Tippanzeige und sendet vorbereitete Dateien in den Chat.
• Benennt den Bereich nach dem echten Chatnamen.

Zugriff und Abrechnung

Der Bot handelt in eigenem Namen, nicht als Mitarbeiter. Ein Messenger-Bot-Token hat keine Rechte-Häkchen: Es erlaubt sofort alles, was Bots können. Zwei Bedingungen ersetzen die Rechte: Nur ein Organisationsadministrator kann es ausstellen, und der Bot muss den Chats hinzugefügt werden, die er bedienen soll.

Eine Organisations-ID geben Sie nicht ein: Octo fragt nie danach, denn das Token gehört bereits zu einem Bot in einer Organisation. Das Token wird verschlüsselt gespeichert und nie an den Browser zurückgegeben. Der Verbindungseigentümer bezahlt; das Verbinden kostet einmalig 10 Energie.

So verbinden Sie

1. Ein Organisationsadministrator öffnet den Yandex 360 Admin, Messenger, "Bots in Messenger": admin.yandex.ru/bot-platform.
2. Klicken Sie auf "Bot erstellen" und geben Sie den Namen ein, den Chats sehen. Das Token wird erzeugt und in die Zwischenablage kopiert. Yandex speichert Bot-Token nicht: Ein verlorenes Token kann nur neu ausgestellt werden ("Reissue token" in den Boteinstellungen).
3. Öffnen Sie im Dashboard Integrationen, Yandex Messenger, fügen Sie das Token in das Feld Bot-OAuth-Token ein, vergeben Sie optional ein Label und klicken Sie auf Erstellen.
4. Klicken Sie auf Verbindungstest. Beim Anlegen wird das Token nicht geprüft, daher ist dieser Test wichtig.
5. Fügen Sie den Bot in Messenger über die Mitgliederliste des Chats per Botname zu den gewünschten Chats hinzu.

Sie können auch aus Telegram verbinden: Senden Sie /yandex an @octodus_bot im Direktchat. Der Bot löscht die Nachricht mit dem Token sofort.

Chats, Bereiche und Konsole

Jeder Chat mit dem Bot wird automatisch zu einem eigenen Bereich des Verbindungseigentümers. Für die Organisation gibt es eine Integrationskonsole: Mitarbeiter und ihr Verbrauch, ein Monatslimit pro Mitarbeiter, Bereiche, die Standardfähigkeiten, Miteigentümer und der gemeinsame Yandex Disk der Organisation.

Andere Dienste werden mit diesen Bereichen pro Bereich, per Tag oder per Integration verknüpft: Dienste mit Bereichen verbinden.

Wann der Bot antwortet

• Im Direktchat: auf jede Nachricht.
• Im Gruppenchat: wenn der Bot beim Namen ("Octo") oder Spitznamen gerufen wird, wenn jemand auf seine Nachricht antwortet, oder in einem Thread, den der Bot begonnen hat.
• Die erste Anfrage eines neuen Mitarbeiters wartet auf die Freigabe des Verbindungseigentümers, wie bei Bitrix24.

Grenzen

• Messenger arbeitet nur per Abfrage (getUpdates), ohne Webhook: Der Bot prüft alle 3 Sekunden auf neue Nachrichten.
• Eine Verbindung pro Organisation und Eigentümer.
• Das Monatslimit pro Mitarbeiter (in der Konsole) gilt in allen Bereichen der Organisation, zusätzlich zu Bereichslimits.

Fehlerbehebung

Verbindungstest: "HTTP 401 from Yandex"

Das Token funktioniert nicht: unvollständig kopiert, nicht vom Bot (etwa ein "Yandex ID"-Token) oder bereits neu ausgestellt. Stellen Sie es in "Bots in Messenger" neu aus und fügen Sie den neuen Wert ein.

Verbindungstest: "HTTP 403 from Yandex"

Das Token ist in Ordnung, aber Bots sind für die Organisation deaktiviert. Ein Yandex 360 Organisationsadministrator muss Bots aktivieren.

Verbindungstest: "Could not reach Yandex"

Das liegt nicht an Ihrem Token. Unsere Seite hat botapi.messenger.yandex.net nicht erreicht: Das Problem liegt bei unserem Netzwerkzugang, nicht bei Ihrer Einrichtung. Versuchen Sie es später erneut und wenden Sie sich an den Support, wenn es bleibt.

"Für diese Organisation existiert bereits eine Verbindung"

Dieses Token ist bereits verbunden. Ändern Sie Token oder Label auf der vorhandenen Karte.

Der Bot schweigt

Ist der Bot im Chat? Wurde er beim Namen gerufen, wurde auf ihn geantwortet oder in seinem Thread geschrieben? Wartet der Autor auf Freigabe?