Skip to main content
Usa la tool schedule_call_tool con la acción scheduleCall para reservar una llamada futura en la agenda del agente.
Necesitas un agente de voz habilitado con disponibilidades publicadas. Autentícate con una API Key (tools:execute) y agrega el header Workspace-Id.

​
Ejecutar desde el SDK

import { createClient } from "@getsupervisor/agents-studio-sdk";

const client = createClient({
  baseUrl: "https://api-prod.studio.getsupervisor.ai/v1",
  workspaceId: process.env.WORKSPACE_ID!,
  apiKey: process.env.API_KEY!,
});

const response = await client.tools.execute(
  "schedule_call_tool",
  {
    agentId: "11111111-2222-3333-4444-555555555555",
    action: "scheduleCall",
    args: {
      proposed_datetime_iso: "2025-07-02T15:00:00-06:00",
      notes: "Confirmar demo con el equipo comercial",
      metadata: {
        customerId: "cust-789",
        priority: "high",
      },
    },
  },
  {
    idempotencyKey: `schedule-${Date.now()}`,
  }
);

console.log(response.result.referenceId, response.result.scheduledFor);

​
Respuesta esperada

{
  "status": "ok",
  "result": {
    "status": "scheduled",
    "scheduledFor": "2025-07-02T21:00:00.000Z",
    "referenceId": "sch_01J8XT8Q9R0S1T2U3V4W"
  },
  "metadata": {
    "proposedAt": "2025-07-02T21:00:00.000Z",
    "scheduledStart": "2025-07-02T21:00:00.000Z",
    "scheduledEnd": "2025-07-02T21:15:00.000Z",
    "scheduledStartLocal": "2025-07-02T15:00:00-06:00",
    "scheduledEndLocal": "2025-07-02T15:15:00-06:00",
    "timezone": "America/Mexico_City",
    "windowSource": "agent_schedule",
    "windowDayOfWeek": 3
  }
}

​
Validaciones clave

  • proposed_datetime_iso: cadena ISO 8601 con zona horaria.
  • notes: cadena opcional para compartir contexto con el agente.
  • metadata: objeto plano opcional; se fusiona con la metadata de la conexión.
  • Límite de búsqueda: el planificador intenta encontrar disponibilidad hasta 30 días después de la fecha propuesta.
Si no se encuentra disponibilidad en el horizonte configurado obtendrás 400 Unable to find an available window. Ajusta la fecha propuesta o amplía los horarios del agente.