Webhooks entrantes para Pumble
Con los webhooks entrantes, puedes publicar fácilmente mensajes de otras aplicaciones en Pumble. Cuando creas un webhook entrante, recibes una URL única mediante la cual puedes enviar una carga útil JSON con el texto del mensaje.
Crear un webhook entrante #
Para crear un nuevo webhook entrante:
- Haz clic en el nombre de tu espacio de trabajo en la esquina superior izquierda
- Navega a Configuración del espacio de trabajo
- Selecciona Ajustes generales del menú desplegable
- Haz clic en el botón Webhooks entrantes en la barra lateral
- Haz clic en el botón Nuevo Webhook en la esquina superior derecha
- Elige el canal donde tu webhook publicará mensajes
- Haz clic en el botón Añadir webhook entrante para completar el proceso
Cuando creas tu webhook, el editor se abre automáticamente. Allí podrás personalizar su nombre, cambiar el canal, añadir una etiqueta descriptiva, personalizar el ícono y, lo más importante, copiar o regenerar tu URL única.
La tasa límite de webhooks entrantes en Pumble es de un segundo por webhook.
Utilizar webhook entrante para enviar un mensaje #
Para enviar un mensaje utilizando los webhooks entrantes que acabas de crear, simplemente realiza una solicitud HTTP POST a la URL única que has copiado del editor de webhooks.
La carga útil de la solicitud debe contener la propiedad de texto y ese texto se publicará en un canal específico. Los tipos de contenido admitidos actualmente son:
- application/json
- application/x-www-form-urlencoded
Aquí hay una solicitud de curl de muestra para publicar en un canal usando un webhook entrante utilizando el tipo de contenido 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.\" }"
A continuación se muestra un ejemplo de solicitud curl JSON para publicar en un canal mediante un webhook entrante:
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."}}'
Se admite el formato de texto enriquecido para los mensajes de webhook.
El formateo de texto se puede realizar utilizando la siguiente sintaxis en tu archivo JSON:
"**text**" bold text; "*text*" italic text; "\\`text`" (code)
Se pueden mencionar usuarios, grupos de usuarios y canales en los mensajes de webhook.
Manejar errores #
Si todo está configurado correctamente, recibirás un estado HTTP 200 para indicar que tu webhook entrante funcionó y que el mensaje se envió correctamente. Es posible que este no sea siempre el caso, y esta acción puede fallar por numerosas razones.
Algunos de los errores que puedes encontrar si tus webhooks fallan son:
mensaje: El webhook entrante está deshabilitado. código: 400700 | El Webhook fue deshabilitado por el administrador del espacio de trabajo |
mensaje: Se eliminó el webhook entrante. código: 400702 | El Webhook fue eliminado por el administrador del espacio de trabajo |
mensaje: No encontrado. código: 404100 | No se encontró la URL única y lo más probable es que el administrador del espacio de trabajo la haya regenerado |
mensaje: No puedes realizar esta operación. código: 403200 | No tienes permiso para publicar en el canal especificado |
mensaje: El canal está archivado. código: 400440 | No tienes permiso para publicar en el canal especificado |
mensaje: Formato de carga útil no válido. código: 400703 | La carga útil de la solicitud no está en uno de los formatos admitidos. |