Guia Passo a Passo para Configurar os Webhooks do Quire

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

Já desejou que seus aplicativos pudessem conversar automaticamente entre si? É exatamente isso que os webhooks fazem! Pense neles como mensageiros que avisam seu servidor no momento em que algo acontece nos seus projetos do Quire, seja uma nova tarefa sendo criada, alguém atualizando uma atribuição ou marcando uma tarefa como concluída.

Neste guia, vamos mostrar como configurar webhooks para que seus aplicativos fiquem sincronizados com o Quire, sem que você precise fazer nada.

Como Começar com os Webhooks do Quire?

Etapa 1: Crie Seu App Quire

Antes de tudo, você vai precisar de um app Quire. Se ainda não configurou um, confira nosso guia sobre Como Criar um App Quire com a API Quire e nós te guiamos pelo processo.

Etapa 2: Diga ao Quire Para Onde Enviar as Atualizações

Agora é hora de configurar seu endpoint de webhook no portal de Apps de Desenvolvedor do Quire. É simplesmente o endereço web para onde você quer que o Quire envie notificações, algo como http://myserver/hookhandler.

Pense nisso como dar ao Quire o seu endereço de correio, para que ele saiba onde entregar as novidades.

Etapa 3: Inscreva-se para Receber Atualizações

A última etapa da configuração é dizer ao Quire quais projetos ou tarefas você quer seguir. Você faz isso adicionando seu app como "seguidor" usando a API Quire:

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

Nota importante: certifique-se de já ter configurado a URL do seu webhook antes desta etapa. Sem isso, adicionar seu app como seguidor não vai funcionar.

Quando não precisar mais de atualizações, basta remover seu app da lista de seguidores. É assim tão simples!

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

Como os Webhooks Funcionam nos Bastidores?

O Que Você Vai Receber

Depois que tudo estiver configurado, o Quire começa a enviar notificações sempre que algo acontece nos seus projetos seguidos. Elas chegam como requisições POST com todos os detalhes empacotados em um 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 do seu app. É essa a forma de confirmar que a mensagem realmente veio do Quire e não de alguém se passando por nós. Sempre verifique isso antes de processar qualquer dado!

Respondendo a Diferentes Eventos

Coisas diferentes acontecem nos seus projetos, e você vai querer lidar com cada uma de forma diferente. Aqui está um exemplo simples de como responder com base no 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;
}

Quais Tipos de Eventos o Quire Envia?

O Quire pode notificar você sobre todo tipo de atividade. Aqui estão algumas das mais comuns:

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

Avisando ao Quire Que Você Recebeu a Mensagem

Quando seu webhook recebe uma notificação, basta devolver um código de status de sucesso (qualquer coisa entre 200 e 299). Isso diz ao Quire: "Recebido, obrigado!"

Se algo der errado e você devolver um código de status diferente, sem problemas: o Quire vai tentar enviar a notificação novamente depois de 15 minutos, depois de 1 hora e, por fim, depois de 1 dia.

Para mais detalhes, veja "Responding and Retries" em nossa documentação da API.

Como Gerenciar Webhooks em Vários Projetos?

Trabalhando com vários projetos do Quire no mesmo servidor? Temos duas abordagens flexíveis para te ajudar:

Opção 1: Use Rótulos Personalizados

Você pode adicionar um rótulo personalizado ao se inscrever para 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 vai incluir esse rótulo em cada notificação de webhook, facilitando identificar qual projeto a enviou:

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

Depois, no seu código, você pode rotear 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: Use 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

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

Qual É o Caminho Mais Rápido Para o Seu Primeiro Webhook?

É isso! Agora você já sabe como configurar webhooks e manter seus aplicativos perfeitamente sincronizados com o Quire. Para a documentação técnica completa, confira a seção de Webhook em nossa referência de API.

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

Boa programação!

Perguntas Frequentes

O que é um webhook do Quire?

Uma notificação HTTP automática que o Quire envia para uma URL controlada por você no momento em que algo acontece em um projeto seguido — assim seu app fica sincronizado sem precisar fazer polling.

Como configuro um webhook no Quire?

Crie um app Quire, registre a URL do seu endpoint no portal de Apps de Desenvolvedor e, em seguida, adicione seu app como seguidor de um projeto via API. Configure a URL antes de se inscrever, ou a chamada vai falhar.

Como verifico se uma requisição de webhook realmente veio do Quire?

Todo payload inclui o campo secret do seu app — compare-o com o secret armazenado e rejeite qualquer requisição que não corresponda.

O que acontece se meu servidor estiver fora do ar quando um webhook é disparado?

O Quire tenta reenviar três vezes — após 15 minutos, 1 hora e 1 dia. Retorne um status 2xx assim que receber o payload para interromper novas tentativas.

Como lido com webhooks de vários projetos do Quire em um único servidor?

Anexe um rótulo personalizado ao se inscrever (por exemplo, app|handleProjectA) e roteie com base no campo team, ou dê a cada projeto seu próprio subcaminho na URL do seu webhook.