Chat Connector

[QTip]

Die direkte Verbindung zu einem oder mehreren Chats per Webhook funktioniert nicht, da der ausgehende Webhook gegenüber dem eingehenden Webhook eine andere Struktur verwendet. Hier kommt nun Chat Connector ins Spiel...es funktioniert als Bindeglied zum Aufbau von einfachen Kanal-basierenden Verbindungen zu einem oder mehreren Chats. Diese Erweiterung ist für eine kleine Anzahl an Kanälen/Chats gedacht, da der Konfigurationsaufwand bei zu vielen Kanälen/Chats unübersichtlich wird.

Durch den Chat Connector werden nur die ausgehenden Verbindungen verarbeitet, weshalb zu jeder Installation von Chat auch ein Chat Connector existieren muss, um beide Richtungen zu bedienen.
Es existieren leider auch ein paar Nachteile:

• direktes Anworten zwischen Benutzern aus verschiedenen Chats funktioniert nicht
• die Schreibweise @<Benutzername> erzeugt bei den Zielchats nur @u:<Zahl> (Bug im Webhook)
• Benachrichtigungen durch 'Erwähnen des Benutzernamens' funktionieren aus den obigen Gründen ebenfalls nicht
• Links bzw. URL's können nicht gesendet werden
• editierte Posts werden in den Zielchats nicht aktualisiert

Paketname: chatcon_0.1-005.spk
Lizenz: GPL3
Firmware: 6.0-8451 und höher
Abhängigkeiten: Chat

Download zur Zeit nur aus dem Forum

Funktionsweise
Die Anwendung selbst besitzt kein Icon, kann nicht direkt aufgerufen und muss auch nicht konfiguriert werden. Beim Aufruf wird der Datenempfang auf Existenz der notwendigen Daten geprüft. Im Anschluss werden die einzelnen POST-Daten in das benötigte Zielformat für den Eingang des Zielchats umgebaut und per curl an den Zielchat gesendet; die Zertifikats-Validitätsprüfung ist deaktiviert.

Einrichtung
Den gewünschten Kanal in beiden Chats erstellen, die Namen können abweichen.

Eingehende Verbindung Chat 2 -> Chat 1 - Kanal A

1. Menü (rechts oben) - Einbindung - Eingehende Webhooks - Erstellen
2. Namen anpassen: der gewünschte Name für eingehende Posts (hier bietet sich der Hostname oder Name des Quellchats an)
3. Den Token für den Webhook Eingang kopieren (siehe Erklärung der Schlüsselwörter - desttoken=<token_of_destination>)

Ausgehende Verbindung Chat 1 -> Chat 2 - Kanal A

1. URL erstellen (siehe Grundsätzlicher Aufbau)
2. Menü (rechts oben) - Einbindung - Ausgehende Webhooks - Erstellen
3. Kanal: gewünschten Kanalnamen auswählen (bei "Beliebiger öffentlicher Kanal" können im folgenden Feld Auslöseworte definiert werden, die Zuordnung der Kanäle ist dann aber nicht mehr gegeben)
4. URL: die zusammengestellte URL des Zielchats für den entsprechenden Kanal
5. Wiederholung der Schritte 1 - 3 für weitere Kanäle

Aufbau der URL

Grundsätzlicher Aufbau

http://<ip_of_http_local_diskstation>:<http_port>/webman/3rdparty/chatcon/connector.cgi?dest=<ip_of_https_destination_ds>:<https_port>&desttoken=<token_of_destination>

Erklärung der Schlüsselwörter:

• ip_of_http_local_diskstation
  IP oder Hostname der Quell-DiskStation, wo der hier zu konfigurierende Webhook liegt, Webhook für Ausgang (localhost funktioniert nicht und Hostname nur, wenn der DiskStation bekannt)
• <http_port>
  HTTP-Port für die obige Adresse, HTTP wurde gewählt, da es bei selbstunterzeichneten Zertifikaten Probleme geben kann; Zertifikats-Validitätsprüfung des Webhooks kann nicht deaktiviert
  werden. Bei wem es auch mit HTTPS funktioniert, kann dies gerne benutzen.
• dest=<ip_of_https_destination_ds>
  IP oder Hostname der Ziel-DiskStation, Webhook für Eingang (Hinweis: für die Zielurl wurde die Validierung des Zertifikates per Curl deaktiviert)
• <https_port>
  HTTPS-Port für die obige Adresse
• desttoken=<token_of_destination>
  Der Token für den Webhook Eingang; dazu die Konfiguration für den dem Kanal entsprechenden Webhook Eingang öffnen und den Token aus der Zeile "Webhook-URL", hinter dem Tag "token=" (inkl. der %22 am Anfang und Ende) kopieren.

Wie immer geht Alles auf eure Kappe, ich übernehme keine Haftung für Schäden jeglicher Art.