Guía del Portal de Operadores

El Portal de Operadores es un formulario web para que el personal de un cliente (por ejemplo, una farmacia o una asistencia al viajero) registre a un paciente y le envíe el acceso a una videoconsulta médica online. No requiere integración técnica ni clave API: el operador entra con su usuario y contraseña. Los mismos accesos también pueden generarse por API.

Las modalidades de acceso comparan el portal con las otras formas en que un paciente llega a la videoconsulta: la landing de autogestión y la integración SSO.

Acceso

Cada operador tiene un usuario propio. El link puede indicar el proveedor por su nombre; si no lo indica, o si ese proveedor no está disponible, el portal muestra los disponibles para elegir.

Para dar de alta un operador o sumar un proveedor, contacte al equipo de Nume.

Flujo

1. El operador inicia sesión y elige el proveedor.
2. Completa los datos del paciente.
3. Presiona Generar token.
4. Nume envía al email y al WhatsApp del paciente el link de acceso a la videoconsulta.
5. La pantalla muestra el mismo link para copiarlo o volver a compartirlo por WhatsApp.
6. El paciente abre el link e ingresa a la consulta. El link vence a los 30 minutos.
7. Con Registrar otro paciente el formulario queda listo para el siguiente.

Ejemplo del formulario

Así se ve el portal con los datos de un paciente cargados.

Datos de ejemplo

Ver formulario completo

Datos del paciente

Algunos datos opcionales son obligatorios para ciertos clientes. Si faltan, el portal lo indica al generar el token.

Resultado

• Token generado: el paciente recibe el email y un WhatsApp con el link. La opción Ver email muestra el mensaje enviado.
• Email o WhatsApp no enviado: el token se generó pero alguno de los envíos no pudo hacerse. El link sigue siendo válido y debe compartirse copiándolo o con el botón de WhatsApp.
• Recientes: lista los links generados durante la sesión. No se guarda: al cerrar la página, la lista se pierde.

Uso por API

Genera el mismo acceso que el formulario, desde su sistema: Nume devuelve el link y lo envía al paciente por email y por WhatsApp, salvo con notifyPatient: false (ver Autogestión por API). Se autentica con la clave API que entrega Nume, en el header Authorization: Bearer TU_CLAVE_API. Si la landing de autogestión de su empresa pide el código del operador, cada solicitud debe incluir accessCode y la clave API sola no alcanza. Cada operador ve su código del día en el Portal de Operadores (ver Autogestión por API).

curl -X POST https://api.nuevometodo.com/lad/tokens \
  -H "Authorization: Bearer TU_CLAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Juan Pérez",
    "documentType": "DNI",
    "documentNumber": "30111222",
    "email": "juan@ejemplo.com",
    "phone": "+5491122334455"
  }'

{
  "url": "https://nuevometodo.com/consulta/4f1c2b8e-9a3d-4e5f-8b6a-1c2d3e4f5a6b#t=eyJhbGciOi...",
  "emailSent": true,
  "whatsappSent": true
}

Otras respuestas: 400 si faltan datos, falta el código de acceso o no es válido (ver Autogestión por API) o el servicio de videoconsulta no respondió (ver mensajes de error), 401 si la clave no es válida o la llamada sale de un origen no habilitado, y 403 si su empresa no tiene un proveedor habilitado (contactar al equipo de Nume).

Autogestión por API

Permite que el paciente cargue sus datos en un formulario propio e ingrese directamente a la videoconsulta, como en la landing de autogestión. El formulario envía los datos a su servidor, que llama al mismo endpoint con su clave API y notifyPatient: false. La clave API no debe exponerse en el navegador.

Nume no envía el link al paciente. Su sistema tiene que redirigir al paciente al url de la respuesta, abrirlo en una pestaña nueva o mostrarlo en un iframe (ver Videoconsulta embebida). El url vence a los 30 minutos de generado. Los campos obligatorios no cambian, incluidos email y phone.

curl -X POST https://api.nuevometodo.com/lad/tokens \
  -H "Authorization: Bearer TU_CLAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Juan Pérez",
    "documentType": "DNI",
    "documentNumber": "30111222",
    "email": "juan@ejemplo.com",
    "phone": "+5491122334455",
    "notifyPatient": false,
    "accessCode": "K7NP2Q"
  }'

{
  "url": "https://nuevometodo.com/consulta/4f1c2b8e-9a3d-4e5f-8b6a-1c2d3e4f5a6b#t=eyJhbGciOi...",
  "emailSent": null,
  "whatsappSent": null
}

Código de acceso del operador

Si la landing de autogestión de su empresa pide el código del operador, la API también lo exige: el formulario propio debe pedirle al paciente ese mismo código y su servidor debe enviarlo en accessCode, en todas las solicitudes, incluidas las que no usan notifyPatient: false.

• Debe ser el código vigente de un operador de su empresa, el que cada operador ve en el Portal de Operadores. No distingue mayúsculas de minúsculas e ignora los espacios.
• Con un código válido, el acceso queda registrado a nombre del operador dueño de ese código.
• Si accessCode falta, está vacío, es null, no es correcto, es de otra empresa o ya venció, la respuesta es 400 y no se genera el acceso. Cada código vale hasta las 00:00 siguientes a su generación (fin del día), en la hora del país de su empresa.
• Si la landing de autogestión de su empresa no pide el código, el campo no es obligatorio y se ignora.
• Con más de 32 caracteres, la respuesta es 400 de validación, como cuando faltan datos, aunque la landing no pida el código.

{
  "key": "lad.patient_form_access_code_invalid",
  "message": "El código no es correcto."
}

Obras sociales

Devuelve los nombres de las obras sociales y prepagas de un país. El nombre elegido se envía tal cual en healthInsurance; para un paciente sin cobertura se envía Sin obra social. El país va al final de la ruta, como código ISO de dos letras (por ejemplo, AR para Argentina), y se puede consultar cualquier país. Si el país no tiene listado, la respuesta es 404 y healthInsurance lleva el nombre de la cobertura. Se autentica con la misma clave API.

curl https://api.nuevometodo.com/lad/health-insurances/AR \
  -H "Authorization: Bearer TU_CLAVE_API"

[
  "Sin obra social",
  "22 DE DICIEMBRE",
  "OSDE",
  "SWISS MEDICAL"
]

{
  "key": "lad.health_insurances_not_found",
  "message": "No hay un listado de obras sociales para ese país."
}

Otras respuestas: 401 si la clave no es válida, y 403 si su empresa no tiene habilitada la videoconsulta (contactar al equipo de Nume).

Mensajes de error

Datos y privacidad

• Los datos del paciente se envían al servicio de videoconsulta para crear el acceso. El email y el teléfono se usan para enviarle el link, salvo que la solicitud por API indique notifyPatient: false.
• De cada solicitud, Nume registra la fecha, el proveedor, el email del paciente, el resultado y si el paciente abrió el link.
• El link da acceso a una consulta médica: compártalo solo con el paciente.