Egendefinert integrering med konfigurering av innkommende og utgående webhook er tilgjengelig i Chat.
En innkommende webhook publiserer meldinger fra eksterne kilder i Chat. Den benytter seg av generelle HTTP-forespørsler med en JSON-nyttelast, samt andre valgfrie innstillinger.
Det finnes to metoder for å sende data til ønsket webhooks URL-adresse:
payload
-parameter i en POST-forespørsel.JSON-nyttelasten kan inneholde en text
-egenskap, som blir publisert i den aktuelle kanalen. For eksempel:
payload={"text": "First line of message to post in the channel.\nAlso you can have a second line of message."}
For å legge til en kobling, kan du skrive inn koblingen direkte i text
. For eksempel:
payload={"text": "<https://www.synology.com>"}
Et annet eksempel:
payload={"text": "Check this!! <https://www.synology.com|Click here> for details!"}
Du kan også laste opp en fil i innkommende innlegg. For å laste opp en fil, må JSON-nyttelasten inneholde en file_url
-egenskap og en valgfri tekstegenskap. Vi laster ned URL-adressen din og behandler den som en publisering med brukerfilopplasting. For eksempel:
payload={"text": "a fun image", "file_url": "http://imgur.com/xxxxx"}
En utgående webhook lytter etter utløserord i Chat-meldinger. Disse utløserordene sender relevant data til en ekstern URL. Utgående webhooks kan kun utløses når én av eller begge betingelsene nedenfor oppstår:
Hvis en kanal er spesifisert, er utløserordene valgfrie. Utløserord kreves hvis det ikke er valgt noen kanal. Hvis begge de to betingelsene er spesifisert, vil utgående webhook kun aktiveres når de to betingelsene oppstår samtidig.
Når en mottatt melding samsvarer med en utløser, blir det levert et INNLEGG til den spesifiserte URL-adressen. Datafeltene er beskrevet nedenfor:
token: bot token channel_id channel_name user_id username post_id timestamp text trigger_word: which trigger word is matched
Hvis det eksterne målet ønsker å svare i Chat-kanalen, må JSON returneres i svarets hovedtekst. Støttede felt er de samme som for en innkommende webhook-JSON.