Webhooks entrants pour Pumble
Avec les webhooks entrants, vous pouvez facilement poster des messages d'autres applis dans Pumble. Lorsque vous créez un webhook entrant, vous recevez une URL unique par laquelle vous pouvez envoyer une charge utile JSON avec le texte du message.
Créer un webhook entrant #
Pour créer un nouveau webhook entrant :
- Cliquez sur le nom de votre espace de travail dans le coin supérieur gauche
- Accédez aux Paramètres de l'espace de travail
- Sélectionnez Paramètres généraux dans la liste déroulante
- Cliquez sur le Webhooks entrants dans la barre latérale
- Cliquez sur le bouton Nouveau Webhook dans le coin supérieur droit
- Choisissez le canal dans lequel votre webhook affichera des messages
- Cliquez sur le bouton Ajouter un Webhook entrant pour terminer le processus
Lorsque vous créez votre webhook, l'éditeur s'ouvre automatiquement. Vous pourrez y personnaliser son nom, changer le canal, ajouter une étiquette descriptive, personnaliser l'icône et, surtout, copier ou régénéer votre URL unique.
Le taux limite des webhooks entrants sur Pumble est d'une seconde par webhook.
Le nombre maximal de caractères dans un webhook est de 10 000.
Utiliser un webhook entrant pour envoyer un message #
Pour envoyer un message en utilisant les webhooks entrants que vous venez de créer, il suffit de faire une requête HTTP POST à l'URL unique que vous avez copiée depuis l'éditeur de webhooks.
La charge utile de la requête doit contenir la propriété de texte et ce texte sera publié dans un canal spécifié. Les types de contenu actuellement pris en charge sont les suivants :
- application/json
- application/x-www-form-urlencoded
Voici un exemple de requête curl pour poster sur un canal en utilisant un webhook entrant utilisant le type de contenu application/x-www-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.\" }"
Voici un exemple de requête JSON curl pour envoyer un message à un canal à l'aide d'un webhook entrant :
curl -X POST \ --location
"https://api.pumble.com/workspaces/WORKSPACE-ID/incomingWebhooks/postMessage/WEBHOOK-CODE" \
-H "Content-Type: application/json" \
-d '{"text":"This is posted to general and comes from a bot named MyNewWebhook."}}'
Vous pouvez utiliser le format RTF pour les messages Webhook. Voici quelques exemples de charge utile :
Mention d’utilisateur:
{
"text": "User mention: <<@{{userId}}>>, channel mention: <<#{{channelId}}>>, user group mention: <<&{{userGroupId}}>> and @here @channel"
}
Pièce jointe:
{
"attachments": [
{
"pretext": "Pretext of Pumble webhooks article",
"title": "Pumble webhooks",
"title_link": "https://pumble.com/help/integrations/add-pumble-apps/incoming-webhooks-for-pumble",
"text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
"author_name": "Pumble",
"author_link": "https://pumble.com",
"footer": "Lorem ipsum v1.0.0",
"footer_icon": "https://files.pumble.com/avatars/default/pumble-logo",
"color": "green", // or hex RGB
"ts": 1759479334
}
]
}
Cet exemple de pièce jointe enverra un message qui ressemblera à ceci :

Hyperliens:
{
"text": "[Markdown Hyperlink](https:\/\/pumble.com) | <a href=\"https:\/\/pumble.com\">Html hyperlink<\/a> | <https:>"
}
Émojis:
{
"text": "Emojis :raised_hands: :heart:"
}
Bloc de code:
{
"text": "`Inline code` and ```Code block\n hello \nEnd of code block```"
}
Voici un exemple de message qui intègre différents types de mise en forme de texte enrichi :
{
"text": "Hello team! :wave: :tada:\n\n**Quick Update**:\n- Feature deployed successfully! :rocket:\n- Bugs resolved: `5`\n\n*Styling Reference:*\n- Markdown **bold**, *italic*\n- HTML <b>bold<\/b>, <i>italic<\/i>, <code>inline code<\/code>\n\n\ud83d\udd17 Useful Links:\n- [Pumble Website](https:\/\/pumble.com)\n- <a href=\"https:\/\/pumble.com\">Pumble via HTML<\/a>\n- <https:> \n\n:busts_in_silhouette: Mentions:\n- Channel: <<#{{68e3a383ce5f2c8d95ff46a6}}>> \nNotifications: @here @channel \n\n:computer: Code snippet:```function greet() {\n console.log(\"Hello, Pumble!\");\n}```"
}
Ce message webhook ressemblerait à ceci :

Traitement des erreurs #
Si tout est correctement configuré, vous recevrez un statut HTTP 200 pour indiquer que votre webhook entrant a fonctionné et que le message a été envoyé avec succès. Ce n'est pas toujours le cas, et cette action peut échouer pour de nombreuses raisons.
Voici quelques-unes des erreurs que vous pourriez rencontrer si vos webhooks échouent :
| message : Le webhook entrant est désactivé. code: 400700 | Le Webhook a été désactivé par l'administrateur de l'espace de travail. |
| message : Le webhook entrant est supprimé. code: 400702 | Le Webhook a été supprimé par l'administrateur de l'espace de travail. |
| message : Non trouvé. code: 404100 | L'URL unique n'a pas été trouvée et a probablement été régénérée par l'administrateur de l'espace de travail. |
| message : Vous ne pouvez pas effectuer cette opération. code: 403200 | Vous n'avez pas l’autorisation de publier dans le canal spécifié. |
| message : Le canal est archivé. code: 400440 | Le canal dans lequel les webhooks envoient des messages est archivé. |
| message : Format de charge utile non valide. code: 400703 | La charge utile des demandes n’est pas dans l'un des formats pris en charge. |