profile

SMS über Webhook empfangen

Onlinesim sendet eine Anfrage an Ihre URL

↓ POSThttps:///newSms

Legen Sie in den Einstellungen Ihres Profils (oder mit webhook_url von profile.php) eine URL fest, und jede von Ihren Nummern empfangene SMS wird als JSON-POST an sie gesendet.

Funktioniert sowohl für Einzeldienst-Aktivierungen als auch für die Miete.

Webhook

Eingehender Payload

Erforderlich

SMS-Payload, den Onlinesim an Ihre Webhook-URL sendet

Content-Typeapplication/json
Schema
schemaobjectBody des Webhooks newSms (dasselbe Objekt ist params in webhook-logs). Alle Felder sind immer vorhanden.
webhook_typestringErforderlich
receiving_sms — Einzeldienst-Aktivierung, rent_sms — MieteEnumeration:receiving_smsrent_sms
operation_idintegerErforderlich
Vorgangs-ID (tzid)Beispiel:91763432
user_idintegerErforderlich
ID Ihres ProfilsBeispiel:100001
country_codeintegerErforderlich
Vorwahl des Landes der Nummer, siehe Spalte Code der Länderliste. Bei Einzeldienst-Aktivierungen kann es ein interner Code eines speziellen Nummernpools sein (zum Beispiel 1000).Beispiel:7
numberstringErforderlich
Einzeldienst-Aktivierung: + und die vollständige Nummer oder hidden, wenn die Nummer nicht angezeigt wird. Miete: die vollständige Nummer in Ziffern, ohne +.Beispiel:+79001234567
senderstringErforderlich
Name oder Nummer des Absenders. Bei Einzeldienst-Aktivierungen kann stattdessen der Dienstcode kommen (zum Beispiel vkcom).Beispiel:VK
messagestringErforderlich
SMS-Text. Bei der Miete wird eine SMS von einem Absender, den der Dienst nicht annimmt, durch einen Hinweistext ersetzt.Beispiel:VK: 195895 is your code
codestringErforderlich
Im SMS-Text gefundener Bestätigungscode; leere Zeichenkette, wenn keiner gefunden wurdeBeispiel:195895
time_startstringErforderlich
Einzeldienst-Aktivierung: Zeitpunkt der Bestellung des Vorgangs. Miete: Zeitpunkt des SMS-Empfangs. Format YYYY-MM-DD HH:MM:SS.Beispiel:2026-04-26 12:37:55
time_leftintegerErforderlich
Verbleibende Vorgangszeit: in Sekunden bei Einzeldienst-Aktivierungen, in Minuten bei der MieteBeispiel:880

Beispiele

Incoming SMS

SMS einer Einzeldienst-Aktivierung

{
  "user_id": 100001,
  "country_code": 7,
  "number": "+79001234567",
  "sender": "VK",
  "message": "VK: 195895 is your code",
  "time_start": "2026-04-26 12:37:55",
  "time_left": 880,
  "operation_id": 91763432,
  "webhook_type": "receiving_sms",
  "code": "195895"
}

Antwort Ihres Servers

200Antworten Sie mit HTTP 200, um den Empfang zu bestätigen