Breaking news:Extensão do Chrome – instale agoraIntegração com o Trello – saiba mais

Como usar webhooks

Webhook é um aviso automático: quando algo acontece no Rabbiit, o sistema envia o evento para uma URL que você cadastrou. O outro sistema (ERP, automação, data warehouse) reage na hora — sem ficar perguntando a cada poucos minutos se alguma hora mudou.

No Rabbiit o administrador cadastra a URL, escolhe os tipos de evento e acompanha cada tentativa de envio. Só quem administra a conta cria e gerencia webhooks.

💡 Plano: webhooks em tempo quase real fazem parte do Ultimate. Há um limite de webhooks ativos; os inativos não ocupam vaga.

Para quem é

Administrador — cria a subscription, escolhe os eventos, ativa ou inativa, e abre o histórico quando a outra ponta não recebe.

Operações / integração — define a URL de destino e usa o detalhe da entrega (payload, resposta HTTP, erro) para fechar o diagnóstico.

Gestor e colaborador — em geral não entram nesta tela. O efeito é indireto: o sistema que o time já usa atualiza sozinho.

Onde encontrar

Tela de integrações, webhooks e APITela de integrações, webhooks e API Configurações > Integrações

Na mesma página da API existem duas abas de webhook:

  • Webhooks — cadastro, eventos e limite de ativos
  • Entregas de eventos — histórico de cada envio

Somente administradores operam essas abas.

Como funciona no Rabbiit

  1. Abra Configurações > Integrações e a aba Webhooks.
  2. Clique em Novo webhook. Informe um nome que o time reconheça daqui a meses (“ERP do cliente X”, “Automação de faturamento”).
  3. Informe a URL de destino — o endereço HTTPS que vai receber o POST.
  4. Selecione os tipos de evento. Escolha só o que aquela integração precisa; evento demais vira ruído e custo.
  5. Opcional: informe um token (secret) ou deixe em branco para o Rabbiit gerar um. Use esse valor para validar o header X-Signature das entregas. O secret aparece na criação; depois, se precisar trocar, use Gerar novo segredo (o anterior deixa de valer na hora).
  6. Salve. O Rabbiit dispara um POST para a URL sempre que um dos eventos escolhidos acontece na conta.

Cada webhook pode ser ativado ou inativado. Inativar não apaga o cadastro e não conta no limite de ativos. Dá para editar eventos e URL, ou excluir quando a integração acabar.

Use webhook quando o outro sistema precisa reagir (criar fatura, atualizar planilha, disparar fluxo). Para puxar dados sob consulta, use a API e os tokens de acesso.

Eventos disponíveis

Ao cadastrar o webhook você escolhe um ou mais tipos. O código (project.created, time_entry.updated etc.) é o que chega no payload e o que aparece no histórico.

Projeto

  • project.created — projeto criado
  • project.updated — projeto atualizado
  • project.deleted — projeto excluído

Cliente

  • customer.created — cliente criado
  • customer.updated — cliente atualizado
  • customer.deleted — cliente excluído

Tarifa

  • rate.created — tarifa criada
  • rate.updated — tarifa atualizada
  • rate.deleted — tarifa excluída

Usuário

  • user.created — usuário criado
  • user.updated — usuário atualizado
  • user.deleted — usuário excluído

Tarefa

  • task.created — tarefa criada
  • task.updated — tarefa atualizada
  • task.deleted — tarefa excluída

Equipe

  • team.created — equipe criada
  • team.updated — equipe atualizada
  • team.deleted — equipe excluída

Membro de equipe

  • team_user.created — usuário adicionado a uma equipe
  • team_user.deleted — usuário removido de uma equipe

Membro de projeto

  • project_user.created — usuário adicionado a um projeto
  • project_user.updated — atribuição do usuário no projeto mudou
  • project_user.deleted — usuário removido de um projeto

Tarefa do projeto

  • project_task.created — tarefa vinculada ao projeto
  • project_task.updated — vínculo da tarefa no projeto mudou
  • project_task.deleted — tarefa desvinculada do projeto

Lançamento de horas

  • time_entry.created — lançamento criado
  • time_entry.updated — lançamento atualizado
  • time_entry.deleted — lançamento excluído
  • time_entry.timer_started — timer iniciado
  • time_entry.timer_stopped — timer parado

Lista de to-dos

  • todo_list.created — lista criada
  • todo_list.updated — lista atualizada
  • todo_list.deleted — lista excluída
  • todo_list.restored — lista restaurada

To-do

  • todo.created — to-do criado
  • todo.updated — to-do atualizado
  • todo.deleted — to-do excluído
  • todo.restored — to-do restaurado

Aprovação de horas

  • timesheet_approval.created — aprovação de horas criada (envio da semana)
  • timesheet_approval.update — aprovação de horas atualizada (aprovação, recusa ou outra mudança de status)

Acompanhar as entregas

Na aba Entregas de eventos o administrador vê cada tentativa de envio:

  • Evento — o tipo disparado
  • Status — Pendente, Entregue, Falhou ou Retentando
  • HTTP — código de resposta do destino
  • Tentativas e próxima tentativa — quando o Rabbiit tenta de novo após falha
  • Criado em — data do disparo

Filtros por status e por tipo de evento ajudam a achar a falha. Em Visualizar detalhes abrem o payload enviado, o corpo da resposta e a mensagem de erro — sem precisar adivinhar se a URL caiu, se a autenticação recusou ou se houve timeout.

Se a conta não integra com nada, ignore estas abas. Enviar e aprovar a semana e os relatórios resolvem o dia a dia sem webhook.

Artigos relacionados

Neste artigo
Outros artigos em Integrações e Extensão