# So fügen Sie einen Webhook hinzu

In SyBox erfolgt dies unter Einstellungen > Integrationen > Webhooks. 1) Gehen Sie zu Einstellungen > Integrationen > Webhooks. 2) Klicken Sie auf „Webhook hinzufügen“. 3) Vergeben Sie einen Namen. 4) Tragen Sie die „Ziel-URL“ ein. Es muss „Eine öffentliche https-Adresse, die wir erreichen können“ sein. Reine HTTP-Adressen sowie Adressen aus privaten oder internen Netzwerken werden abgewiesen. 5) Aktivieren Sie unter „Ereignisse“ mindestens ein Ereignis. „Eingehende Nachricht“ ist…

## So fügen Sie einen Webhook hinzu

1. Gehen Sie zu Einstellungen > Integrationen > Webhooks.
   ![Settings, Webhooks: an active webhook with its last result, and the "Add webhook" button](https://www.sybox.io/res/sybox/help/de/add-a-webhook-1.webp?v=b9e6efae)
2. Klicken Sie auf „Webhook hinzufügen“.
   ![The new webhook window: its name and the address it calls](https://www.sybox.io/res/sybox/help/de/add-a-webhook-2.webp?v=c5425a1a)
3. Vergeben Sie einen Namen.
4. Tragen Sie die „Ziel-URL“ ein. Es muss „Eine öffentliche https-Adresse, die wir erreichen können“ sein. Reine HTTP-Adressen sowie Adressen aus privaten oder internen Netzwerken werden abgewiesen.
5. Aktivieren Sie unter „Ereignisse“ mindestens ein Ereignis. „Eingehende Nachricht“ ist standardmäßig vorausgewählt.
6. Optional: Aktivieren Sie „Sprachtranskription“, um Sprachnachrichten inklusive Text zu erhalten.
7. Belassen Sie unter „Nummern“ die Auswahl auf „Alle Nummern“, um sämtliche WhatsApp-Nummern einzuschließen, oder deaktivieren Sie die Option und wählen Sie gezielt einzelne Nummern aus.
8. Klicken Sie auf Speichern.
9. Ein Fenster zeigt den „Signaturschlüssel“. „Jetzt kopieren — wird nur einmal angezeigt.“ Hinterlegen Sie ihn auf Ihrem Server.

## Fragen

**Q: Ich habe den Signaturschlüssel verloren.**

Er kann nicht erneut angezeigt werden. Bearbeiten Sie den Webhook, tragen Sie unter „Signaturschlüssel“ einen neuen Schlüssel Ihrer Wahl ein, speichern Sie und hinterlegen Sie diesen neuen Schlüssel auf Ihrem Server.

**Q: Mein Webhook wurde ausgeschaltet, obwohl ich das nicht getan habe.**

SyBox hat ihn ausgeschaltet, nachdem Ihr Server über mehr als eine Stunde hinweg 20-mal in Folge fehlgeschlagen ist. Siehe „Automatisch ausgeschaltet“ oben: Reparieren Sie Ihren Server und schalten Sie den Webhook innerhalb von 24 Stunden wieder ein, damit die wartenden Ereignisse gesendet werden.

**Q: Mein Webhook empfängt keinerlei Daten.**

Klicken Sie auf seiner Kachel zuerst auf „Testereignis senden“ und schauen Sie unter „Zustellungen“ nach. Prüfen Sie dann folgende vier Punkte: (1) Ist der Webhook aktiviert? (2) Ist mindestens ein Ereignis ausgewählt? (3) Deckt er die richtige WhatsApp-Nummer bzw. „Alle Nummern“ ab? (4) Kam die Nachricht über einen Kanal, den Webhooks übertragen (WhatsApp, Messenger, Instagram, Telegram, TikTok oder Live-Chat; nicht E-Mail oder SMS)? Werfen Sie anschließend einen Blick auf das letzte Zustellergebnis auf der Kachel.

**Q: Die Kachel zeigt einen roten Fehler wie HTTP 404 oder 500.**

SyBox konnte Ihre Adresse erreichen, aber Ihr Server hat einen Fehler zurückgemeldet. Prüfen Sie die URL und die Server-Logs.

**Q: Ich kann keinen Webhook anlegen. Mir wird angezeigt, dass mir die Berechtigung fehlt.**

Zum Erstellen oder Reaktivieren eines Webhooks sind sowohl „Kanäle verwalten“ als auch „Kontaktnummer anzeigen“ erforderlich. Wenden Sie sich an Ihren Administrator.

Source: https://www.sybox.io/de/help/add-a-webhook