Eventos Disponíveis
O que é
Eventos são ações que acontecem no Deskito e podem disparar webhooks de saída ou serem usados como gatilhos para automações. Esta página lista todos os eventos disponíveis.
Categorias de Eventos
Leads / Clientes
| Evento | Descrição | Código |
|---|---|---|
| Lead criado | Novo lead cadastrado no sistema | lead.created |
| Lead atualizado | Dados do lead foram alterados | lead.updated |
| Lead convertido | Lead virou cliente | lead.converted |
| Cliente criado | Novo cliente cadastrado | client.created |
| Cliente atualizado | Dados do cliente alterados | client.updated |
Negócios / Deals
| Evento | Descrição | Código |
|---|---|---|
| Negócio criado | Nova oportunidade cadastrada | deal.created |
| Negócio atualizado | Dados do negócio alterados | deal.updated |
| Negócio movido | Negócio mudou de etapa no pipeline | deal.stage_changed |
| Negócio ganho | Negócio fechado com sucesso | deal.won |
| Negócio perdido | Negócio marcado como perdido | deal.lost |
Propostas
| Evento | Descrição | Código |
|---|---|---|
| Proposta criada | Nova proposta gerada | proposal.created |
| Proposta enviada | Proposta enviada ao cliente | proposal.sent |
| Proposta visualizada | Cliente abriu a proposta | proposal.viewed |
| Proposta aceita | Cliente aceitou a proposta | proposal.accepted |
| Proposta recusada | Cliente recusou a proposta | proposal.rejected |
| Proposta expirada | Prazo de validade venceu | proposal.expired |
Contratos
| Evento | Descrição | Código |
|---|---|---|
| Contrato criado | Novo contrato gerado | contract.created |
| Contrato enviado | Contrato enviado para assinatura | contract.sent |
| Contrato assinado | Todas as partes assinaram | contract.signed |
| Contrato expirado | Prazo de assinatura venceu | contract.expired |
Projetos
| Evento | Descrição | Código |
|---|---|---|
| Projeto criado | Novo projeto iniciado | project.created |
| Projeto atualizado | Dados do projeto alterados | project.updated |
| Projeto concluído | Projeto marcado como finalizado | project.completed |
| Projeto arquivado | Projeto foi arquivado | project.archived |
Tarefas
| Evento | Descrição | Código |
|---|---|---|
| Tarefa criada | Nova tarefa adicionada | task.created |
| Tarefa atualizada | Dados da tarefa alterados | task.updated |
| Tarefa concluída | Tarefa marcada como feita | task.completed |
| Tarefa atribuída | Tarefa delegada a alguém | task.assigned |
| Tarefa vencendo | Tarefa próxima do prazo | task.due_soon |
| Tarefa atrasada | Tarefa passou do prazo | task.overdue |
Financeiro
| Evento | Descrição | Código |
|---|---|---|
| Fatura criada | Nova fatura gerada | invoice.created |
| Fatura enviada | Fatura enviada ao cliente | invoice.sent |
| Fatura vencendo | X dias antes do vencimento | invoice.due_soon |
| Fatura vencida | Fatura passou da data | invoice.overdue |
| Pagamento recebido | Fatura foi paga | invoice.paid |
| Transação criada | Nova movimentação registrada | transaction.created |
Eventos / Agenda
| Evento | Descrição | Código |
|---|---|---|
| Evento criado | Novo evento na agenda | event.created |
| Evento atualizado | Dados do evento alterados | event.updated |
| Evento cancelado | Evento foi cancelado | event.cancelled |
| Lembrete de evento | X minutos antes do evento | event.reminder |
Como Usar os Eventos
Para Webhooks de Saída
- Acesse Configurações → Webhooks
- Crie ou edite um webhook
- Selecione os eventos que deseja receber
- Configure a URL de destino
- Salve
Para Automações Internas
- Acesse Automações
- Crie nova automação
- Selecione o evento como gatilho
- Configure as ações
- Ative
Filtros por Evento
Você pode filtrar eventos por condições:
| Evento | Filtros disponíveis |
|---|---|
deal.stage_changed | Etapa de origem, etapa de destino |
invoice.due_soon | Dias de antecedência (1, 3, 7) |
task.assigned | Responsável específico |
deal.won | Valor mínimo |
Exemplo prático
Cenário: Notificar equipe no Slack quando negócio for ganho
Configuração:
1. Crio webhook de saída
2. Seleciono evento:
deal.won3. URL destino: Webhook do Slack
4. Filtro: Valor > R$ 5.000
Resultado: Quando um negócio acima de R$ 5.000 é fechado, uma mensagem é enviada automaticamente ao canal do Slack.
Dicas e boas práticas
- Escolha apenas eventos que você realmente vai usar
- Use filtros para reduzir volume de notificações
- Teste cada evento antes de colocar em produção
- Monitore os logs para verificar entregas
- Documente quais eventos vão para quais destinos
Links relacionados: