Widerruf von RCS-Nachrichten
Wenn Sie eine RCS-Nachricht über die Vonage Messages API senden, können Sie anschließend beantragen, dass diese Nachricht widerrufen wird (d. h. nicht an das Gerät des Empfängers durch das nachgelagerte Netzwerk zugestellt wird).
Der Widerruf einer RCS-Nachricht wird eingeleitet durch eine PATCH Anforderung an den Messages API-Endpunkt für das Nachrichtenobjekt, das von der ursprünglichen POST Anfrage, um die Nachricht zu senden. Das Nachrichtenobjekt wird durch seine UUID identifiziert (diese wird in der Antwort auf die POST Anforderung, die das Nachrichtenobjekt erstellt).
Die PATCH Anfrage sollte eine JSON Körper, der den Wert von status zu "widerrufen".
Weitere Einzelheiten zur Messages API finden Sie unter PATCH Endpunkt in der Messages API-Spezifikation und sehen Sie sich ein Codebeispiel für die PATCH Anfrage im Messages API Code-Schnipsel
Die Wahl des richtigen Endpunkts
So senden Sie eine RCS-Nachrichten-Widerrufsanfrage an die Messages API PATCH Endpunktmüssen Sie die richtige Bezeichnung verwenden. geografisch ausgerichteter Server für die Anfrage. Dies hängt von dem Land ab, in dem der RCS-Agent gestartet wurde. In der nachstehenden Tabelle finden Sie einen Leitfaden für den zu verwendenden Server.
| Region | Server | Beispiel-Länder |
|---|---|---|
| EMEA (Europa, Naher Osten und Afrika) | api-eu.nexmo.com | Frankreich, Spanien, Portugal, Südafrika, Nigeria, Norwegen, Schweden, Niederlande, Österreich, Deutschland, Vereinigtes Königreich, Italien |
| NA + LATAM (Nordamerika und Südamerika) | api-us.nexmo.com | Mexiko, Brasilien, Kanada |
| APAC (Asien-Pazifik) | api-ap.nexmo.com |
Zu beachtende Dinge
- Die Beantragung eines Widerrufs ist keine Garantie dafür, dass eine Nachricht widerrufen (d. h. nicht zugestellt) wird. Beispielsweise kann die Nachricht bereits zugestellt worden sein oder es ist nicht möglich, sie auf andere Weise zu widerrufen.
- Ein Antrag auf Widerruf kann nur innerhalb von 24 Stunden nach Erstellung des ursprünglichen Nachrichtenobjekts gestellt werden.