Pular para o conteúdo principal
PUT
/
api
/
v1
/
agents
/
{agent_id}
/
calling
# Outbound with multiple phone numbers
curl -X PUT "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/calling" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": "outbound",
    "phone_number_ids": ["phone-uuid-1", "phone-uuid-2"]
  }'

{
  "success": true,
  "message": "Agent calling settings updated successfully",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "SupportBot",
    "direction": "outbound",
    "current_status": "draft",
    "phone_numbers": [
      {
        "id": "phone-uuid-1",
        "number": "+1234567890",
        "country_code": "US",
        "formatted_number": "(123) 456-7890",
        "current_status": "active"
      },
      {
        "id": "phone-uuid-2",
        "number": "+1987654321",
        "country_code": "US",
        "formatted_number": "(987) 654-3210",
        "current_status": "active"
      }
    ],
    "updated_at": "2024-01-15T10:45: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.

​
Atualizar Configurações de Chamada do Agente

Atualiza a direção da chamada (entrada/saída) e os números de telefone atribuídos ao agente.

​
Endpoint

PUT /api/v1/agents/{agent_id}/calling

​
Parâmetros de Caminho

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

​
Cabeçalhos da Requisição

​
Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here
​
Content-Type
string
obrigatório
Deve ser definido como application/json

​
Parâmetros do Corpo da Requisição

​
direction
string
obrigatório
Direção da chamada. Opções: inbound, outbound.
​
phone_number_ids
array
Array de UUIDs de números de telefone a atribuir ao agente.

​
Exemplos

# Outbound with multiple phone numbers
curl -X PUT "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/calling" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": "outbound",
    "phone_number_ids": ["phone-uuid-1", "phone-uuid-2"]
  }'

​
Resposta

{
  "success": true,
  "message": "Agent calling settings updated successfully",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "SupportBot",
    "direction": "outbound",
    "current_status": "draft",
    "phone_numbers": [
      {
        "id": "phone-uuid-1",
        "number": "+1234567890",
        "country_code": "US",
        "formatted_number": "(123) 456-7890",
        "current_status": "active"
      },
      {
        "id": "phone-uuid-2",
        "number": "+1987654321",
        "country_code": "US",
        "formatted_number": "(987) 654-3210",
        "current_status": "active"
      }
    ],
    "updated_at": "2024-01-15T10:45:00Z"
  }
}

​
Observações

  • Definir direction: "inbound" configura o agente para receber chamadas nos números atribuídos.
  • Definir direction: "outbound" configura o agente para realizar chamadas a partir dos números atribuídos.
  • Os números de telefone já devem existir em seu ambiente. Use o endpoint Listar Números de Telefone para recuperar os IDs disponíveis.