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
string
obrigatório
UUID do agente
string
obrigatório
UUID do webhook
Requisição
Resposta
boolean
Indica se o webhook foi atualizado com sucesso
string
Mensagem de sucesso
object
Objeto do webhook atualizado
string
Identificador único do webhook
string
UUID do agente ao qual este webhook pertence
string
Nome atualizado do webhook
string
URL atualizada do webhook
array
Array atualizado de tipos de evento configurados
integer
Timeout atualizado da requisição em segundos
integer
Tentativas máximas de retry atualizadas
boolean
Status atualizado do webhook
string
Timestamp ISO 8601 quando o webhook foi criado
string
Timestamp ISO 8601 quando o webhook foi atualizado pela última vez
integer
Número de eventos configurados para este webhook
string
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