Integrações

Webhooks de Entrada para Pumble

5 min de leitura
jovana

Com os webhooks de entrada, você pode postar mensagens facilmente de outros aplicativos no Pumble. Ao criar um webhook de entrada, você recebe um URL exclusivo pelo qual pode enviar uma carga JSON com o texto da mensagem.

Criar um webhook de entrada #

Para criar um novo webhook de entrada:

  1. Clique no nome do seu espaço de trabalho no canto superior esquerdo
  2. Navegue até Configurações do espaço de trabalho
  3. Selecione Configurações Gerais no menu suspenso
  4. Clique na seção Webhooks de entrada na barra lateral
  5. Clique no botão Novo Webhook no canto superior direito
  6. Escolha o canal onde seu webhook postará mensagens
  7. Clique no botão Adicionar Webhooks de entrada para concluir o processo

Quando você cria seu webhook, o editor é aberto automaticamente. Lá você poderá personalizar seu nome, alterar o canal, adicionar uma etiqueta descritiva, personalizar o ícone, e o mais importante, copiar ou gerar seu URL exclusivo.

A taxa limite de webhooks recebidos no Pumble é de um segundo por webhook.

The maximum number of characters in a webhook is 10000.

Usar o webhook de entrada para enviar uma mensagem #

Para enviar uma mensagem usando os webhooks de entrada que você acabou de criar, basta fazer uma solicitação HTTP POST para o URL exclusivo que você copiou do editor da webhook.

A carga útil da solicitação deve conter a propriedade de texto e esse texto será postado em um canal específico. Os tipos de conteúdo atualmente suportados são:

  • application/json
  • application/x-www-form-urlencoded

Aqui está um exemplo de solicitação curl para postar em um canal usando um webhook de entrada usando o tipo de conteúdo 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.\" }"

Aqui está um exemplo de solicitação JSON curl para postar em um canal usando um webhook de entrada:

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:

Hiperlinks:

{
    "text": "[Markdown Hyperlink](https:\/\/pumble.com) | <a href=\"https:\/\/pumble.com\">Html hyperlink<\/a> | <https:>"
}

Emojis:

{
   "text": "Emojis :raised_hands: :heart:"
}

Bloco de código:

{
   "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:

Processar os erros #

Se tudo estiver configurado corretamente, você receberá um status HTTP 200 para indicar que seu webhook de entrada funcionou e a mensagem foi enviada com sucesso. Isso pode não ser sempre o caso, e essa ação pode falhar por vários motivos.

Alguns dos erros que você pode encontrar se seus webhooks falharem são:

mensagem: O webhook de entrada está desabilitado.
código: 400700
O webhook foi desativado pelo Administrador do Espaço de trabalho
mensagem: O webhook de entrada foi removido.
código: 400702
O webhook foi removido pelo Administrador do Espaço de trabalho
Mensagem: Não encontrado.
Código: 404100
O URL exclusivo não foi encontrado e provavelmente foi regenerado pelo administrador do espaço de trabalho
mensagem: Você não pode executar esta operação.
código: 403200
Você não tem permissão para postar no canal especificado
mensagem: O canal está arquivado.
código: 400440
O canal onde os webhooks enviam mensagens está arquivado
mensagem: Formato de carga útil inválido.
código: 400703
A carga útil da solicitação não está em um dos formatos compatíveis.

Esse artigo foi útil?

Thank you! If you’d like a member of our support team to respond to you, please drop us a note at support@pumble.com