Coroid verfügt über Plattform-Bots für Slack, Discord, Telegram und SMS. Konfigurieren Sie sie in diesem Abschnitt: Einstellungen → Verbindungen → Kanäle.
Was jeder Bot heute leistet:
| Plattform | Nachrichten werden zu Anfragen | Empfängt Updates |
|---|---|---|
| Slack | Ja, über eine Ereignisautomatisierung | Aufgaben-Updates über einen eingehenden Webhook |
| Telegram | Ja, über eine Ereignisautomatisierung | Nein |
| Discord | Nein | Nein |
| SMS | Nein | Nein |
Sie können einen Discord- oder SMS-Bot speichern, doch derzeit wird er nicht genutzt. Die gleiche Seite enthält außerdem Kanalbrücken, die noch nicht funktionieren. Siehe Kanal-Brücken.
Plattform-Bots
Der Bot ist die Identität, die Coroid auf der Plattform verwendet. Installieren Sie ihn einmal pro Arbeitsbereich oder Server und gewähren Sie ihm Zugriff auf die Kanäle, die er lesen soll. Für Slack und Telegram ist der Bot erforderlich, damit eine Ereignisautomatisierung Nachrichten lesen kann.
Wenn ein Slack-Bot aus einem Kanal entfernt wird, kann Coroid diesen Kanal nicht mehr lesen – doch darüber wird keine Benachrichtigung ausgegeben. Sollten Slack-Nachrichten nicht mehr zu Anfragen werden, prüfen Sie, ob der Bot noch im Kanal vorhanden ist.
Nur Besitzer und Administratoren können einen Bot hinzufügen, ändern oder entfernen. Jede Plattform sendet ihre Ereignisse an eine Webhook-URL des API-Gateways, die Coroid für jeden Bot anzeigt. Coroid lehnt eine Übermittlung ab, wenn diese nicht mit dem Secret des Bots signiert ist.
Mit der Arbeit aus einem Kanal beginnen
Eine Slack- oder Telegram-Nachricht kann zu einer Arbeitsanfrage werden. Discord- und SMS-Nachrichten können das nicht.
Eine Nachricht wird über eine Ereignisautomatisierung zu einer Anfrage. Das ist nützlich für die „Kann jemand das einfach reparieren…“-Anfragen, die sonst nie als nachverfolgbare Aufgaben erfasst würden.
Eine passende Nachricht geht als Anfrage an die Qualitätskontrolle. Dort wird sie geprüft, auf Duplikate überprüft und festgelegt, was daraus werden soll. Erst wenn sie die Prüfung besteht, wird etwas erstellt. Siehe Möglichkeiten, mit der Arbeit zu beginnen.
Coroid verknüpft Slack- oder Telegram-Konten nicht mit Coroid-Konten, sodass jede Person, die in einem passenden Chat posten kann, eine Anfrage stellen darf. Aus diesem Grund beginnt die Arbeit aus einem Chat nicht von selbst. Eine qualifizierte Aufgabe wird erstellt und wartet darauf, dass jemand damit beginnt; ein Plan wartet auf die Freigabe.
Siehe Trigger und Zielorte.
Slack
- Konfigurieren Sie den Slack-Bot in diesem Abschnitt: Plattform-Bots. Dafür werden der Bot-Token und das Signing-Secret der Slack-App benötigt.
- Senden Sie in Ihrer Slack-App Kanalnachrichten und App-Mentionen an die Webhook-URL,
die Coroid anzeigt:
https://api.coroid.ai/api/v1/webhooks/slack/events. - Laden Sie den Bot in jeden Kanal ein, den er auslesen soll.
- Aktivieren Sie Slack in Qualitätskontrolle → Organisationsstandard → Vor Arbeitsbeginn → Wo Anfragen eingehen. Nur Inhaber und Admins können eine Quelle aktivieren – und nur nachdem der Bot verbunden wurde.
Die Aktivierung von Slack fügt eine Automatisierung hinzu, die passende Nachrichten als Anfragen erfasst. Sie ist unter Factory → Automatisierungenaufgeführt; dort können Sie deren Filter ändern. Wenn Slack deaktiviert wird, pausiert die Automatisierung, der Filter bleibt jedoch bestehen.
Der Filter der Automatisierung bestimmt, welche Nachrichten gezählt werden. Er beginnt mit der Übereinstimmung
mit Nachrichten, die diese Mention enthalten: @coroid. Ein Filter kann die Automatisierung auch auf einen Kanal oder auf von Bots gepostete Nachrichten, z. B. Alarme, beschränken.
Coroid verarbeitet pro Minute maximal 10 Slack-Automatisierungen für einen Kanal.
Telegram
- Fügen Sie den Telegram-Bot in diesem Abschnitt hinzu: Plattform-Bots. Coroid registriert seinen Webhook bei Telegram und schützt ihn mit einem Webhook-Secret. Ist das Secret leer, generiert Coroid eines.
- Fügen Sie den Bot zur Gruppe hinzu oder machen Sie ihn zum Admin des Kanals.
- Aktivieren Sie Telegram in Qualitätskontrolle → Organisationsstandard → Vor Arbeitsbeginn → Wo Anfragen eingehen. Die dazugehörige Automatisierung ist unter Factory → Automatisierungenaufgeführt; dort können Sie deren Filter ändern.
- Beginnen Sie jede Anfrage im Chat mit diesem Befehl:
/coroid.
Telegrams Privatsphäre-Modus ist standardmäßig aktiviert; er ermöglicht dem Bot das Erkennen von Befehlen, nicht aber von gewöhnlichen Nachrichten. Ein Filter kann die Automatisierung auch auf einen Chat durch dessen Chat-ID beschränken. Der Bot ignoriert Direktnachrichten, es sei denn, der Filter erlaubt sie.
Jeder kann Ihren Bot in eine andere Gruppe hinzufügen und dort Anfragen einreichen. Um das zu verhindern, beschränken Sie die Automatisierung auf Ihren Chat oder hindern den Bot am Beitreten von Gruppen mit diesem BotFather-Befehl: /setjoingroups.
Coroid nimmt pro Minute maximal 10 passende Nachrichten aus einem Chat entgegen. Ist die Automatisierung auf ein Projekt beschränkt, gehen die Anfragen an dieses Projekt.
Kanal-Brücken
Eine Brücke verknüpft einen Kanal mit einer Sitzung des Chat-Assistenten.
Das Gespräch mit dem Assistenten über eine Brücke ist nicht möglich. Eine Brücke leitet Nachrichten nicht an den Assistenten weiter, weshalb sie keine Arbeit starten oder steuern kann.
Updates in einem Kanal
Slack ist die einzige Chat-Plattform, die Updates erhält. Coroid sendet Nachrichten an einen Slack-Kanal, wenn eine Aufgabe abgeschlossen, fehlgeschlagen oder eskaliert wird, sowie bei erneuten Versuchen oder beim Aufgeben bei einem Merge-Konflikt. Die Nachrichten werden über einen mit Ihrer Organisation verbundenen Slack-Eingehenden-Webhook versendet – nicht über den Slack-Bot. Ein Einstellungsbildschirm zur Verbindung des Webhooks steht derzeit noch nicht zur Verfügung.
Discord, Telegram und SMS erhalten keine Updates. Alle anderen Mitteilungen erscheinen im Portal. Siehe Benachrichtigungen.