Anpassad integration finns tillgänglig i Chat där du kan konfigurera inkommande och utgående 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.
Det finns två sätt att skicka data till webhook-URL:en:
nyttolast
-parameter i en POST-förfrågan.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."}
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!"}
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"}
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.
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
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.