Akcje

Gdy w przepisie niestandardowej integracji zostanie wyzwolona akcja, serwer monday apps wyśle żądanie POST na adres URL uruchomieniowy (Run URL) skonfigurowany w bloku niestandardowej akcji.

Gdy serwer otrzyma to zdarzenie, powinien wykonać akcję, a następnie w razie potrzeby zwrócić pola wyjściowe.

Dokumentacja

Zdarzenie akcji

Gdy akcja zostanie uruchomiona w przepływie pracy, monday wywoła adres URL uruchomieniowy (Run URL) Twojej aplikacji. Żądanie będzie zawierać pola wejściowe, dane uwierzytelniające i metadane bloku.

Metoda: POST

Nagłówek autoryzacji:

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

Treść żądania:

Żądanie HTTP będzie zawierać następujące dane:

{
  "payload": {
    "blockKind": "action",
     "credentialsValues":   { 
       "credentials-key": { 
         userCredentialsId: 12345, 
         accessToken: "abc1234" 
       } 
     },
    "inboundFieldValues": {
      "shoes": "shoe1",
      "listSocks": "socks_2",
      "object": {
        "email": "Hello world",
        "name": [
          "Dipro"
        ],
        "lastCall": "1993-08-27"
      },
      "login": "abc1234",
      "boo": true,
      "myNumber": 10
    },
    "inputFields": {
      "shoes": "shoe1",
      "listSocks": "socks_2",
      "object": {
        "email": "Hello world",
        "name": [
          "Dipro"
        ],
        "lastCall": "1993-08-27"
      },
      "login": "abc1234",
      "boo": true,
      "myNumber": 10
    },
    "recipeId": 629280,
    "integrationId": 398528596
  },
  "runtimeMetadata": {
    "actionUuid": "3b0a86dcb5a1d05e8aff1e4791cafde5",
    "triggerUuid": "bd661564c1d1968d5e56c67051cf7511"
  }
}

Odpowiedź:

Aplikacja powinna zwrócić pola wyjściowe wygenerowane przez akcję, status 200 i nagłówek Content-Type:application/json. Na przykład akcja wysyłająca e-mail może zwrócić metadane dotyczące samej akcji:

{
  outputFields: {
    recipientAddress: "dipro@tuesday.gov",
    subjectLine: "Build your perfect workflow with our services",
    contentHead: "Hey Dipro, we're workflow experts and can help your team..."
    success: true,
    sentAt: "2025-01-01"
   }
}

Zasady ponawiania prób

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

Słowniczek i przykłady

Przykład

Poniższy przykład pokazuje, jak zaimplementować akcję „Wyślij e-mail do klienta”.

1. Otrzymujesz od monday żądanie 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. W przypadku powodzenia zwracasz w treści odpowiedzi dane wyjściowe akcji - identyfikator e-maila i czas jego utworzenia.
6. W przypadku niepowodzenia zwracasz kod poziomu ważności. Błąd zostanie zarejestrowany w historii uruchomień automatyzacji.

Projektowanie z myślą o ponownym użyciu

Utworzone przez Ciebie niestandardowe akcje można wykorzystać w więcej niż jednym przepływie pracy, dlatego warto projektować je z myślą o ponownym użyciu. Przykłady niestandardowych akcji to: „Utwórz leada w Salesforce”, „Zaktualizuj status w Jira” czy nawet „Wyślij SMS przez Twilio”.