DOCUMENTACIÓN PÚBLICA · DATOS PRIVADOS
MCP de llamadas
Conecta tu agente a la cola de coordinación de Yokup. El centro combina operadores humanos, salas web y un asistente con guion para expedientes de prueba. La telefonía IA no está activada.
Acceso
Entra en /llamadas con una cuenta autorizada y abre «Conectar un agente por MCP». Crea un token, guárdalo en la bóveda del agente y envíalo en Authorization: Bearer TOKEN. Caduca en siete días, puede revocarse y conserva solo los permisos actuales de esa cuenta. Nunca lo publiques ni lo pongas en una URL.
Endpoint: https://data.yokup.com/mcp/calls. Transporte HTTP JSON-RPC 2.0, respuestas JSON. initialize y tools/list son públicos; tools/call exige token. No usa cookies ni SSE. Los clientes deben permitir configurar el encabezado Bearer. No ofrece descubrimiento OAuth.
| Herramienta | Argumentos | Resultado |
|---|---|---|
| calls_list | {} | Hasta 1.000 trabajos visibles para la cuenta, urgentes primero. |
| calls_case | case_id | Incidencia, contactos, técnicos a menos de 40 km, propuestas e historial. |
| calls_reserve | job_id | Reserva exclusiva para una persona, durante cinco minutos. |
| calls_release | job_id | Libera la reserva propia si no hay intento activo. |
| calls_finish | job_id, outcome, notes; availability y retry_at opcionales | Finaliza un intento propio iniciado en el centro y registra el resultado. |
outcome: availability, agreed, declined, no_answer, busy, voicemail, human_handoff u other. notes: 3–2.000 caracteres. availability exige una franja descrita. retry_at es una fecha futura Unix en milisegundos, hasta 30 días. human_handoff devuelve el trabajo a la cola humana con el contexto guardado.
Ejemplo
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {"name": "calls_list", "arguments": {}}
}Las respuestas de herramientas incluyen content con el JSON y isError. Autenticación ausente o inválida: error JSON-RPC -32001; parámetros no válidos: -32602. Un conflicto de reserva o agenda devuelve isError:true y su explicación.
Límites del contrato
El MCP no inicia llamadas, no acepta propuestas ni concede permisos. Estas acciones se realizan en el centro autenticado. Reservar o terminar un intento no acredita que una llamada haya conectado ni confirma una cita. La visita solo queda confirmada al registrar la aceptación expresa del comercio y el técnico sobre la misma fecha, alcance e importe.
Los expedientes de prueba están identificados y no crean avisos a profesionales reales. La señalización de una sala usa invitaciones independientes, limitadas a esa sala y a una hora; nunca se comparte el token MCP con el invitado.