Webhooks de Agente
Atualizar Webhook
Atualizar uma configuração de webhook existente
PUT
Visão Geral
Atualiza uma configuração de webhook existente. Todos os campos são opcionais — apenas os campos fornecidos serão atualizados.Endpoint
UUID do agente
UUID do webhook
Requisição
Resposta
Indica se o webhook foi atualizado com sucesso
Mensagem de sucesso
Objeto do webhook atualizado
Identificador único do webhook
UUID do agente ao qual este webhook pertence
Nome atualizado do webhook
URL atualizada do webhook
Array atualizado de tipos de evento configurados
Timeout atualizado da requisição em segundos
Tentativas máximas de retry atualizadas
Status atualizado do webhook
Timestamp ISO 8601 quando o webhook foi criado
Timestamp ISO 8601 quando o webhook foi atualizado pela última vez
Número de eventos configurados para este webhook
Status atual do webhook
Respostas de erro
Regras de validação
- name: Opcional, string, máximo de 255 caracteres
- webhook_url: Opcional, URL válida, máximo de 500 caracteres
- webhook_secret: Opcional, string, máximo de 255 caracteres
- events: Opcional, array com mínimo de 1 evento, cada evento deve estar na lista de eventos disponíveis
- timeout: Opcional, inteiro entre 5-120 segundos
- max_retries: Opcional, inteiro entre 0-10
- enabled: Opcional, booleano
Observações importantes
- Todos os campos são opcionais — apenas os campos fornecidos serão atualizados
- Operações de webhook limpam automaticamente o cache do agente para efeito imediato
- Use endpoints HTTPS para URLs de webhook em produção
- Implemente verificação adequada de assinatura usando o webhook secret para segurança
Endpoints relacionados
- Listar Webhooks do Agente - Obter todos os webhooks de um agente
- Criar Webhook - Configurar um novo webhook
- Obter Detalhes do Webhook - Recuperar informações de um webhook específico
- Excluir Webhook - Remover a configuração do webhook
- Alternar Status do Webhook - Habilitar/desabilitar webhook
- Testar Webhook - Enviar payload de teste para verificar conectividade