Eingehende Webhooks für Pumble
Mit eingehenden Webhooks kannst du Nachrichten aus anderen Apps in Pumble einfach posten. Wenn du einen eingehenden Webhook erstellst, erhältst du eine eindeutige URL, mit der du die JSON-Payload im Nachrichtentext sendest.
Eingehende Webhooks erstellen #
So erstellst du einen eingehenden Webhook:
- Klicke auf den Arbeitsbereichsnamen oben links
- Navigiere zu Arbeitsbereicheinstellungen
- Wähle Allgemeine Einstellungen aus dem Dropdown-Menü
- Klicke auf den Abschnitt Eingehende Webhooks in der Seitenleiste
- Klicke auf die Schaltfläche Neuer Webhook oben rechts
- Wähle den Kanal, in dem dein Webhook Nachrichten postet
- Klicke auf Eingehenden Webhook hinzufügen, um den Vorgang abzuschließen
Wenn du deinen Webhook erstellst, wird der Editor automatisch geöffnet. Dort kannst du seinen Namen anpassen, den Kanal ändern, eine beschreibende Bezeichnung hinzufügen, das Symbol anpassen und vor allem die eindeutige URLkopieren oder neu erstellen.
Die Begrenzung (Limit Rate) für eingehende Webhooks in Pumble beträgt eine Sekunde pro Webhook.
Verwendung von eingehenden Webhooks zur Nachrichtensendung #
Um mit eingehenden, von dir erstellten Webhooks eine Nachricht zu senden, solltest du eine HTTP POST Anforderung für die eindeutige URL erstellen, die du aus dem Webhook-Editor kopiert hast.
Die Anforderung-Payload sollte Texteigenschaft enthalten und der Text wird in einem bestimmten Kanal veröffentlicht. Die derzeit unterstützten Content-Arten sind:
- application/json
- application/x-www-form-urlencoded
Hier ist ein Beispiel des cURL-Befehls für Posting im Kanal mit einem eingehenden Webhook und der Content-Art application/x-form-urlencoded:
curl -X POST \ --location "https://api.pumble.com/workspaces/WORKSPACE-ID/incomingWebhooks/postMessage/WEBHOOK-CODE" \ --data-urlencode "payload={ \"text\": \"This is posted to general and comes from a bot named MyNewWebhook.\" }"Hier ist ein Beispiel für JSON-cURL-Anforderung zur Posting in einem Kanal mit einem eingehenden Webhook:
curl -X POST \ --location
"https://api.pumble.com/workspaces/WORKSPACE-ID/incomingWebhooks/postMessage/WEBHOOK-CODE" \
-H "Content-Type: application/json" \
-d '{"payload":{"text":"This is posted to general and comes from a bot named MyNewWebhook."}}'Die Rich-Text-Formatierung wird für Webhook-Nachrichten unterstützt.
Die Textformatierung kann mit der folgenden Syntax in deiner JSON-Datei ausgeführt werden:
"**text**" bold text; "*text*" italic text; "\\`text`" (code)Benutzer, Benutzergruppen und Kanäle können in Webhook-Nachrichten erwähnt werden.
Fehlerbehandlung #
Wenn alles richtig eingerichtet ist, erhältst du den HTTP 200 -Status, der anzeigt, dass dein eingehender Webhook funktioniert hat und dass die Nachricht erfolgreich gesendet wurde. Das ist nicht immer der Fall und die Aktion kann aus zahlreichen Gründen fehlschlagen.
Einige Fehler, die auftreten können, wenn deine Webhooks fehlschlagen:
| Nachricht: Eingehender Webhook ist deaktiviert Code: 400700 | Der Webhook wurde vom Arbeitsbereichadminstrator deaktiviert |
| Nachricht: Eingehender Webhook ist gelöscht Code: 400702 | Der Webhook wurde vom Arbeitsbereichadminstrator gelöscht |
| Nachricht: Nicht gefunden Code: 404100 | Eindeutige URL wurde nicht gefunden und wurde wahrscheinlich vom Arbeitsbereichadministrator neu erstellt |
| Nachricht: Du kannst diese Operation nicht ausführen Code: 403200 | Du hast keine Berechtigung in bestimmten Kanal zu posten |
| Nachrichten: Kanal ist archiviert Code: 400440 | Der Kanal, in dem Webhooks Nachrichten sendet, wird archiviert |
| Nachricht: Ungültiges Payload-Format Code: 400703 | Anforderungs-Payload ist nicht in einem der unterstützten Formaten |