Pular para o conteúdo principal
PUT
/
api
/
v1
/
agents
/
{agent_id}
/
webhooks
/
{webhook_id}
curl -X PUT \
  'https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Updated Webhook Name",
    "webhook_url": "https://newexample.com/webhook",
    "webhook_secret": "new_secret",
    "events": ["event_phone_call_started", "event_conversation_started"],
    "timeout": 45,
    "max_retries": 5,
    "enabled": false
  }'
{
  "success": true,
  "message": "Webhook updated successfully",
  "data": {
    "id": "9fcafbf2-7593-44d6-8cd7-1b221beba62a",
    "agent_id": "9fbef0b7-8d4e-4a08-9207-66c22155721d",
    "name": "Updated Webhook Name",
    "webhook_url": "https://newexample.com/webhook",
    "events": ["event_phone_call_started", "event_conversation_started"],
    "timeout": 45,
    "max_retries": 5,
    "enabled": false,
    "created_at": "2025-09-03T23:19:51.000000Z",
    "updated_at": "2025-09-03T23:45:30.000000Z",
    "events_count": 2,
    "status": "disabled"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

Use this file to discover all available pages before exploring further.

Visão Geral

Atualiza uma configuração de webhook existente. Todos os campos são opcionais — apenas os campos fornecidos serão atualizados.

Endpoint

agent_id
string
obrigatório
UUID do agente
webhook_id
string
obrigatório
UUID do webhook

Requisição

curl -X PUT \
  'https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Updated Webhook Name",
    "webhook_url": "https://newexample.com/webhook",
    "webhook_secret": "new_secret",
    "events": ["event_phone_call_started", "event_conversation_started"],
    "timeout": 45,
    "max_retries": 5,
    "enabled": false
  }'

Resposta

success
boolean
Indica se o webhook foi atualizado com sucesso
message
string
Mensagem de sucesso
data
object
Objeto do webhook atualizado
data.id
string
Identificador único do webhook
data.agent_id
string
UUID do agente ao qual este webhook pertence
data.name
string
Nome atualizado do webhook
data.webhook_url
string
URL atualizada do webhook
data.events
array
Array atualizado de tipos de evento configurados
data.timeout
integer
Timeout atualizado da requisição em segundos
data.max_retries
integer
Tentativas máximas de retry atualizadas
data.enabled
boolean
Status atualizado do webhook
data.created_at
string
Timestamp ISO 8601 quando o webhook foi criado
data.updated_at
string
Timestamp ISO 8601 quando o webhook foi atualizado pela última vez
data.events_count
integer
Número de eventos configurados para este webhook
data.status
string
Status atual do webhook
{
  "success": true,
  "message": "Webhook updated successfully",
  "data": {
    "id": "9fcafbf2-7593-44d6-8cd7-1b221beba62a",
    "agent_id": "9fbef0b7-8d4e-4a08-9207-66c22155721d",
    "name": "Updated Webhook Name",
    "webhook_url": "https://newexample.com/webhook",
    "events": ["event_phone_call_started", "event_conversation_started"],
    "timeout": 45,
    "max_retries": 5,
    "enabled": false,
    "created_at": "2025-09-03T23:19:51.000000Z",
    "updated_at": "2025-09-03T23:45:30.000000Z",
    "events_count": 2,
    "status": "disabled"
  }
}

Respostas de Erro

{
  "message": "Missing Bearer Token"
}
{
  "success": false,
  "message": "Agent not found in this environment."
}
{
  "success": false,
  "message": "Webhook not found."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "webhook_url": ["The webhook url must be a valid URL."],
    "events": ["The events field must contain at least 1 items."]
  }
}

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