A plataforma da monday.com permite enviar um webhook através das nossas integrações — ou você pode até mesmo criá-los por meio da API. É possível enviar um webhook sempre que um evento escolhido ocorrer em seu quadro. Continue lendo para saber mais.

O que é um webhook?

Webhook (também chamado de web callback ou API push HTTP) é uma forma de um aplicativo fornecer informações em tempo real a outros aplicativos. Um webhook fornece dados para outros aplicativos à medida que uma mudança acontece, o que significa que você obtém dados imediatamente, ao contrário de APIs típicas, em que você precisaria pesquisar dados com muita frequência para obtê-los em tempo real. Isso torna os webhooks muito mais eficientes tanto para o fornecedor quanto para o consumidor.

Como criar um novo webhook 

No seu quadro, clique no botão Integrações à direita da tela, clique na aba Criar e procure a integração de Webhooks na página de automações do quadro:

A seguir, clique no banner de Webhooks e escolha a ação sobre a qual deseja receber payloads instantâneos:

Após escolher a ação necessária, você precisará especificar o URL. O URL deve ser capaz de repassar o desafio JSON, e será o receptor dos payloads desse momento em diante:

E pronto! Assim que essa mudança ocorrer (por exemplo, um novo elemento é adicionado ao seu quadro), seu endpoint receberá um payload a respeito da alteração. Você pode conferir alguns payloads mais abaixo.

Adicione uma descrição para detalhar como sua integração com o Webhook está sendo usada no seu fluxo de trabalho. Isso permitirá que qualquer usuário que faça uso desta integração entenda melhor seu propósito e de que forma ela se conecta ao fluxo de trabalho. 

Como verificar um URL do webhook

{
 challenge: “3eZbrw1aBm2rZgRNFdxV2595E9CY3gmdALWMmHkvFXO7tYXAYM8P”
}

{
 challenge: “3eZbrw1aBm2rZgRNFdxV2595E9CY3gmdALWMmHkvFXO7tYXAYM8P”
}

Aqui está um exemplo simples de um monitor de webhook que imprimirá o resultado do webhook e responderá corretamente ao desafio:

app.post("/", function(req, res) { console.log(JSON.stringify(req.body, 0, 2)); res.status(200).send(req.body);})

Como serão os dados do evento?

{
 "event": {
  "userId": 9603417,
  "originalTriggerUuid": null,
  "boardId": 1771812698,
  "pulseId": 1772099344,
  "pulseName": "Create_item webhook",
  "groupId": "topics",
  "groupName": "Group Title",
  "groupColor": "#579bfc",
  "isTopGroup": true,
  "columnValues": {},
  "app": "monday",
  "type": "create_pulse",
  "triggerTime": "2021-10-11T09:07:28.210Z",
  "subscriptionId": 73759690,
  "triggerUuid": "b5ed2e17c530f43668de130142445cba"
 }

"event": {
  "userId": 9603417,
  "originalTriggerUuid": null,
  "boardId": 1771812698,
  "groupId": "topics",
  "pulseId": 1771812728,
  "pulseName": "Crate_item webhook",
  "columnId": "date4",
  "columnType": "date",
  "columnTitle": "Date",
  "value": {
   "date": "2021-10-11",
   "icon": null,
   "time": null
  },
  "previousValue": null,
  "changedAt": 1633943701.9457765,
  "isTopGroup": true,
  "app": "monday",
  "type": "update_column_value",
  "triggerTime": "2021-10-11T09:15:03.429Z",
  "subscriptionId": 73760484,
  "triggerUuid": "645fc8d8709d35718f1ae00ceded91e9"
 }

"event": {
  "userId": 9603417,
  "originalTriggerUuid": null,
  "boardId": 1771812698,
  "pulseId": 1771812728,
  "body": "<p>create_update webhook</p>",
  "textBody": "create_update webhook",
  "updateId": 1190616585,
  "replyId": null,
  "app": "monday",
  "type": "create_update",
  "triggerTime": "2021-10-11T09:18:57.368Z",
  "subscriptionId": 73760983,
  "triggerUuid": "6119292e27abcc571f90ea4177e94973"
 }

"event": {
  "userId": 9603417,
  "originalTriggerUuid": null,
  "boardId": 1771812698,
  "groupId": "topics",
  "pulseId": 1772099344,
  "pulseName": "Create_item webhook",
  "columnId": "status",
  "columnType": "color",
  "columnTitle": "Status",
  "value": {
   "label": {
    "index": 3,
    "text": "Status change wbhook",
    "style": {
     "color": "#0086c0",
     "border": "#3DB0DF",
     "var_name": "blue-links"
    }
   },
   "post_id": null
  },
  "previousValue": null,
  "changedAt": 1633944017.473193,
  "isTopGroup": true,
  "app": "monday",
  "type": "update_column_value",
  "triggerTime": "2021-10-11T09:20:18.022Z",
  "subscriptionId": 73761176,
  "triggerUuid": "504b2eb76c80f672a18f892c0f700e41"
 }

"event": {
  "userId": 9603417,
  "originalTriggerUuid": null,
  "boardId": 1772135370,
  "pulseId": 1772139123,
  "pulseName": "sub-item",
  "groupId": "topics",
  "groupName": "Subitems",
  "groupColor": "#579bfc",
  "isTopGroup": true,
  "columnValues": {},
  "app": "monday",
  "type": "create_pulse",
  "triggerTime": "2021-10-11T09:24:51.835Z",
  "subscriptionId": 73761697,
  "triggerUuid": "5c28578c66653a87b00a80aa4f7a6ce3",
  "parentItemId": "1771812716",
  "parentItemBoardId": "1771812698"
 }