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

{
  "success": true,
  "message": "Webhook de teste enviado com sucesso",
  "data": {
    "status_code": 200,
    "response_time": 150
  }
}

​
Visão Geral

Envia um payload de teste para a URL do webhook para verificar conectividade e garantir que seu endpoint está configurado corretamente para receber eventos de webhook.

​
Endpoint

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

​
Requisição

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

​
Payload de Teste

Quando você chama o endpoint de teste, o seguinte payload será enviado para sua URL de webhook: 
{
  "event": "webhook.test",
  "agent_id": "9fbef0b7-8d4e-4a08-9207-66c22155721d",
  "agent_name": "Meu Agente",
  "webhook_id": "9fcafbf2-7593-44d6-8cd7-1b221beba62a",
  "webhook_name": "Meu Webhook",
  "timestamp": "2025-09-03T23:19:51.000Z",
  "test": true
}

​
Resposta

​
success
boolean
Indica se o webhook de teste foi enviado com sucesso
​
message
string
Mensagem de sucesso
​
data
object
Dados dos resultados do teste
​
data.status_code
integer
Código de status HTTP retornado pelo seu endpoint de webhook
​
data.response_time
integer
Tempo de resposta em milissegundos
{
  "success": true,
  "message": "Webhook de teste enviado com sucesso",
  "data": {
    "status_code": 200,
    "response_time": 150
  }
}

​
Respostas de erro

{
  "message": "Token Bearer ausente"
}

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

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

{
  "success": false,
  "message": "Teste de webhook falhou: Timeout de conexão"
}

{
  "success": false,
  "message": "Teste de webhook falhou: HTTP 500 Erro Interno do Servidor"
}

​
Notas Importantes

  • O payload de teste usa o tipo de evento webhook.test para distingui-lo de eventos reais
  • Seu endpoint de webhook deve retornar um código de status HTTP 2xx para testes bem-sucedidos
  • O teste respeita o timeout configurado do webhook e configurações de nova tentativa
  • Use este endpoint para verificar conectividade antes de ir ao ar com eventos de webhook
  • Payloads de teste incluem o campo test: true para ajudar a identificá-los em seus logs

​
Requisitos do Endpoint de Webhook

Seu endpoint de webhook deve:
  1. Aceitar requisições POST com payloads JSON
  2. Retornar códigos de status 2xx para processamento bem-sucedido
  3. Responder dentro do timeout configurado (padrão: 30 segundos)
  4. Lidar com o tipo de evento de teste adequadamente
  5. Implementar verificação de assinatura adequada se usando segredos de webhook

​
Endpoints relacionados