Bruke Chat-integrering

Egendefinert integrering med konfigurering av innkommende og utgående webhook er tilgjengelig i Chat.

Innkommende Webhooks

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.

Slik sender du meldinger:

Det finnes to metoder for å sende data til ønsket webhooks URL-adresse:

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."}

Slik legger du til koblinger:

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!"}

Slik laster du opp filer:

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"}

Merk:

Utgående Webhooks

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.

Utgående data:

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

Svare:

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.