Abgemeldete Nummern

Wenn Sie versuchen, eine Nachricht zu senden zu eine Nummer, die den Empfang von Nachrichten von der Nummer, die Sie senden, abgelehnt hat vonwird die Nachricht für den Versand gesperrt, und Sie erhalten eine Fehlerantwort in der Zustellungsbestätigung (SMS API) oder im Status-Webhook (Messages API).

SMS API

Wenn Sie versuchen eine SMS-Nachricht über die SMS API senden wobei die Nummer, die als to Nummer hat sich gegen den Empfang von Nachrichten von der Nummer entschieden, die als fromsollten Sie zunächst eine HTTP-Antwort mit einem Statuscode von 200und status im Antwortkörper mit einem Wert von 0. Dies zeigt an, dass die Nachricht erfolgreich übermittelt wurde. eingereicht für die Zustellung. Sie sollten jedoch anschließend eine POST Anfrage an die Webhook-Adresse, die Sie für den Empfang von Lieferscheine. Der Text der Anfrage enthält eine status Feld mit einem Wert von failed oder rejectedund ein err-code Feld mit einem Wert von 9. Diese Fehlercode zeigt an, dass der Benutzer beantragt hat, keine Nachrichten von der sendenden Nummer zu erhalten.

Beispiel Lieferscheinkörper

{
   "msisdn": "447700900000",
   "to": "AcmeInc",
   "network-code": "12345",
   "messageId": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
   "price": "0.00000000",
   "status": "failed",
   "scts": "2001011400",
   "err-code": "9",
   "api-key": "abcd1234",
   "message-timestamp": "2020-01-01 12:00:00"
}

Messages API

Wenn Sie versuchen eine SMS- oder MMS-Nachricht über die Messages API senden wobei die als a eingestellte Zahl die to Nummer hat sich gegen den Empfang von Nachrichten von der Nummer entschieden, die als fromsollten Sie zunächst eine HTTP-Antwort mit einem Statuscode von 202und message_uuid Feld im Antwortkörper mit einem Wert für die eindeutige UUID der Nachricht. Dies zeigt an, dass die Nachricht erfolgreich übermittelt wurde. eingereicht für die Zustellung. Sie sollten jedoch anschließend eine POST Anfrage an die Webhook-Adresse, die Sie für den Empfang von Status-Webhooks. Der Text der Anfrage enthält eine message_uuid mit einem Wert, der mit der UUID in der ursprünglichen HTTP-Antwort identisch ist. Der Body der Anfrage enthält außerdem ein status Feld mit einem Wert von rejected ein Fehlerfeld, das ein Objekt mit Einzelheiten über warum die Nachricht wurde abgelehnt. In diesem Fall sollte das Objekt eine title Feld Fehlercode von 1240. Dies zeigt an, dass der Benutzer beantragt hat, keine Nachrichten von der sendenden Nummer zu erhalten.

Beispiel Message Status Webhook Body

{
   "message_uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
   "to": "447700900000",
   "from": "447700900001",
   "timestamp": {},
   "status": "rejected",
   "error": {
      "type": "https://developer.vonage.com/api-errors/messages-olympus#1240",
      "title": 1240,
      "detail": "Illegal Number - You tried to send a message to a blocklisted phone number. That is, the user has already sent a STOP opt-out message and no longer wishes to receive messages from you.",
      "instance": "bf0ca0bf927b3b52e3cb03217e1a1ddf"
   },
   "usage": {
      "currency": "EUR",
      "price": "0.0000"
   },
   "client_ref": "string",
   "channel": "sms",
   "destination": {
      "network_code": "12345"
   },
   "sms": {
      "count_total": "1"
   }
}