Agenti

Elenca i tuoi agenti AI configurati.

Elencare gli agenti

GET /v1/agents

Recupera tutti gli agenti AI attivi nella tua organizzazione.

Scope richiesto: agents:read

Parametri di query

Parametro	Tipo	Descrizione
page	integer	Numero pagina (default: 1)
limit	integer	Risultati per pagina (default: 20, max: 100)

Esempio

curl "https://api.replicer.ai/v1/agents" \
  -H "Authorization: Bearer rpl_live_your_api_key_here"

Risposta 200 OK

{
  "data": [
    {
      "id": "clx-agent-001",
      "agentName": "Agente Vendite",
      "agentType": "outbound_sales",
      "callDirection": "OUTBOUND",
      "voiceId": "voice-natural-en-1",
      "language": "it",
      "isActive": true,
      "createdAt": "2026-01-15T10:00:00Z"
    },
    {
      "id": "clx-agent-002",
      "agentName": "Assistenza Clienti",
      "agentType": "support",
      "callDirection": "INBOUND",
      "voiceId": "voice-friendly-en-2",
      "language": "it",
      "isActive": true,
      "createdAt": "2026-02-20T14:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "totalPages": 1
  },
  "requestId": "req-abc123"
}

Campi dell'agente

Campo	Tipo	Descrizione
id	string	ID univoco dell'agente — usalo in Crea Chiamata
agentName	string	Nome visualizzato dell'agente
agentType	string	Tipo di agente (es. outbound_sales, support)
callDirection	string	INBOUND o OUTBOUND
voiceId	string	ID voce predefinita
language	string	Codice lingua predefinita
isActive	boolean	Sempre true (vengono restituiti solo gli agenti attivi)
createdAt	string	Timestamp ISO 8601 di creazione

TIP

Usa l'id di un agente da questa lista come agentId quando crei una chiamata.