Dokumentacja dla programistów
Ustawienia powiadomień
Dokumentacja API (rdzeń)Dokumentacja API
Powiadomienia monday.com odgrywają ważną rolę w informowaniu użytkowników o istotnej aktywności na koncie. Można je dostosowywać i zarządzać nimi w sekcji ustawień powiadomień platformy.
Zapytania
Pobieranie ustawień powiadomień
- Zwraca metadane dotyczące ustawień powiadomień użytkownika.
- Można wykonać tylko na poziomie głównym; nie można zagnieżdżać tego zapytania w innym zapytaniu.
query {
notifications_settings(
channels: [Email, Slack]
scope_type: AccountNewUserDefaults
) {
kind
description
is_for_admins_only
is_for_non_guests_only
channels {
name
enabled
editable_status
}
}
}
{
"data": {
"notifications_settings": [
{
"kind": "invitation",
"description": "Invitations to workspace, board, doc, item, or team",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "notify_auth_domain_signup",
"description": "Signed up with an email address from my account domain",
"is_for_admins_only": true,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "ask_for_permissions",
"description": "Requests access to boards & dashboards",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "invitation_requests_admins_reminder_setting",
"description": "Pending invite requests when invite requests have been pending for over 7 days",
"is_for_admins_only": true,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "mention",
"description": "Mentioned me in an update or reply",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": true,
"editable_status": "Editable"
}
]
},
{
"kind": "notify_invitee_join",
"description": "Signed up after I have invited them",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "dlp_file_deleted_setting",
"description": "File has been deleted for breaching data policies",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "new_post_on_owned_item",
"description": "Wrote an update on an item I own",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "like_your_post",
"description": "Reactions to my update",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "daily_digest",
"description": "My highlights",
"is_for_admins_only": false,
"is_for_non_guests_only": true,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "dlp_update_deleted_setting",
"description": "Update has been deleted or redacted for breaching data policies",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "request_to_install_and_purchase_apps",
"description": "Requests installation to install & purchase apps",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "notify_invitee_didnt_join",
"description": "Didn’t sign up after I have invited them",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "assign",
"description": "Assigned me to an item",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": true,
"editable_status": "Editable"
}
]
},
{
"kind": "new_post_on_subscribed_item",
"description": "Wrote an update on an item I’m subscribed to",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "automation",
"description": "Automations via an automation",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "api",
"description": "Platform API custom notifications using the GraphQL API",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "automation_product",
"description": "Automations with a \"notify\" step this does not include \"send an email\" automations",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "reply_your_reply",
"description": "Replied to a thread I commented on or reacted to",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "automation_system",
"description": "Automation failures when automations don’t run as expected",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "reply_your_post",
"description": "Replied to an update I wrote",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "template_update",
"description": "Template changes by the template owner",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
}
]
},
"extensions": {
"request_id": "YOUR_REQUEST_ID"
}
}
Argumenty
| Argument | Typ | Opis | Wartości enum |
|---|---|---|---|
| channels | [ChannelType!] |
Typ kanału powiadomień, według którego należy filtrować. | EmailMondaySlack |
| scope_id | Int |
Unikalny identyfikator użytkownika, dla którego mają zostać pobrane wyniki. Tego argumentu należy używać razem z argumentem typu zakresu User. Domyślnie jest to aktualnie zalogowany użytkownik. |
|
| scope_type | ScopeType! |
Typy zakresu ustawień powiadomień, według których należy filtrować. | AccountNewUserDefaultsUser (prywatne ustawienia użytkownika) |
| setting_kinds | [String!] |
Nazwa typu ustawień powiadomień, według którego należy filtrować. |
Pola
| Pole | Typ | Opis |
|---|---|---|
| channels | [NotificationSettingChannel!]! |
Dostępne kanały dla danego ustawienia powiadomień. |
| description | String |
Opis ustawień powiadomień. |
| is_for_admins_only | Boolean |
Określa, czy ustawienie powiadomień mogą konfigurować tylko administratorzy. |
| is_for_non_guests_only | Boolean |
Określa, czy ustawienie powiadomień dotyczy tylko osób niebędących gośćmi. |
| kind | String |
Typ ustawień powiadomień. |