Webhooks für eingehende Nachrichten und Nachrichtenstatus

Sie müssen sowohl die Webhooks für eingehende Nachrichten als auch für den Nachrichtenstatus konfigurieren.

Konfigurieren Sie Ihre Webhook-URLs

Es gibt mindestens zwei Webhooks, die Sie konfigurieren müssen:

  • Webhook "Nachrichtenstatus
  • Webhaken für eingehende Nachrichten

Wenn Statusaktualisierungen von Nachrichten generiert werden, z. B. delivered, rejected oder acceptedwerden die Rückrufe auf der Status der Nachricht Webhook-URL.

Wenn eine eingehende Nachricht empfangen wird, wird ein Callback mit der Nutzlast der Nachricht auf der Eingehende Nachricht Webhook-URL.

WICHTIG! Beide Webhook-URLs sollten konfiguriert werden. Zumindest sollten Ihre Webhook-Handler 200 Antworten für eingehende Nachrichten und Nachrichtenstatus-Callbacks zurückgeben. Dies stellt sicher, dass potenzielle Rückruf-Warteschlange Probleme vermieden werden.

So konfigurieren Sie die Webhook-URLs

  1. Wenn Sie bereits eine Anwendung erstellthaben, aber Ihre Webhooks noch nicht konfiguriert haben, gehen Sie zu Ihre Applications und wählen Sie die zu konfigurierende Anwendung aus.

  2. Klicken Sie auf bearbeiten um die Webhook-URLs der Anwendung zu ändern.

  3. Geben Sie im Abschnitt Messages capabilities Ihre Webhook-URLs in die Felder mit der Bezeichnung Status-URL und Eingehende URL.

Die Werte, die Sie für Webhook-URLs eingeben, hängen davon ab, wo sich Ihr Webhook-Server befindet. Zum Beispiel:

Webhook URL
Status-URL https://www.example.com/webhooks/message-status
Eingehende URL https://www.example.com/webhooks/inbound-message

HINWEIS: Wir empfehlen die Verwendung von JWT-basierte Autorisierung denn so können Sie Ihre Webhook-URLs für eingehende und ausgehende Lieferungen auf der Anwendungsebene. Andernfalls werden alle Rückrufe aus Ihren verschiedenen Applications an Ihre Webhook-URLs auf Account-Ebene.

HINWEIS: Die Rückrufe werden über POST HTTP-Anfragen.

Lokales Testen über Ngrok

Wenn Sie Ihre Anwendung lokal testen möchten, können Sie Ngrok verwenden.

Siehe unsere Informationen über Ngrok für die lokale Entwicklung nutzen

Wenn Sie Ngrok auf diese Weise verwenden, würden Sie die Ngrok-URLs für Ihre Webhook-URLs verwenden:

  • https://abcdef1.ngrok.io/webhooks/inbound-message
  • https://abcdef1.ngrok.io/webhooks/message-status

Webhook-Warteschlange

Bitte beachten Sie, dass Webhooks, die von Vonage ausgehen, wie z.B. die Webhook-URL für den Nachrichtenstatus und die URL für eingehende Nachrichten, von Vonage pro Nachricht in eine Warteschlange gestellt werden.

Bitte stellen Sie sicher, dass alle Applications Webhooks mit einer 200-Antwort quittieren.

Signierte Webhooks

Um die Herkunft Ihrer Webhooks zu überprüfen, können Sie die Signatur der Webhooks validieren, siehe Anleitung hier

Webhooks im Produktionseinsatz

Wenn die Webhook-URLs für Nachrichten in Ihrem Vonage API Account bereits in der Produktion verwendet werden und Sie eine zweite für die Verwendung der Messages API benötigen, senden Sie bitte eine E-Mail Unterstützung und fragen Sie nach einem Sub-API-Schlüssel.