Tilpasset integration er tilgængelige i Chat, hvor du kan konfigurere indgående og udgående webhooks.
En indgående webhook vil postere meddelelser fra eksterne kilder til Chat. Det udnytter generelle HTTP-anmodninger med JSON-data sammen med andre valgfrie indstillinger.
Der er to måder, du kan sende data til webhook-URL'en:
data
-parameteren i en POST-anmodning.JSON-data kan inkludere en tekst
egenskab, som posteres til den tildelte kanal. F.eks.:
payload={"text": "First line of message to post in the channel.\nAlso you can have a second line of message."}
Du tilføjer et link ved at inputte det direkte i teksten
. F.eks.:
payload={"text": "<https://www.synology.com>"}
Endnu et eksempel:
payload={"text": "Check this!! <https://www.synology.com|Click here> for details!"}
Du kan også uploade en fil i dine indgående posteringer. Hvis du vil uploade en fil, skal dine JSON-data indeholde en file_url
-egenskab og også en valgfri tekstegenskab. Vi vil downloade din URL og behandle den som en brugerfils uploadpostering. F.eks.:
payload={"text": "a fun image", "file_url": "http://imgur.com/xxxxx"}
Udgående webhooks lytter efter udløserord i Chat-meddelelser. Disse udløserord vil sende relevante data til en ekstern URL. Udgående webhooks kan kun udløses, når en eller begge nedenstående betingelser opfyldes:
Hvis en kanal angives, er udløserordet valgfrit. Udløserord er påkrævede, hvis ingen kanal er valgt. Hvis to betingelser er defineret, vil den udgående webhook kun udføres, når to betingelser opfyldes på samme tid.
Når en modtaget meddelelse matcher en udløser, leveres en POST til den tildelte URL. Datafelter beskrives herunder:
token: bot token channel_id channel_name user_id username post_id timestamp text trigger_word: which trigger word is matched
Hvis den eksterne destination vil svare i Chat-kanalen, skal JSON returneres til svarteksten. Understøttede felter er de samme som en indgående webhook-JSON.