Utwórz powiadomienie (Platform MCP)
Użyj tego narzędzia, aby wysłać powiadomienie w aplikacji do dowolnego użytkownika na koncie. Powiadomienia pojawiają się pod ikoną dzwonka odbiorcy (w centrum powiadomień) i mogą też wywołać wysłanie wiadomości e-mail - zależnie od preferencji powiadomień użytkownika. Musisz podać identyfikator użytkownika, identyfikator obiektu docelowego, treść powiadomienia oraz target_type, który określa, do czego monday.com prowadzi z powiadomienia.
Użyj target_type: "Post", gdy powiadomienie dotyczy aktualizacji lub odpowiedzi. Jako target_id podaj wtedy identyfikator aktualizacji lub odpowiedzi. Użyj target_type: "Project", gdy powiadomienie dotyczy elementu lub tablicy. Jako target_id podaj wtedy identyfikator elementu lub tablicy. Aby wysłać powiadomienie do siebie, najpierw wywołaj get_user_context lub list_users_and_teams z getMe: true, aby pobrać swój identyfikator użytkownika.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| user_id | string |
Tak | Identyfikator użytkownika, do którego chcesz wysłać powiadomienie. |
| target_id | string |
Tak | Identyfikator obiektu docelowego. Jeśli target_type ma wartość "Post", podaj identyfikator aktualizacji lub odpowiedzi. Jeśli ma wartość "Project", podaj identyfikator elementu lub tablicy. |
| text | string |
Tak | Treść powiadomienia. |
| target_type | string |
Tak | Kontekst linku w powiadomieniu. "Post" prowadzi do aktualizacji lub odpowiedzi, a "Project" - do elementu lub tablicy. |
Przykład
Wyślij powiadomienie do użytkownika 48202303 z linkiem do elementu 11971936030:
{
"user_id": "48202303",
"target_id": "11971936030",
"text": "Testing the MCP create_notification tool for documentation purposes.",
"target_type": "Project"
}
Narzędzie potwierdziło wysłanie powiadomienia do użytkownika 48202303 z podaną treścią.
Powiadom użytkownika o konkretnej aktualizacji:
{
"user_id": "66347492",
"target_id": "5179486006",
"text": "You were mentioned in an update on the Design homepage mockup item.",
"target_type": "Post"
}
Odpowiednik programistyczny
Aby uzyskać ten sam rezultat, użyj GraphQL API:
mutation {
create_notification(
user_id: 48202303
target_id: 11971936030
text: "Testing the create_notification mutation."
target_type: Project
) {
text
}
}
Pełną dokumentację znajdziesz w sekcji Powiadomienia.