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.
History
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 über die noch im Aufbau befindenden Channel-Endpunkte angeboten. (Verfolgen Sie die Umsetzung auf https://feedback.sipgate.de/ und ergänzen Sie gerne Ihre fehlenden Bedürfnisse als Feature-Wunsch.)
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
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.
RTCM - Real Time Call Manipulation
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 | Geplant |
|
| POST /calls/{callId}/dtmf | Umgesetzt |
Geänderter HTTP Response Status Codes: Leerer Request-Body:
|
| 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 | Geplant |
|
| PUT /calls/{callId}/mute | In Prüfung |
|
| DELETE /calls/{callId} | Umgesetzt |
|
| POST /calls/{callId}/announcements | Keine Umsetzung |
Eine Erweiterung dieses Endpunkts für sipgate Neo ist bisher nicht vorgesehen. |
Channels
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:
|
| 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.