Informationen zu SMSHook

SMSHook ist der Kanal, über den Kunden ihre Versandinformationen erhalten. Nachdem der Benutzer eine E-Mail-Anfrage an EngageLab gesendet hat, gibt EngageLab das „Anfrageergebnis“ synchron an den Benutzer zurück, und das „Sendungsergebnis“ sowie „andere Ereignisergebnisse“ der E-Mail werden dem Benutzer asynchron über SMSHook bereitgestellt.

Verarbeitung von SMSHook

• EngageLab bietet Kunden verschiedene E-Mail-Ereignisse, denen sie folgen können.
• Wenn ein Ereignis auftritt, wird EngageLab ausgelöst und sendet (per POST) Daten an die vom Kunden festgelegte URL.
• Der von EngageLab gesendete Datentyp ist "Content Type: application/JSON".
• Der Kunde empfängt die Daten, analysiert das Ereignis und die Daten, und Sie müssen innerhalb von 3 Sekunden den HTTP-Statuscode 200 zurückgeben. Andernfalls sendet EngageLab die Nachricht erneut.

Verwendung

• Nutzer können eigene HTTP-Services schreiben, um entsprechende Ereignisse zu verarbeiten, relevante Daten zu analysieren und entsprechende URLs zu öffnen.
• Nutzer wählen im EngageLab-„SMSHook“ die zu überwachenden Ereignisse aus und konfigurieren die URL zum Empfangen der Daten.

Signaturüberprüfung

Um sicherzustellen, dass die Nachrichtenquelle tatsächlich EngageLab ist, können Sie die Sicherheitsauthentifizierung der POST-Datenquelle durchführen (Auch ohne Verifizierung ist es möglich, die POST-Daten direkt zu analysieren).

Die Methoden der Sicherheitsauthentifizierung sind wie folgt:

• Das APP SECRET über [Sende-Einstellungen] - [SMSHook] erhalten
• Den X-SMSHook Timestamp im Header auslesen
• Den X-SMSHook AppKey im Header auslesen
• Die X-SMSHook Signature im Header auslesen
• Einen signature-Wert mit md5 (timestamp+appkey+secret) generieren und mit der X-SMSHook Signature vergleichen

Antwortverarbeitung

Nach Erhalt des Callback von EngageLab muss der Entwicklerservice innerhalb von 3 Sekunden wie folgt antworten.

Erfolgreicher Empfang: Der HTTP-Statuscode muss 200 oder 204 zurückgeben und es muss keine Antwortnachricht angegeben werden.

Empfangsfehler: Der HTTP-Statuscode muss 5XX oder 4XX zurückgeben und gleichzeitig eine Antwortnachricht im folgenden Format liefern:

{"code":2002,"message":"failed"}

Retry-Verarbeitung

Bei einem URL-Zugriffsfehler oder Timeout versucht EngageLab maximal 7 Mal erneut zuzustellen. Die maximalen Zeitintervalle zwischen den Versuchen betragen 3min, 10min, 30min, 1h, 6h, 12h und 24h. Das bedeutet, Sie haben ausreichend Zeit, die URL zu reparieren, bevor die Nachricht verloren geht.

Wenn die Anzahl der erneuten Versuche überschritten wird, verwirft EngageLab die Nachricht.

Für jede Ereignisverarbeitung und Datenanalyse müssen Sie innerhalb von 3 Sekunden eine [Erfolgsantwort] zurückgeben. Andernfalls sendet EngageLab die Nachricht erneut.