SMS über Webhook empfangen
Onlinesim sendet eine Anfrage an Ihre URL
↓ POST
https:///newSmsLegen 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.


Eingehender Payload
Erforderlich
SMS-Payload, den Onlinesim an Ihre Webhook-URL sendet
Content-Type
application/jsonSchema
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_smsoperation_idintegerErforderlich
Vorgangs-ID (tzid)Beispiel:91763432user_idintegerErforderlich
ID Ihres ProfilsBeispiel:100001country_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:7numberstringErforderlich
Einzeldienst-Aktivierung: + und die vollständige Nummer oder hidden, wenn die Nummer nicht angezeigt wird. Miete: die vollständige Nummer in Ziffern, ohne +.Beispiel:+79001234567senderstringErforderlich
Name oder Nummer des Absenders. Bei Einzeldienst-Aktivierungen kann stattdessen der Dienstcode kommen (zum Beispiel vkcom).Beispiel:VKmessagestringErforderlich
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 codecodestringErforderlich
Im SMS-Text gefundener Bestätigungscode; leere Zeichenkette, wenn keiner gefunden wurdeBeispiel:195895time_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:55time_leftintegerErforderlich
Verbleibende Vorgangszeit: in Sekunden bei Einzeldienst-Aktivierungen, in Minuten bei der MieteBeispiel:880Beispiele
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"
}