A Chat testre szabható integrációt tesz lehetővé, amelynek keretében bejövő és kimenő webhookokat állíthat be.
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.
A webhook URL-címére kétféle módon küldhet adatokat:
payload
paramétereként.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á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!"}
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"}
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.
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
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.