Pular para o conteúdo principal
GET
/
api
/
v1
/
agents
/
{agent_id}
/
webhooks
/
{webhook_id}
curl -X GET \
  'https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "success": true,
  "data": {
    "id": "9fcafbf2-7593-44d6-8cd7-1b221beba62a",
    "agent_id": "9fbef0b7-8d4e-4a08-9207-66c22155721d",
    "name": "Meu Webhook",
    "webhook_url": "https://example.com/webhook",
    "events": ["event_phone_call_started", "event_phone_call_ended"],
    "timeout": 30,
    "max_retries": 3,
    "enabled": true,
    "created_at": "2025-09-03T23:19:51.000000Z",
    "updated_at": "2025-09-03T23:37:01.000000Z",
    "events_count": 2,
    "status": "active"
  }
}

​
Visão Geral

Recupera informações detalhadas sobre uma configuração de webhook específica, incluindo seu status atual, eventos configurados e metadados.

​
Endpoint

​
agent_id
string
obrigatório
UUID do Agente
​
webhook_id
string
obrigatório
UUID do Webhook

​
Requisição

curl -X GET \
  'https://app.talkover.ai/api/v1/agents/9fbef0b7-8d4e-4a08-9207-66c22155721d/webhooks/9fcafbf2-7593-44d6-8cd7-1b221beba62a' \
  -H 'Authorization: Bearer YOUR_TOKEN'

​
Resposta

​
success
boolean
Indica se a requisição foi bem-sucedida
​
data
object
Detalhes da configuração do webhook
​
data.id
string
Identificador único do webhook
​
data.agent_id
string
UUID do agente ao qual este webhook pertence
​
data.name
string
Nome legível do webhook
​
data.webhook_url
string
URL onde os eventos do webhook serão enviados
​
data.events
array
Array de tipos de eventos que este webhook está configurado para receber
​
data.timeout
integer
Timeout da requisição em segundos (5-120)
​
data.max_retries
integer
Número máximo de tentativas de nova tentativa (0-10)
​
data.enabled
boolean
Se o webhook está atualmente ativo
​
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 (ativo, desabilitado, erro)
{
  "success": true,
  "data": {
    "id": "9fcafbf2-7593-44d6-8cd7-1b221beba62a",
    "agent_id": "9fbef0b7-8d4e-4a08-9207-66c22155721d",
    "name": "Meu Webhook",
    "webhook_url": "https://example.com/webhook",
    "events": ["event_phone_call_started", "event_phone_call_ended"],
    "timeout": 30,
    "max_retries": 3,
    "enabled": true,
    "created_at": "2025-09-03T23:19:51.000000Z",
    "updated_at": "2025-09-03T23:37:01.000000Z",
    "events_count": 2,
    "status": "active"
  }
}

​
Respostas de erro

{
  "message": "Token Bearer ausente"
}

{
  "success": false,
  "message": "Agente não encontrado neste ambiente."
}

{
  "success": false,
  "message": "Webhook não encontrado."
}

​
Endpoints relacionados