Configurar

Criar o ponto de entrada no teu servidor e registá-lo na plataforma.

1. Criar o endpoint

  • Aceita pedidos POST
  • Usa HTTPS em produção
  • Responde com um estado entre 200 e 299 para confirmar a receção
  • Responde depressa: o tempo limite é de 10 segundos
javascript
const express = require("express");
const crypto = require("crypto");

const app = express();
app.use(express.json());

app.post("/webhooks/droidsender", (req, res) => {
  // responde primeiro, processa depois: o limite sao 10 segundos
  res.sendStatus(200);
  tratar(req.body);
});

app.listen(3000);

2. Registar na plataforma

  • Abre a página Webhooks
  • Carrega em Novo webhook
  • Dá um nome e o URL do endpoint
  • Escolhe os eventos que queres receber

Desativação automática

Ao fim de 15 falhas seguidas, o webhook é desativado e deixa de receber eventos. Corrige o servidor e reativa-o na página Webhooks. Podes pedir aviso por SMS quando isso acontecer.