Termine in CentralStationCRM

API Navigation

Allgemeines: Grundlagen Authentifizierung Fehlerbehandlung Datenstruktur

Hauptmodelle: Personen Firmen Angebote Projekte Aufgaben

Sonstiges: Anschriften Kontaktdaten Wichtige Daten Individuelle Felder Positionen Notizen Dateianhänge Tags Termine Termin-Teilnehmer

Die Kür: Webhooks Nutzer Aktivitäten Filter Gruppen Individuelle Feld Typen Kalender

CalEvents verhalten sich von den Actions (index, show, create, update, delete) her wie die Personen. Die Teilnehmer eines Termins können über die Termin-Teilnehmer abgefragt und geändert werden.
Es stehen folgende Felder zur Verfügung:

Feldname Feldtyp Beschreibung
id VARCHAR(36) ID des CalEvents (Read only)
account_id INTEGER ID des Accounts (Read only)
user_id INTEGER ID des verantwortlichen Nutzers (Pflichtfeld)
updated_by_user_id INTEGER ID des Nutzers, der den Termin zuletzt aktualisiert hat
attachable_id INTEGER ID des verknüpften Objektes, zum Beispiel Person, Firma, Angebot oder Projekt.
attachable_type VARCHAR(20) Typ des verknüpften Objektes, z.B. Person, Company, Deal oder Project.
group_calendar_id VARCHAR(36) ID des verknüpften Kalenders. (Pflichtfeld)
name VARCHAR(255) Name des Termins (Pflichtfeld)
location VARCHAR(255) Standort des Termins
starts_at TIMESTAMP Anfangszeitpunkt des Termins
ends_at TIMESTAMP Endzeitpunkt des Termins
status VARCHAR(20) Status des Termins: new oder confirmed.
all_day BOOLEAN true bei einem ganztägigen Termin.
email_invitations BOOLEAN true, wenn E-Mail Einladungen automatisch über das System verschickt werden sollen.
description TEXT Ausführlicher Beschreibungstext zum Termin.
created_at TIMESTAMP Zeitpunkt der Erstellung (automatisch gesetzt, read only)
updated_at TIMESTAMP Zeitpunkt des letzten Updates (automatisch gesetzt, read only)

CalEvents verfügen außerdem über verschachtelte Routen. Ein Aufruf dieser Ressourcen erfolgt, wie in dem kommenden Beispiel beschrieben.


curl -X GET https://accountname.centralstationcrm.net/api/cal_events.json?state=upcoming&includes=group_calendar%20cal_event_attendees

[
{
cal_event: {
id: "518c26ee-c57a-11e9-999a-dca90488cbdd",
account_id: 21,
user_id: 64,
updated_by_user_id: null,
attachable_id: null,
attachable_type: "",
group_calendar_id: "22d049d0-5b98-11e4-a6ed-0015174fb400",
name: "lunch w best team",
location: "office",
starts_at: "2019-08-29T13:00:00.000Z",
ends_at: "2019-08-29T14:00:00.000Z",
status: "confirmed",
all_day: false,
email_invitations: false,
description: "",
created_at: "2019-08-23T07:47:55.000Z",
updated_at: "2019-08-23T07:47:55.000Z",
group_calendar: {
id: "22d049d0-5b98-11e4-a6ed-0015174fb400",
read_only: true,
name: "Meetings",
color_type: "eight"
},
cal_event_attendees: [
{
id: "5191eade-c57a-11e9-999a-dca90488cbdd",
cal_event_id: "518c26ee-c57a-11e9-999a-dca90488cbdd",
user_id: 64,
person_id: 4662,
email: "hilfe@centralstationcrm.de",
status: "accepted",
created_at: "2019-08-23T07:47:55.000Z",
updated_at: "2019-08-23T07:47:55.000Z"
},
{
id: "5192da84-c57a-11e9-999a-dca90488cbdd",
cal_event_id: "518c26ee-c57a-11e9-999a-dca90488cbdd",
user_id: 4984,
person_id: 640364,
email: "",
status: "no_invite",
created_at: "2019-08-23T07:47:55.000Z",
updated_at: "2019-08-23T07:47:55.000Z"
},
{
id: "51932d54-c57a-11e9-999a-dca90488cbdd",
cal_event_id: "518c26ee-c57a-11e9-999a-dca90488cbdd",
user_id: 1781,
person_id: 235321,
email: "maeh@jolly-demo.kg",
status: "no_invite",
created_at: "2019-08-23T07:47:55.000Z",
updated_at: "2019-08-23T07:47:55.000Z"
}
]
}
}
]