Powiadomienia informują użytkowników o aktywności na platformie, takiej jak terminy, aktualizacje i inne zdarzenia. Pojawiają się w kilku miejscach, między innymi pod ikoną dzwonka i w wiadomościach e-mail.

Powiadomienia dotyczące wyłącznie zalogowanego użytkownika pojawiają się pod ikoną dzwonka. Domyślnie użytkownik otrzymuje również wiadomość e-mail za każdym razem, gdy dostanie powiadomienie. Można to wyłączyć i dostosować w ustawieniach profilu użytkownika.

Zapytania

Pobieranie powiadomień

• Zwraca metadane dotyczące powiadomień użytkownika.
• Można je wykonywać tylko bezpośrednio na głównym poziomie zapytania - nie można ich zagnieżdżać w innym zapytaniu.

query {
  notifications(filter_read: true) {
    text
    title
    id
  }
}

{
  "data": {
    "notifications": [
      {
        "text": "This is a notification",
        "title": "New test notification",
        "id": "123456"
      }
    ]
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Pola

Mutacje

Wymagany zakres:notifications:write

Tworzenie powiadomienia

Wysyła powiadomienie przez API, które pojawia się pod ikoną dzwonka. Może również wysłać wiadomość e-mail, jeśli preferencje e-mail odbiorcy są odpowiednio skonfigurowane.

Jeśli wyślesz powiadomienie z widoku tablicy lub widżetu przy użyciu uwierzytelniania bez interakcji, zostanie ono wysłane z aplikacji i będzie wyświetlać jej nazwę oraz ikonę. Jeśli użyjesz osobistego klucza API, powiadomienie będzie wyglądać tak, jakby wysłał je użytkownik, który zainstalował aplikację na koncie.

Ta mutacja tylko wysyła powiadomienie. Ponieważ powiadomienia są przetwarzane asynchronicznie, podczas wykonywania mutacji nie można pobrać identyfikatora powiadomienia.

mutation {
  create_notification(
    user_id: 12345678
    target_id: 674387
    text: "This is a notification"
    target_type: Project
  ) {
    text
  }
}

Argumenty