Chat-integráció használata

A Chat testre szabható integrációt tesz lehetővé, amelynek keretében bejövő és kimenő webhookokat állíthat be.

Bejövő webhookok

A bejövő webhookok külső forrásokból származó üzeneteket posztolnak a Chat alkalmazásba. Ez a funkció más opcionális beállítások mellett JSON-adattartalmakat magukban foglaló általános HTTP-kéréseket használ.

Üzenetek küldése:

A webhook URL-címére kétféle módon küldhet adatokat:

A JSON-adattartalom része lehet egy text tulajdonság, amelyet a program kiposztol a megadott csatornára. Például:

payload={"text": "First line of message to post in the channel.\nAlso you can have a second line of message."}

Hivatkozások hozzáadása:

Hivatkozás hozzáadásához illessze be a hivatkozást közvetlenül a szöveg tartalmába. Például:

payload={"text": "<https://www.synology.com>"}

Másik példa:

payload={"text": "Check this!! <https://www.synology.com|Click here> for details!"}

Fájlok feltöltése:

A bejövő posztok feltöltött fájlokat is tartalmazhatnak. Fájl feltöltéséhez a JSON-adattartalomnak részét kell képeznie egy file_url tulajdonságnak, valamint egy opcionális szövegtulajdonságnak. Letöltjük az URL-címet, és úgy kezeljük, mintha az felhasználó által feltöltött poszt lenne. Például:

payload={"text": "a fun image", "file_url": "http://imgur.com/xxxxx"}

Megjegyzés:

Kimenő webhookok

A kimenő webhookok kiváltószavakat keresnek a Chat-üzenetekben. Ezek a kiváltószavak elküldik a releváns adatokat egy külső URL-címre. A kimenő webhookok csak akkor indíthatók el, ha legalább az alábbi feltételek egyike teljesül:

Ha megadta a csatornát, a kiváltószavak opcionálisak. Ha nem ad meg csatornát, kötelező kiváltószavakat használni. Ha azonban mindkét feltételt meghatározta, a kimenő webhook csak akkor jön létre, ha azok egyszerre teljesülnek.

Kimenő adatok:

Ha egy beérkező üzenet egyezik a kiváltóval, a rendszert POST üzenetet küld a meghatározott URL-címre. Az adatmezők leírását alább láthatja:

token: bot token
channel_id
channel_name
user_id
username
post_id
timestamp
text
trigger_word: which trigger word is matched

Válasz:

Ha a külső cél szeretne választ adni a Chat csatornában, a JSON-t a válasz törzsszövegében kell visszaadni. A támogatott mezők ugyanazok, mint a bejövő webhook JSON-ja esetében.