Πρόσθεσε εντολές slash

Γρήγορη εκκίνηση

1. 1

   Δημιούργησε το trigger

   Στην εφαρμογή για υπολογιστή, άνοιξε στην κοινότητά σου Manage Server → Triggers και πρόσθεσε ένα: την εντολή στην οποία αντιδρά, όπως /weather, και το URL της web υπηρεσίας σου.

2. 2

   Λάβε το μήνυμα

   Όταν ένα μέλος στέλνει μήνυμα που ξεκινά με /weather, το mssgs το στέλνει με POST στο URL σου:

   jsonΑντιγραφή

   {
     "server_guid": "abc12345-...",
     "channel_guid": "def67890-...",
     "trigger_match": "/weather",
     "message": {
       "id": "d01ZZdef6-...",
       "content": "/weather Amsterdam",
       "member_guid": "member-guid",
       "user_guid": "user-guid",
       "group_guids": ["group-guid-1", "group-guid-2"],
       "cms": 1790000000000
     },
     "callback_url": "https://mss.gs/api/v1/trigger-callback/...",
     "stream_url": "https://mss.gs/api/v1/instant/...?token=..."
   }

3. 3

   Απάντησε με JSON

   Απάντησε μέσα σε 5 δευτερόλεπτα με status 2xx και JSON. Γίνεται κάρτα στο κανάλι.

   jsonΑντιγραφή

   {
     "message_container": {
       "color": "blue",
       "title": "Amsterdam",
       "description": "14 °C, light rain until 16:00",
       "fields": [
         { "field": "Wind", "value": "SW 18 km/h" },
         { "field": "Humidity", "value": "82%" }
       ]
     }
   }

   #general

   MA

   maya18:45

   /weather Amsterdam

   

   Message from Weekend Crew

   Amsterdam

   14 °C, ελαφριά βροχή έως τις 16:00

   Wind

   SW 18 km/h

   Humidity

   82%

   18:45, maya triggered /weather command

Ρυθμίσεις

Κάθε trigger έχει αυτές τις ρυθμίσεις στο Manage Server → Triggers.

Τι λαμβάνεις

Ένα POST με σώμα JSON. Στις κεφαλίδες περιλαμβάνεται το User-Agent: mssgs-webhook/1.0.

Έλεγχος του ποιος μπορεί να κάνει τι

Σύγκρινε το message.group_guids με τους ρόλους που εμπιστεύεσαι, για παράδειγμα ώστε μόνο οι συντονιστές να μπορούν να τρέξουν το /ban. Για να κρατήσεις μια εντολή εντελώς μακριά από όλους τους άλλους, όρισε τους ρόλους της στις ρυθμίσεις του trigger.

Τι απαντάς

Οποιοδήποτε status 2xx με σώμα JSON, έως 4 MB. Στείλε τουλάχιστον ένα από τα message_container ή actions.

Πέντε δευτερόλεπτα

Το mssgs περιμένει 5 δευτερόλεπτα για την απάντησή σου. Αν χρειάζεσαι περισσότερο χρόνο, απάντησε αμέσως με μια κάρτα loader και ολοκλήρωσε μέσω του callback_url, που ισχύει για 30 λεπτά.

// Answer within 5 seconds with a loader...
res.json({ message_container: { loader: true, loader_text: 'Looking it up…' } });

// ...then finish in your own time with the callback URL.
await fetch(req.body.callback_url, {
  method: 'PUT',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ message_container: { color: 'blue', title: 'Done', description: result } })
});

Ιδιωτικές απαντήσεις

Βάλε ids μελών στο visible_to_member_guids και μόνο εκείνα βλέπουν την απάντησή σου. Χρησιμοποίησε το member_guid από το αίτημα για να απαντήσεις μόνο στο άτομο που ρώτησε.

{
  "message_container": {
    "color": "green",
    "title": "You're on the list",
    "description": "Only you can see this reply."
  },
  "visible_to_member_guids": ["<message.member_guid from the request>"]
}

Ένα πλήρες παράδειγμα

Μια εντολή /weather σε Node.js με Express, που απαντά με κάρτα.

import express from 'express';

const app = express();
app.use(express.json());

app.post('/mssgs/weather', async (req, res) => {
  const city = req.body.message.content.replace('/weather', '').trim() || 'Amsterdam';
  const w = await getWeather(city); // your own lookup

  res.json({
    message_container: {
      color: 'blue',
      title: city,
      description: `${w.temp} °C, ${w.summary}`,
      fields: [
        { field: 'Wind', value: w.wind },
        { field: 'Humidity', value: `${w.humidity}%` }
      ]
    }
  });
});

app.listen(3000);

Όρια