Webhooks entrants pour Pumble
Avec les webhooks entrants, vous pouvez facilement poster des messages d'autres applications 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.
The maximum number of characters in a webhook is 10000.
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."}}'
You can use rich text formatting for webhook messages. Here are some payload examples:
User mention:
{
"text": "User mention: <<@{{userId}}>>, channel mention: <<#{{channelId}}>>, user group mention: <<&{{userGroupId}}>> and @here @channel"
}
Attachment:
{
"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
}
]
}
This attachment example will send a message that looks like this:

Liens hypertextes:
{
"text": "[Markdown Hyperlink](https:\/\/pumble.com) | <a href=\"https:\/\/pumble.com\">Html hyperlink<\/a> | <https:>"
}
Emojis:
{
"text": "Emojis :raised_hands: :heart:"
}
Bloc de code:
{
"text": "`Inline code` and ```Code block\n hello \nEnd of code block```"
}
Here’s an example message that incorporates different types of rich text formatting:
{
"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}```"
}
This webhook message would look like this:

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. |