Guia Passo a Passo para Configurar os Webhooks do Quire

Última atualização: 24 de julho de 2026

Já desejou que as suas aplicações pudessem falar automaticamente umas com as outras? É exatamente isso que os Webhooks fazem! Pense neles como mensageiros que avisam o seu servidor no momento em que algo acontece nos seus projetos Quire, seja uma nova tarefa a ser criada, alguém a atualizar uma atribuição ou a marcar uma tarefa como concluída.

Neste guia, vamos mostrar-lhe como configurar Webhooks para que as suas aplicações se mantenham sincronizadas com o Quire, sem que precise de mexer um dedo.

Como Começar com os Webhooks do Quire?

Passo 1: Crie a Sua Aplicação Quire

Antes de mais, vai precisar de uma aplicação Quire. Se ainda não configurou nenhuma, consulte o nosso guia sobre Criar uma Aplicação Quire com a API Quire, onde o acompanhamos passo a passo.

Passo 2: Diga ao Quire para Onde Enviar as Atualizações

Agora é altura de configurar o seu endpoint de Webhook no portal de Apps de Desenvolvedor do Quire. Trata-se simplesmente do endereço web para onde quer que o Quire envie notificações, algo como http://myserver/hookhandler.

Pense nisto como dar ao Quire a sua morada, para que ele saiba para onde entregar as novidades.

Passo 3: Subscreva as Atualizações

O último passo da configuração é dizer ao Quire quais os projetos ou tarefas que quer seguir. Faz isto adicionando a sua aplicação como "seguidora" através da API Quire:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app"]}' \
  https://quire.io/api/project/projectAOid

Nota importante: certifique-se de que já configurou o URL do Webhook antes deste passo. Sem isso, adicionar a sua aplicação como seguidora não vai funcionar.

Quando já não precisar de atualizações, basta remover a sua aplicação da lista de seguidores. É simples assim!

Para mais detalhes, consulte Update a project by OID na nossa referência de API.

Como Funcionam os Webhooks nos Bastidores?

O Que Vai Receber

Depois de tudo configurado, o Quire começa a enviar-lhe notificações sempre que algo acontece nos seus projetos seguidos. Estas chegam como pedidos POST com todos os detalhes num pacote JSON organizado:

{
  "type": "notification",
  "secret": "your-app-secret",
  "data": {
    "type": 0, 
    "when": "2019-09-30T08:20:12.000Z",
    "what": {
      "oid": "YxjapXXRCOYxoaiCT4tT3OQm", 
      "id": 101,
      "name": "Brand new start"
    },
    "user": {
      "oid": "1AbDEFed2A5031BEDDweqmde",
      "id": "john.doer",
      "name": "John Doer"
    },
    "message": "<a href=\"https://quire.io/u/john.doer\">John Doer</a> added <a href=\"https://quire.io/w/MyProjects/101\">Brand new start</a>",
    "text": "John Doer added Brand new start",
    "url": "https://quire.io/w/MyProjects/101"
  } 
}

Segurança em Primeiro Lugar: Verifique a Origem

Cada Webhook inclui a chave secreta da sua aplicação. É a sua forma de confirmar que a mensagem realmente veio do Quire e não de alguém a fazer-se passar por nós. Verifique sempre isto antes de processar qualquer dado!

Responder a Diferentes Eventos

Coisas diferentes acontecem nos seus projetos, e vai querer tratá-las de forma diferente. Aqui está um exemplo simples de como responder consoante o que aconteceu:

switch(json["data"]["type"]) {
  case 0:
    // new task added
    log("New task: " + json["data"]["what"]["name"]);
    break;
  case 1:
    // task removed
    log(json["data"]["user"]["name"] + " deleted " + json["data"]["what"]["name"]);
    break;
}

Que Tipos de Eventos o Quire Envia?

O Quire pode notificá-lo sobre todo o tipo de atividades. Aqui estão algumas das mais comuns:

Quer a lista completa? Consulte a nossa documentação de tipos de atividade para ver tudo o que o Quire pode contar-lhe.

Avisar o Quire de que Recebeu a Mensagem

Quando o seu Webhook receber uma notificação, basta enviar de volta um código de estado de sucesso (qualquer valor entre 200 e 299). Isto diz ao Quire: "Recebido, obrigado!"

Se algo correr mal e enviar um código de estado diferente, sem problema — o Quire vai tentar enviar a notificação novamente após 15 minutos, depois após 1 hora e, por fim, após 1 dia.

Para mais detalhes, consulte "Responding and Retries" na nossa documentação de API.

Como Gerir Webhooks em Vários Projetos?

A trabalhar com vários projetos Quire no mesmo servidor? Temos duas abordagens flexíveis para si:

Opção 1: Usar Etiquetas Personalizadas

Pode adicionar uma etiqueta personalizada ao subscrever atualizações de um projeto:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|handleProjectA"]}' \
  https://quire.io/api/project/projectAOid

O Quire incluirá esta etiqueta em cada notificação de Webhook, facilitando a identificação de qual projeto a enviou:

{
  "type": "notification",
  "team": "handleProjectA",
  "data": {
    // event details...
  }
}

Depois, no seu código, pode encaminhar as notificações de acordo:

switch(json["data"]["type"]) {
  case 0:
    // new task added
    if (json["team"] == "handleProjectA") {
      log("ProjectA has a new task: " + json["data"]["what"]["name"]);
    }
    break;
}

Opção 2: Usar Caminhos Diferentes

Prefere manter tudo separado? Configure caminhos únicos para cada projeto:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|/projectAUpdate"]}' \
  https://quire.io/api/project/projectAOid

Desta forma, o Quire envia notificações para diferentes subcaminhos do seu endpoint principal (como http://myserver/hookhandler/projectAUpdate), e pode tratar cada projeto com o seu próprio handler dedicado.

Qual é o Caminho Mais Rápido para o Seu Primeiro Webhook?

É tudo! Agora já sabe como configurar Webhooks e manter as suas aplicações perfeitamente sincronizadas com o Quire. Para a documentação técnica completa, consulte a secção Webhook na nossa referência de API.

A criar para um assistente de IA em vez de um servidor personalizado? Veja Configuração do Quire MCP em 5 Minutos para ligar o Claude, o ChatGPT ou qualquer cliente de IA diretamente.

Boas construções!

Perguntas Frequentes

O que é um Webhook do Quire?

Uma notificação HTTP automática que o Quire envia para um URL que você controla no momento em que algo acontece num projeto seguido — para que a sua aplicação se mantenha sincronizada sem fazer polling.

Como configuro um Webhook no Quire?

Crie uma aplicação Quire, registe o URL do seu endpoint no portal de Apps de Desenvolvedor e depois adicione a sua aplicação como seguidora de um projeto através da API. Configure o URL antes de subscrever, ou a chamada falhará.

Como verifico que um pedido de Webhook realmente veio do Quire?

Cada payload inclui o campo secret da sua aplicação — compare-o com o seu secret guardado e rejeite qualquer pedido que não coincida.

O que acontece se o meu servidor estiver em baixo quando um Webhook é acionado?

O Quire tenta novamente três vezes — após 15 minutos, 1 hora e 1 dia. Devolva um estado 2xx assim que receber o payload para travar novas tentativas.

Como faço para gerir Webhooks de múltiplos projetos Quire no mesmo servidor?

Pode anexar uma etiqueta personalizada ao subscrever (por exemplo, app|handleProjectA) e encaminhar com base no campo team, ou dar a cada projeto o seu próprio subcaminho no URL do seu Webhook.