Aplikacja Emails & Activities (E&A) pomaga klientom monday.com CRM zarządzać komunikacją z klientami w jednym miejscu. Każdy kontakt jest rejestrowany i śledzony na osi czasu aplikacji. Dzięki temu ważne informacje i aktualizacje są łatwo dostępne.

Zapytania

Pobieranie elementu osi czasu

• Zwraca tablicę zawierającą metadane nowo utworzonych elementów na osi czasu E&A.
• Można je wykonywać tylko bezpośrednio na poziomie głównym - nie można ich zagnieżdżać w innym zapytaniu.

query {
  timeline_item(
    id: 1234567890
    ) {
    board {
      id
    }
    item {
      name
    }
    id
    user {
      id
      name
    }
    title
    type
    content
    created_at
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($timelineId: ID!) { timeline_item (id: $timelineId) { title type content created_at } }`;
const variables = {
  timelineId: 1234567890,
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
id	ID!	Unikatowy identyfikator elementu osi czasu do zwrócenia.

Pola

Pole	Typ	Opis
board	Board	Tablica, na której znajduje się element osi czasu.
content	String	Treść elementu osi czasu.
created_at	Date!	Data utworzenia elementu osi czasu.
custom_activity_id	String	Unikatowy identyfikator niestandardowej aktywności elementu osi czasu.
id	ID	Unikatowy identyfikator elementu osi czasu.
item	Item	Element, na którym znajduje się element osi czasu.
title	String	Tytuł elementu osi czasu.
type	String	Typ elementu osi czasu. Zawsze zwraca "activity".
user	User	Użytkownik, który utworzył element osi czasu.

Mutacje

Tworzenie elementu osi czasu

Tworzy nowy element osi czasu w aplikacji E&A. Zwraca obiekt TimelineItem.

Obecnie jedynym sposobem na pobranie identyfikatora osi czasu jest wysłanie zapytania o ten identyfikator. Nie można go znaleźć w interfejsie.

mutation {
    create_timeline_item (
    item_id: 9876543210,
    custom_activity_id: "8ca12626-7aeb-3ca7-7z1a-8ebdda488cd2",
    title: "Migrated Email",
    summary: "internal company email",
    content: "From: saarar@monday.com <br> To: asi@monday.com [Asi Monday], yoni@monday.com [Yoni Monday] <br> Subject: Deploy our first alpha version <br><br>Hey guys, <br>We are ready to deploy our first alpha version and enable<br>our clients to migrate into E&A!<br><br>Best regards,<br> Saar",
    timestamp: "2024-06-06T18:00:30Z",
    time_range: {
     start_timestamp: "2024-05-06T18:00:30Z", 
     end_timestamp: "2024-05-06T19:00:30Z"
    }
 ) {
  id
 }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `mutation ($item_id: ID!, $custom_activity_id: String!, $title: String!, $summary: String!, $timestamp: ISO8601DateTime!, $time_range: TimelineItemTimeRange!, $content: String!) { create_timeline_item (item_id: $item_id, custom_activity_id: $custom_activity_id, title: $title, summary: $summary, content: $content, time_range: $time_range, timestamp: $timestamp ) {
  id
 }
}`;
const variables = {
  item_id: 9876543210,
  custom_activity_id: "8ca12626-7aeb-3ca7-7z1a-8ebdda488cd2",
  title: "Migrated Email",
  summary: "internal company email",
  content: "From: saarar@monday.com <br> To: asi@monday.com [Asi Monday], yoni@monday.com [Yoni Monday] <br> Subject: Deploy our first alpha version <br><br>Hey guys, <br>We are ready to deploy our first alpha version and enable<br>our clients to migrate into E&A!<br><br>Best regards,<br> Saar",
    timestamp: "2024-06-06T18:00:30Z",
  time_range: {
    start_timestamp: "2024-05-06T18:00:30Z", 
    end_timestamp: "2024-05-06T19:00:30Z"
   }
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
content	String	Treść nowego elementu osi czasu.
custom_activity_id	String!	Identyfikator niestandardowej aktywności nowego elementu osi czasu.
item_id	ID!	Identyfikator elementu, na którym ma zostać utworzony nowy element osi czasu.
location	String	Lokalizacja, którą chcesz dodać do nowego elementu osi czasu. Ta wartość nie jest sprawdzana pod kątem zgodności z lokalizacją.
phone	String	Numer telefonu, który chcesz dodać do nowego elementu osi czasu. Ta wartość nie jest sprawdzana pod kątem zgodności z numerem telefonu.
summary	String	Podsumowanie nowego elementu osi czasu. Maksymalna długość to 255 znaków.
timestamp	ISO8601DateTime!	Czas utworzenia nowego elementu osi czasu.
time_range	TimelineItemTimeRange	Czas rozpoczęcia i zakończenia nowego elementu osi czasu.
title	String!	Tytuł nowego elementu osi czasu. Maksymalna długość to 255 znaków.
url	String	Adres URL, który chcesz dodać do nowego elementu osi czasu.

Usuwanie elementu osi czasu

Usuwa element osi czasu z aplikacji E&A. Zwraca obiekt TimelineItem.

mutation {
  delete_timeline_item (id: "1234567890") {
    id
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `mutation ($timelineId: String!) {
  delete_timeline_item (id: $timelineId) {
    id
  }
}`;
const variables = {
  timelineId: "1234567890",
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
id	String!	Unikatowy identyfikator elementu osi czasu do usunięcia.

Obsługa błędów

Listę typowych błędów, strategii ponawiania prób i przykładów rozwiązywania problemów znajdziesz w sekcji obsługi błędów API.

Podczas wywoływania timeline_item, create_timeline_item lub delete_timeline_item mogą czasami wystąpić standardowe błędy GraphQL lub HTTP. Oto najczęstsze kategorie błędów, które warto sprawdzić:

Typ błędu	Opis	Następne kroki
Błąd uprawnień lub współpracownika	Wywołujący nie ma dostępu do aplikacji Emails & Activities ani do tablicy lub elementu.	Użyj tokenu powiązanego z kontem, które ma dostęp do aplikacji E&A oraz odpowiedniej tablicy lub elementu.
Błąd walidacji	Zapytanie lub mutacja zawiera nieprawidłowe argumenty, brakujące pola lub jest nieprawidłowo zagnieżdżone.	Upewnij się, że wymagane argumenty (np. id, item_id, custom_activity_id) są podane i mają prawidłowy format. summary nie może przekraczać 255 znaków.
Nie znaleziono	Podany element osi czasu lub identyfikator elementu nie istnieje albo nie jest widoczny.	Sprawdź, czy identyfikatory są poprawne i czy element osi czasu istnieje na docelowym elemencie.
Błąd limitu żądań	W krótkim czasie wysłano zbyt wiele żądań.	Poczekaj i ponów próbę po czasie określonym w nagłówku Retry-After, jeśli został zwrócony.
Błąd serwera lub sieci	Tymczasowa awaria lub problem z połączeniem.	Ponów próbę, stopniowo wydłużając czas oczekiwania. Jeśli problem nie ustąpi, skontaktuj się z pomocą techniczną monday.com i podaj request_id.