Gdy akcja zostanie wykonana w zdaniu przepisu, serwer monday apps wyśle żądanie POST na adres URL uruchomienia skonfigurowany w bloku niestandardowej akcji.

Gdy serwer otrzyma to zdarzenie, powinien wykonać akcję i zwrócić odpowiedź informującą o powodzeniu lub błędzie.

Dokumentacja

Zdarzenie akcji

Gdy blok zostanie uruchomiony, monday wywoła adres URL uruchomienia (Run URL) Twojej aplikacji.

Metoda: POST

Nagłówek autoryzacji:

Żądanie będzie zawierać token JWT autoryzacji w nagłówku.

Treść żądania:

Żądanie HTTP będzie zawierać następującą treść:

{
  "payload": {
    "blockKind": "action",
    "credentialsValues": {},
    "inboundFieldValues": {
      "number": "12"
    },
    "inputFields": {
      "number": "12"
    },
    "recipeId": 30440660,
    "integrationId": 398759485
  },
  "runtimeMetadata": {
    "actionUuid": "1f6129e75d7b78b77179061ab026bbab",
    "triggerUuid": "b644926b34fbabf3547bd1bc38ad6cdb"
  }
}

Odpowiedź:

Aplikacja powinna zwrócić status 200 lub status błędu opisany w naszej dokumentacji obsługi błędów.

Zasady ponawiania żądań

Jeśli serwer zwróci inny status albo nie odpowie w ciągu minuty, platforma monday będzie ponawiać żądanie przez 30 minut.

Przykłady i omówienie

Przykład

Poniższy przykład pokazuje implementację akcji „Wyślij e-mail do klienta”.

1. Otrzymujesz żądanie od monday z polami wejściowymi: tematem i treścią e-maila oraz adresem e-mail klienta.
2. Wywołujesz API dostawcy poczty, aby wysłać e-mail.
3. API zwraca status żądania i identyfikator e-maila.
4. Wysyłasz odpowiedź do monday:
5. Jeśli operacja się powiedzie, zwróć status 200.
6. Jeśli operacja się nie powiedzie, zwróć kod poziomu ważności. Błąd zostanie zapisany w historii uruchomień automatyzacji.

Projektowanie z myślą o ponownym użyciu

Pamiętaj, że niestandardowych akcji, które utworzysz, można używać w więcej niż jednym przepisie w aplikacji niestandardowej. Dlatego warto projektować je z myślą o ponownym użyciu. Przykłady niestandardowych akcji: „utwórz potencjalnego klienta w Salesforce”, „zaktualizuj status w JIRA” lub „wyślij SMS przez Twilio”.