Operadores
Crear Operador
Crear un nuevo operador de campo.
POST /api/operators
Crea un nuevo operador con tipo, información de contacto y metadatos.
Auth: Requerida — permiso MANAGE_OPERATORS
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
type | string | Sí | SALESMAN, ACTIVATOR o CALLCENTER |
name | string | Sí | Nombre del operador |
email | string | No | Dirección de correo electrónico |
phone | string | No | Número de teléfono |
external_id | string | No | Identificador en sistema externo |
is_placeholder | boolean | No | Marcar como registro de marcador de posición |
metadata | object | No | JSON arbitrario |
Ejemplo
curl -X POST https://api.reten.ai/api/operators \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>" \
-H "Content-Type: application/json" \
-d '{
"type": "SALESMAN",
"name": "John Doe",
"email": "john.doe@example.com",
"phone": "+56912345678",
"external_id": "emp-001"
}'const response = await fetch("https://api.reten.ai/api/operators", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
"Content-Type": "application/json",
},
body: JSON.stringify({
type: "SALESMAN",
name: "John Doe",
email: "john.doe@example.com",
phone: "+56912345678",
external_id: "emp-001",
}),
});
const operator = await response.json();import requests
response = requests.post(
"https://api.reten.ai/api/operators",
headers={
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
json={
"type": "SALESMAN",
"name": "John Doe",
"email": "john.doe@example.com",
"phone": "+56912345678",
"external_id": "emp-001",
},
)
operator = response.json()Respuesta 201 Created
{
"id": "cc0e8400-e29b-41d4-a716-446655440000",
"name": "John Doe",
"email": "john.doe@example.com",
"phone": "+56912345678",
"type": "SALESMAN",
"externalId": "emp-001",
"isActive": true,
"isPlaceholder": false
}Respuestas de Error
| Estado | Descripción |
|---|---|
409 | El correo electrónico ya existe o hay un duplicado de type + externalId |