Diese Anleitung ermöglicht es Ihnen, externe Anwendungen mit kChat mithilfe von Webhooks zu verwalten.

Vorbemerkung

• Ein Webhook ist eine Methode, die es einer Anwendung ermöglicht, sofort benachrichtigt zu werden, wenn ein bestimmtes Ereignis in einer anderen Anwendung auftritt, anstatt diese Anwendung ständig zu fragen, ob etwas Neues passiert ist (was als "Polling" bezeichnet wird).
  • Ausgehender Webhook: kChat übermittelt Informationen an andere Apps, wenn ein Ereignis in kChat auftritt.
  • Eingehender Webhook: kChat empfängt Informationen von anderen Apps, um Aktionen in kChat auszulösen.
• Es ist nicht möglich, den Verlauf der Gespräche aus einer anderen Anwendung (Slack, Teams, Jabber, etc.) oder aus einer anderen Organisation zu importieren.

Auf die kChat Webhook-Schnittstelle zugreifen

Voraussetzungen

• Kein externer Benutzer sein (dieser wird das Menü nicht sehen Integrationen).

Um einen Webhook zu konfigurieren und Anwendungen und selbstgehostete oder Drittanbieter-Integrationen zu finden:

1. Klicken Sie hier‍, um auf die Web-App kChat (Online-Dienst kchat.infomaniak.com) zuzugreifen oder öffnen Sie die Desktop-App kChat (Desktop-Anwendung für macOS / Windows / Linux).
2. Klicken Sie auf das Neue Symbol ‍ neben dem Namen Ihrer kChat-Organisation.
3. Klicken Sie auf Integrationen.
4. Navigieren Sie zu den Kategorien:
   

Beispiel für eine Integration

• Erinnerung an ein Kalenderereignis von Infomaniak auf kChat

Einen einfachen eingehenden Webhook erstellen

Dazu:

1. Klicken Sie auf die Kategorie Eingehende Webhooks.
2. Klicken Sie auf die blaue Schaltfläche Webhooks hinzufügen:
   
3. Fügen Sie einen Namen und eine Beschreibung (max. 500 Zeichen) für den Webhook hinzu.
4. Wählen Sie den Kanal aus, der die Nachrichten erhalten soll
5. Speichern Sie, um die URL zu erhalten (nicht öffentlich weitergeben); Beispiel: „https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx“.

Verwendung des Webhooks

In der Anwendung, die auf kChat posten soll:

1. Passen Sie den folgenden Code entsprechend der erhaltenen URL an:

   POST /hooks/xxx-key-generated-xxx HTTP/1.1
   Host: your-server-kchat.xyz
   Content-Type: application/json
   Content-Length: 63
   {
       "text": "Hello, text1
   Text2."
   }

2. Verwenden Sie gegebenenfalls denselben Request, aber mit curl (zum Testen von einer Anwendung des Typs Terminal (Kommandzeilenschnittstelle, CLI / Command Line Interface) auf Ihrem Gerät):

   curl -i -X POST -H 'Content-Type: application/json' -d '{"text": "Hello, text1
   Text2."}' https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx

Falls kein Content-Type Header definiert ist, muss der Anfragekörper mit payload= beginnen:

payload={"text": "Hello, text1
Text2."}

Eine erfolgreiche Anfrage erhält die folgende Antwort:

HTTP/1.1 200 OK	
Content-Type: application/json	
X-Version-Id: 4.7.1.dev.12799dvd77e172e8a2eba0f4041ec1471.false	
Date: Sun, 01 Jun 2023 17:00:00 GMT	
Content-Length: 58	
	
{	
    "id":"x",	
    "create_at":1713198308869,	
    "update_at":1713198308869,	
    "delete_at":0,	
    "user_id":"x",	
    "channel_id":"x",	
    "root_id":"",	
    "original_id":"",	
    "participants":null,	
    "message":"test",	
    "type":"",	
    "props":{	
        "override_username":"webhook",	
        "override_icon_url":null,	
        "override_icon_emoji":null,	
        "webhook_display_name":"test",	
        "attachments":[	
	
        ],	
        "card":null,	
        "from_webhook":"true"	
    },	
    "hashtags":null,	
    "metadata":{	
        "embeds":[	
            {	
                "type":"message_attachment"	
            }	
        ],	
        "files":[	
	
        ],	
        "reactions":[	
	
        ]	
    },	
    "file_ids":null,	
    "has_reactions":false,	
    "edit_at":0,	
    "is_pinned":false,	
    "remote_id":null,	
    "reply_count":0,	
    "pending_post_id":null,	
    "is_following":false	
}

Falls Sie dasselbe Antwortformat wie Slack erhalten möchten:

HTTP/1.1 200 OK
Content-Type: text/plain
X-Request-Id: hoan69ws7rp5xj7wu9rmystry
X-Version-Id: 4.7.1.dev.12799dvd77e172e8a2eba0f4041ec1471.false
Date: Sun, 01 Jun 2023 17:00:00 GMT
Content-Length: 2
ok

Sie müssen ?slack_return_format=true zur Webhook-URL hinzufügen.

Einstellungen

Neben dem Feld text hier ist die vollständige Liste der unterstützten Parameter:

Beispielcode mit Parametern

Hier ist, wie man eine umfassendere Nachricht mit Parametern erstellt, wobei einige bereits beim Erstellen des Webhooks festgelegte Parameter (Benutzername, bevorzugter Kanal, Avatar...) wie in der obigen Tabelle angegeben, ersetzen können:

POST /hooks/xxx-clé-générée-xxx HTTP/1.1
Host: votre-serveur-kchat.xyz
Content-Type: application/json
Content-Length: 630
{
  "channel": "kchatemp",
  "username": "test-automation",
  "icon_url": "https://domain.xyz/wp-content/uploads/2023/06/icon.png",
  "text": "#### Résultats des tests pour le 27 juillet 2023
@channel veuillez vérifier les tests échoués.

| Composant  | Tests effectués   | Tests échoués                                   |
|:-----------|:-----------:|:-----------------------------------------------|
| Serveur     | 948         |  0                           |
| Client Web | 123         |  2 [(voir détails)](https://linktologs) |
| Client iOS | 78          |  3 [(voir détails)](https://linktologs) |"
}

Das wird dazu führen, dass diese Nachricht im Kanal kchatemp der Organisation: