# Was ändert sich mit dem neuen System in der sipgate REST API und bei sipgate.io?

Im September 2025 hat sipgate ein neues System für Endkunden veröffentlicht. Alle seit September 2025 neu angelegten Accounts laufen bereits über dieses neue System, ältere Accounts, die bereits vor September 2025 existiert haben, sollen schrittweise migriert werden. Die Umstellung hat auch Auswirkungen auf das Verhalten der sipgate REST API und sipgate.io. Alle Änderungen, die die REST API und sipgate.io betreffen, werden in dem nachfolgenden Artikel ausführlich beschrieben.

#### **Account-Type** <a href="#h_01kj9v44v5dbz56rt2ttmyfyjk" id="h_01kj9v44v5dbz56rt2ttmyfyjk"></a>

Der Account-Type ist einerseits in der Weboberfläche einsehbar und technisch im JSON-Web-Token angegeben. Im Feld *featureScope* steht entweder "CLASSIC\_PBX" oder "NEO\_PBX".

#### **History** <a href="#h_01k8t4q155wfbm80ywka2yycxx" id="h_01k8t4q155wfbm80ywka2yycxx"></a>

Ereignisse wie Fax und SMS können **für Neukunden** in der Weboberfläche eingesehen werden und bleiben über die History-Endpunkte abrufbar. Anrufereignisse sind über diese Endpunkte zukünftig nicht mehr verfügbar, eine Anfrage wird ein leeres Ergebnis zurückgeben. Stattdessen werden Anrufereignisse, sowohl eingehende als auch ausgehende, im Channel hinterlegt und per API über den Channel-Endpunkte GET /channels/{channelId}/events angeboten.

**Für migrierte Bestandskunden** mit einem sipgate Neo Account, werden Anrufereignisse zusätzlich in die gewohnte Ereignisliste der Weboberfläche geschrieben und stehen damit zunächst auch weiterhin über die bisherigen History-Endpunkte zur Verfügung.

#### **Push API** <a href="#h_01kb22wjn2mjmnk4tn9v66x4ep" id="h_01kb22wjn2mjmnk4tn9v66x4ep"></a>

Die Push-API wurde für sipgate Neo erweitert und unterstützt dort eingehende und ausgehende Channel-Anrufe. Die Webhook-Konfiguration erfolgt weiterhin im Appweb. Dort können Sie festlegen, für welche Channels Webhooks ausgelöst werden sollen.

Mit sipgate Neo können nur noch **HTTPS Webhooks** konfiguriert werden.

#### **Devices** <a href="#h_01kj9sp7f5j8zqb3acf0qjd7qr" id="h_01kj9sp7f5j8zqb3acf0qjd7qr"></a>

| **Endpunkt** (api.sipgate.com/v2) | **Beschreibung**                                                                                                                                                  |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GET /{userId}/devices             | Erweitert um den Query-Parameter ***type*** und die Ausgabe der App-Extension. Mögliche Werte als comma-separierte Liste: *all, app, register, mobile, external*. |

#### **RTCM - Real Time Call Manipulation** <a href="#docs-internal-guid-106e252b-7fff-313f-cf98-259a948f6e61" id="docs-internal-guid-106e252b-7fff-313f-cf98-259a948f6e61"></a>

Die RTCM Endpunkte werden im Backend funktional erweitert, sodass eine Steuerung der neuen Channel-Calls mit den bestehenden Endpunkten möglich bleibt. Die Response-Struktur bleibt zum Zweck der Kompatibilität bestehen.

| **Endpunkt**                       | **Stand für sipgate Neo** | **Informationen**                                                                                                                                                                                                                    |
| ---------------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| GET /calls                         | In Bearbeitung            | BETA: Calls zum Default Channel des Devices starten ist möglich. Channel-Inbox-Events und Auswahl des Channels ist in Bearbeitung. Das Starten eines Calls auf einem externen Telefon (X-Extension) ist zur Zeit noch nicht möglich. |
| POST /calls/{callId}/dtmf          | Umgesetzt                 | Geänderter HTTP Response Status Codes: Leerer Request-Body: Classic = 400 Bad Request, Neo = 204 No Content                                                                                                                          |
| PUT /calls/{callId}/hold           | Umgesetzt                 |                                                                                                                                                                                                                                      |
| PUT /calls/{callId}/recording      | Umgesetzt                 | Analog zum Starten/Stoppen eines Recordings mit **\*6**. Das Announcement "*Aufnahme wird gestartet*" wird immer eingespielt.                                                                                                        |
| POST /calls/{callId}/transfer      | Umgesetzt                 | Attended und unattended Transfer.                                                                                                                                                                                                    |
| PUT /calls/{callId}/mute           | In Prüfung                | Die Nutzung des Endpunkts wird zur Zeit geprüft.                                                                                                                                                                                     |
| DELETE /calls/{callId}             | Umgesetzt                 |                                                                                                                                                                                                                                      |
| POST /calls/{callId}/announcements | Keine Umsetzung           | Eine Erweiterung dieses Endpunkts für sipgate Neo ist bisher nicht vorgesehen.                                                                                                                                                       |

#### **Channels** <a href="#h_01k8t4761f4e14kak8z12vjc5x" id="h_01k8t4761f4e14kak8z12vjc5x"></a>

Channels lösen Gruppen (groups) und die bisher bekannten persönlichen Routings (phonelines) ab.

Mit sipgate Neo stehen Telefonate immer in Bezug zu einem Channel. Um diese Referenz herzuleiten, stehen aktuell folgende Endpunkte zur Verfügung:

| **Endpunkt** (api.sipgate.com/v2)                | **Beschreibung**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GET /channels                                    | Die Channels eines Accounts abrufen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| GET /channels/{channelId}/events                 | Die Anrufereignisse eines Channels abrufen. Nur berechtigte Nutzer (Channel-Mitglieder bzw. Admins bei nicht-privaten Channels) können auf die Events zugreifen. Für die Navigation durch größere Event-Mengen verwenden Sie den position-Parameter: 1. Die initiale Request liefert die ersten Events und einen **position-Wert** 2. Übergeben Sie diesen **position-Wert** im nächsten Request, um die nächste Seite abzurufen 3. Die Position markiert dabei den Startpunkt ("start after") - das Event mit diesem Key wird nicht erneut zurückgegeben |
| PUT /channels/{channelId}/users                  | Die Userliste eines Channels setzen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| PUT /channels/{channelId}/users/{userId}/devices | Für einen User die Liste der Geräte setzen, mit denen er im Channel vertreten sein soll.                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| PUT /channels/{channelId}/name                   | Den Namen eines Channels setzen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| DELETE /channels/{channelId}                     | Einen Channel löschen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

Entnehmen Sie den Plan zur Erweiterung der Channel-Endpunkte der Feature-Roadmap auf: [https://feedback.sipgate.de](https://feedback.sipgate.de/).

#### **Fax** <a href="#h_01kjfn6nvktwgw54sf4efp9r76" id="h_01kjfn6nvktwgw54sf4efp9r76"></a>

Die Gruppenfaxe fallen weg. Bestehende Faxanschlüsse werden bei der Neo-Account-Migration entsprechend in einen globalen Faxanschluss umgestellt. Für die Nutzung der REST API fallen die /groupfaxlines -Endpunkte deshalb weg. Stattdessen stehen die /{userId}/faxlines -Endpunkte zur Verfügung. An neuen Endpunkten die eine globale Sicht auf Faxanschlüsse bietet, wird zur Zeit gearbeitet.