Eingehende Nachrichten (Rückrufe)

Wenn Benutzer eine eingehende Nachricht an Ihren Viber-Bot oder andere konfigurierte Kanäle senden, leitet SMSBAT diese Nachrichten per Webhook (Callback) an Ihren Server weiter.

Webhook-Format

Rückrufe werden über eine HTTP-POST-Anfrage mit einer JSON-Nutzlast an Ihre konfigurierte Webhook-URL gesendet.

Beispiel für den Anforderungstext

{
  "idUuid": "123e4567-e89b-12d3-a456-426614174000",
  "alphaName": "ViberBotName",
  "phoneNumber": "380936670003",
  "text": "Hello, I need help with my order",
  "dt": "2025-01-20T14:30:00.000Z"
}

Parameter

Feld	Geben Sie	ein Beschreibung
idUuid	Zeichenfolge	Eindeutiger Bezeichner für die eingehende Nachricht
alphaName	Zeichenfolge	Ihr Marken-/Botname, der die Nachricht erhalten hat
phoneNumber	Zeichenfolge	Die Telefonnummer des Absenders
Text	Zeichenfolge	Der Textinhalt der eingehenden Nachricht
dt	Datum/Uhrzeit	Zeitstempel des Empfangs der Nachricht

Konfiguration

So beginnen Sie mit dem Empfang eingehender Nachrichten: 1. Geben Sie Ihre Webhook-URL (HTTPS erforderlich) an Ihren SMSBAT Account Manager weiter oder konfigurieren Sie sie im Dashboard. 2. Ihr Endpunkt muss POST-Anfragen mit „Content-Type: application/json“ akzeptieren. 3. Ihr Server sollte nach erfolgreichem Empfang der Nutzlast mit „200 OK“ antworten.

Hinweis: Wenn Ihr Server nicht mit „200 OK“ antwortet oder eine Zeitüberschreitung auftritt, versucht SMSBAT möglicherweise, die Zustellung basierend auf Ihrer Kontokonfiguration erneut zu versuchen.