Använda integration i Chat

Anpassad integration finns tillgänglig i Chat där du kan konfigurera inkommande och utgående webhooks.

Inkommande Webhooks

En inkommande webhook postar meddelanden från externa källor i Chat. Den drar fördel av allmänna HTTP-förfrågningar med en JSON-nyttolast tillsammans med andra valfria inställningar.

Att skicka meddelanden:

Det finns två sätt att skicka data till webhook-URL:en:

JSON-nyttolasten kan innehålla en text-egenskap som kan postad till den tilldelade kanalen. Till exempel:

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

Att lägga till länkar:

För att lägga till en länk kan du lägga in dess länk direkt i text. Till exempel:

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

Ett annat exempel:

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

Att ladda upp filer:

Du kan även ladda upp en fil i dina inkommande inlägg. För att ladda upp en fil måste din JSON-nyttolast innehålla egenskapen file_url och även en valfri textegenskap. Vi laddar ned din URL och behandlar den som en användares filuppladdade inlägg. Till exempel:

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

Obs:

Utgående Webhooks

Utgående webhooks lyssnar efter triggerord i Chat-meddelanden. Dessa triggerord skickar relevanta data till en extern URL. Utgående webhooks kan endast utlösas när en eller båda av nedanstående villkor är uppfyllda:

Om kanalen indikeras är triggerorden valfria. Triggerord krävs inte om inte någon kanal är vald. Dock, om de två villkoren båda är definierade inträffar den utgående webhooken bara när två villkor uppfylls på samma gång.

Utgående data:

När ett mottaget meddelande överensstämmer med en trigger levereras en POST till den tilldelade URL:en. Datafälten är enligt nedanstående beskrivning:

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

Svara:

Om de externa destinationerna vill svara i Chat-kanalen behöver JSON returneras i innehållet av svaret. De fält som stöds är desamma som inkommande webhook-JSON.