Pular para o conteúdo principal
POST
/
api
/
v1
/
agents
/
{agent_id}
/
publish
curl -X POST "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/publish" \
  -H "Authorization: Bearer talq_your_environment_token_here"
{
  "success": true,
  "message": "Agent published successfully",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "SupportBot",
    "current_status": "published",
    "is_ready_to_publish": true,
    "updated_at": "2024-01-15T10:50:00Z"
  }
}

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.

Publicar Agente

Publica um agente para marcá-lo como ativo. Um agente publicado pode receber chamadas de entrada ou ser usado para realizar chamadas de saída.

Endpoint

POST /api/v1/agents/{agent_id}/publish

Parâmetros de Caminho

agent_id
string
obrigatório
O identificador único do agente de voz a ser publicado.

Cabeçalhos da Requisição

Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here

Exemplos

curl -X POST "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/publish" \
  -H "Authorization: Bearer talq_your_environment_token_here"

Resposta

{
  "success": true,
  "message": "Agent published successfully",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "SupportBot",
    "current_status": "published",
    "is_ready_to_publish": true,
    "updated_at": "2024-01-15T10:50:00Z"
  }
}

Observações

  • O agente deve estar devidamente configurado (conhecimento, voz, configurações de chamada) antes de poder ser publicado. Se is_ready_to_publish for false, a chamada de publicação falhará com um erro de validação 422 explicando o que está faltando.
  • Publicar um agente de saída não inicia chamadas — use Realizar uma Chamada para despachar chamadas de saída.
  • Para desativar temporariamente um agente publicado, use Despublicar Agente.