Webhook V2 - Verwandeln Sie jedes mobile Ereignis in eine sofortige Aktion
Wir stellen **Webhook V2** vor, eine wichtige Weiterentwicklung des SMSMobileAPI Webhook-Systems.
Bisher konzentrierten sich Webhooks hauptsächlich auf eingehende SMS-Nachrichten. Mit Webhook V2 wird SMSMobileAPI zu einer kompletten **event-gesteuerten mobilen Kommunikationsplattform**, die es Ihren Anwendungen ermöglicht, automatisch auf SMS, Anrufe, WhatsApp-Nachrichten, Sprachtranskriptionen und E-Mail-Aktivitäten zu reagieren.
Anstatt den API wiederholt zu überprüfen, ob sich etwas geändert hat, kann Ihre Anwendung jetzt automatisch strukturierte HTTPS-Ereignisse erhalten, sobald die unterstützte Aktivität auftritt.
### 15 Webhook-Events
Webhook V2 führt präzise Ereignisnamen ein, die die wichtigsten Kommunikationskanäle abdecken, die über SMSMobileAPI verfügbar sind.
****SMS**
* `sms.api.submitted` — Eine SMS-Versandanforderung wurde über die API eingereicht.
* `sms.sent` — Das angeschlossene Handy bestätigte, dass das SMS gesendet wurde.
* `sms.failed` — Eine SMS-Sendeoperation ist fehlgeschlagen.
* `sms.received` — Ein neues eingehendes SMS wurde synchronisiert.
* `sms.mobile.sent` — Ein SMS wurde manuell vom angeschlossenen Mobilgerät gesendet.
**Anrufe**
* `call.missed` – Ein verpasster Anruf wurde erkannt.
* `call.incoming` — Ein eingehender Anruf wurde synchronisiert.
* `call.outgoing` — Ein ausgehender Anruf wurde synchronisiert.
****WhatsApp**
* `whatsapp.submitted` — Ein WhatsApp-Versandauftrag wurde erstellt.
* `whatsapp.sent` — Eine WhatsApp-Nachricht wurde erfolgreich gesendet.
* `whatsapp.failed` – Ein WhatsApp-Sendevorgang ist fehlgeschlagen.
* `whatsapp.received` — Eine neue WhatsApp-Nachricht wurde abgerufen.
* `whatsapp.voice.transcribed` — Eine WhatsApp Sprachnachricht wurde in Text umgewandelt.
**E-Mail****
* `email.sent` — Eine E-Mail-Versandanforderung wurde erstellt.
* `email.received` — Eine angeschlossene Mailbox hat eine neue E-Mail erhalten.
### Mehrere Webhook-Ziele
Sie sind nicht mehr auf einen einzigen Webhook-Endpunkt beschränkt.
Webhook V2 ermöglicht es Ihnen, **mehrere unabhängige Ziele** zu erstellen und genau zu entscheiden, welche Ereignisse jedes Ziel erhalten soll.
Sie können beispielsweise senden:
* Eingehende SMS und WhatsApp Nachrichten an Ihre CRM.
* Verpasste Anrufe an Ihr Kunden-Support-System.
* Fehlgeschlagene Lieferungen von SMS und WhatsApp an Ihre Überwachungsplattform.
* Kommunikationsereignisse zu Ihrem Analysesystem.
* Ausgewählte Ereignisse für Ihre eigene Automatisierung oder AI Workflow.
Jedes Ziel ist unabhängig voneinander.
### Selektives Ereignis-Routing
Jedes Webhook-Ziel kann nur die Ereignisse abonnieren, die es benötigt.
Dies macht Integrationen sauberer und verhindert, dass Ihre Anwendung unnötige Ereignisse erhält.
Ein CRM konnte nur abonnieren:
`sms.received
`call.missed
`whatsapp.received
während ein Betriebsüberwachungssystem nur Folgendes abonnieren könnte:
`sms.failed
`whatsapp.failed
### Zuverlässige asynchrone Lieferung
Webhook V2 verwendet eine **dauerhafte Lieferwarteschlange**.
Ereignisse werden vor der Lieferung gespeichert und asynchron verarbeitet, was bedeutet, dass Ihr SMSMobileAPI-Workflow nicht warten muss, bis ein Server eines Drittanbieters reagiert.
Wenn ein Ziel langsam oder nicht verfügbar wird, werden andere Ziele oder andere Konten nicht blockiert.
### Automatische Versuchsreihen
Temporäre Endpunktfehler werden automatisch mit progressiven Verzögerungen wiederholt.
Webhook V2 verwendet **at-least-once Lieferung **, so dass ein Ereignis gelegentlich mehr als einmal geliefert werden kann.
Jedes Ereignis enthält daher einen stabilen Ereignis-Kennzeichen, das Ihre Anwendung speichern und als idempotency Schlüssel verwenden kann, um doppelte Verarbeitung zu verhindern.
### Signierte und überprüfbare Webhook-Anfragen
Sicherheit ist ein wichtiger Bestandteil von Webhook V2.
Jede Webhook-Anfrage enthält Informationen, die es Ihrem Server ermöglichen, zu überprüfen, ob die Anfrage tatsächlich von SMSMobileAPI stammt.
Die Anfragen umfassen:
* Art der Veranstaltung
* Lieferide
Mehr erfahren→Bisher konzentrierten sich Webhooks hauptsächlich auf eingehende SMS-Nachrichten. Mit Webhook V2 wird SMSMobileAPI zu einer kompletten **event-gesteuerten mobilen Kommunikationsplattform**, die es Ihren Anwendungen ermöglicht, automatisch auf SMS, Anrufe, WhatsApp-Nachrichten, Sprachtranskriptionen und E-Mail-Aktivitäten zu reagieren.
Anstatt den API wiederholt zu überprüfen, ob sich etwas geändert hat, kann Ihre Anwendung jetzt automatisch strukturierte HTTPS-Ereignisse erhalten, sobald die unterstützte Aktivität auftritt.
### 15 Webhook-Events
Webhook V2 führt präzise Ereignisnamen ein, die die wichtigsten Kommunikationskanäle abdecken, die über SMSMobileAPI verfügbar sind.
****SMS**
* `sms.api.submitted` — Eine SMS-Versandanforderung wurde über die API eingereicht.
* `sms.sent` — Das angeschlossene Handy bestätigte, dass das SMS gesendet wurde.
* `sms.failed` — Eine SMS-Sendeoperation ist fehlgeschlagen.
* `sms.received` — Ein neues eingehendes SMS wurde synchronisiert.
* `sms.mobile.sent` — Ein SMS wurde manuell vom angeschlossenen Mobilgerät gesendet.
**Anrufe**
* `call.missed` – Ein verpasster Anruf wurde erkannt.
* `call.incoming` — Ein eingehender Anruf wurde synchronisiert.
* `call.outgoing` — Ein ausgehender Anruf wurde synchronisiert.
****WhatsApp**
* `whatsapp.submitted` — Ein WhatsApp-Versandauftrag wurde erstellt.
* `whatsapp.sent` — Eine WhatsApp-Nachricht wurde erfolgreich gesendet.
* `whatsapp.failed` – Ein WhatsApp-Sendevorgang ist fehlgeschlagen.
* `whatsapp.received` — Eine neue WhatsApp-Nachricht wurde abgerufen.
* `whatsapp.voice.transcribed` — Eine WhatsApp Sprachnachricht wurde in Text umgewandelt.
**E-Mail****
* `email.sent` — Eine E-Mail-Versandanforderung wurde erstellt.
* `email.received` — Eine angeschlossene Mailbox hat eine neue E-Mail erhalten.
### Mehrere Webhook-Ziele
Sie sind nicht mehr auf einen einzigen Webhook-Endpunkt beschränkt.
Webhook V2 ermöglicht es Ihnen, **mehrere unabhängige Ziele** zu erstellen und genau zu entscheiden, welche Ereignisse jedes Ziel erhalten soll.
Sie können beispielsweise senden:
* Eingehende SMS und WhatsApp Nachrichten an Ihre CRM.
* Verpasste Anrufe an Ihr Kunden-Support-System.
* Fehlgeschlagene Lieferungen von SMS und WhatsApp an Ihre Überwachungsplattform.
* Kommunikationsereignisse zu Ihrem Analysesystem.
* Ausgewählte Ereignisse für Ihre eigene Automatisierung oder AI Workflow.
Jedes Ziel ist unabhängig voneinander.
### Selektives Ereignis-Routing
Jedes Webhook-Ziel kann nur die Ereignisse abonnieren, die es benötigt.
Dies macht Integrationen sauberer und verhindert, dass Ihre Anwendung unnötige Ereignisse erhält.
Ein CRM konnte nur abonnieren:
`sms.received
`call.missed
`whatsapp.received
während ein Betriebsüberwachungssystem nur Folgendes abonnieren könnte:
`sms.failed
`whatsapp.failed
### Zuverlässige asynchrone Lieferung
Webhook V2 verwendet eine **dauerhafte Lieferwarteschlange**.
Ereignisse werden vor der Lieferung gespeichert und asynchron verarbeitet, was bedeutet, dass Ihr SMSMobileAPI-Workflow nicht warten muss, bis ein Server eines Drittanbieters reagiert.
Wenn ein Ziel langsam oder nicht verfügbar wird, werden andere Ziele oder andere Konten nicht blockiert.
### Automatische Versuchsreihen
Temporäre Endpunktfehler werden automatisch mit progressiven Verzögerungen wiederholt.
Webhook V2 verwendet **at-least-once Lieferung **, so dass ein Ereignis gelegentlich mehr als einmal geliefert werden kann.
Jedes Ereignis enthält daher einen stabilen Ereignis-Kennzeichen, das Ihre Anwendung speichern und als idempotency Schlüssel verwenden kann, um doppelte Verarbeitung zu verhindern.
### Signierte und überprüfbare Webhook-Anfragen
Sicherheit ist ein wichtiger Bestandteil von Webhook V2.
Jede Webhook-Anfrage enthält Informationen, die es Ihrem Server ermöglichen, zu überprüfen, ob die Anfrage tatsächlich von SMSMobileAPI stammt.
Die Anfragen umfassen:
* Art der Veranstaltung
* Lieferide
