FAQAPI

Webhooks API SMS.online

Webhooks ermöglichen es, automatisch Benachrichtigungen zu erhalten, wenn eine SMS auf einer virtuellen Nummer eingeht. Wenn die Webhook-Funktion in den Profileinstellungen aktiviert ist, sendet das System über einen POST-Request Informationen zur empfangenen SMS an die von Ihnen angegebene URL.

Nach dem Versand des Webhooks wartet der SMS.online-Server auf eine Antwort mit dem HTTP-Status 200 von Ihrem Skript. Wenn der Server keine Antwort mit dem Code 200 erhält, wird die Anfrage nicht erneut gesendet. In diesem Fall müssen Sie den Aktivierungsstatus der Nummer manuell anfordern.

Webhooks bieten eine automatische Datenübertragung in Echtzeit und sind ideal für die Integration mit externen Nachrichtensystemen.

Aktivierungs-Webhooks

JSON
{
	"activationId": 123456,
	"service": "go",
	"text": "Sms text",
	"code": "12345",
	"country": 0,
	"receivedAt": "2025-01-01 12:00:00"
}

Sie können diese Funktion in den Profileinstellungen aktivieren.

Miet-Webhooks

JSON
{ 
  "rentId": 123456, 
  "sms" : { 
    "phoneFrom" => 79999999999
    "text" => "Sms text",
    "date" => "2025-01-01 12:00:00"
  } 
}

Wichtig: Der in den Profileinstellungen angegebene Webhook wird bei der Anmietung von Nummern nicht verwendet. Für die Anmietung muss der Webhook-Link als Parameter uri bei der Erstellung der Anfrage angegeben werden. Dies ermöglicht eine flexible Verwaltung der Benachrichtigungsadressen für jede gemietete Nummer.