Webhook de Projetos
Quer que o seu sistema saiba na hora que um projeto nasceu, que uma tarefa mudou ou que um modelo foi alterado? O Webhook de Projetos avisa o seu sistema a cada evento dos projetos, das etapas, das tarefas e dos modelos de projeto.
O Webhook de Projetos cobre só os projetos. As conversas com os clientes são avisadas pelos webhooks da Conexão e do Setor.
Resumo Prático
Acesse o menu Configurações → Opções e desça até a seção Projetos.
Preencha o endereço do seu sistema no campo Webhook de Projetos.
Onde ligar o Webhook de Projetos
Webhook de Projetos (recebe os eventos dos projetos, colunas, tarefas e modelos): o endereço que recebe todos os eventos de projetos da empresa. Em branco, nada é enviado. Ao salvar, a tela avisa "Webhook de Projetos salvo."
O endereço precisa começar com http:// ou https://, sem espaços, e não pode apontar para a rede interna.
Os eventos do Webhook de Projetos
Tudo chega no mesmo endereço. Os eventos enviados são estes:
| Evento | O que aconteceu |
|---|---|
projeto-criado · projeto-alterado · projeto-removido |
um projeto nasceu, mudou ou foi apagado |
etapa-criada · etapa-alterada · etapa-removida |
uma etapa (coluna do quadro do projeto) foi criada, mudou ou foi apagada |
tarefa-criada · tarefa-alterada · tarefa-removida |
uma tarefa de projeto foi criada, mudou ou foi apagada |
modelo-criado · modelo-alterado · modelo-removido |
um modelo de projeto foi criado, mudou ou foi apagado |
Como saber que o aviso veio daqui
Todo aviso do Webhook de Projetos traz o cabeçalho X-Projetos-Evento, com o evento, e vai assinado com o Token da Empresa no cabeçalho X-Assinatura-Projetos.
Dúvidas Comuns
O Webhook de Projetos avisa as mensagens dos clientes? Não. O Webhook de Projetos cobre só os eventos dos projetos. As mensagens dos clientes são avisadas pelos webhooks da Conexão e do Setor.
O Webhook de Projetos avisa quando um modelo de projeto muda? Sim. Criar, alterar e apagar um modelo de projeto enviam modelo-criado, modelo-alterado e modelo-removido.
Erros Comuns
Webhook de Projetos inválido: ao salvar, a tela avisa "Webhook de Projetos inválido: use um endereço http:// ou https://, sem espaços, fora da rede interna." Solução: use o endereço público do seu sistema, começando com http:// ou https://, sem espaço no meio.