NOMBRES
NODRA, Human Signal y + NODRA
NODRA es la marca. Human Signal es el servicio. + NODRA es un patrón de referencia para chats y asistentes, no una interfaz obligatoria.
DOCUMENTACIÓN BREVE
Lo esencial antes de implementar.
Esta referencia explica el modelo de integración sin obligarte a recorrer formularios técnicos o respuestas JSON.
NODRA define el método y Human Signal aporta la infraestructura. El Partner conserva el control de la experiencia visual: activación, acceso de revisores, distribución de casos y presentación del resultado.
ACTIVACIÓN
El Partner decide cómo aparece
Puede ser un botón, menú, complemento, ícono, regla automática u otra acción comprensible dentro del producto.
ARQUITECTURA
Frontend → Backend Partner → NODRA
El frontend nunca recibe la API key. Tu backend crea casos, consulta progreso y recibe webhooks.
CONFIRMACIÓN
Confirmar cuando corresponde
Si una persona inicia la solicitud, debe comprender qué contenido será enviado y confirmar antes de crear el caso. Si el Partner activa Human Signal mediante una regla automática propia, debe hacer visible ese estado de forma coherente con su experiencia y políticas.
INTERFAZ DEL REVISOR
Casos donde puedo aportar
El Partner debe ofrecer a sus personas autorizadas una forma de descubrir y abrir los casos que pueden revisar: bandeja, portal, cola, grupo, notificación u otra experiencia propia.
PERSONAS
Una persona, una señal válida
Las referencias de revisores son pseudónimas y estables dentro del dominio del Partner.
RESULTADO
Provisional o final
La interfaz debe distinguir cobertura incompleta de resultado final y mostrar atribución a NODRA Human Signal.
OPERACIÓN
El Lab no es el producto final
El Lab sirve para aprender y probar. En producción, la solicitud, la revisión y el retorno se integran en las interfaces y procesos del Partner.
CICLO MÍNIMO
La secuencia que toda integración debe conservar.
Activar y confirmar
El Partner decide la acción visual; el usuario comprende qué solicita y confirma cuando corresponde.
Crear y distribuir
Guardar reviewId, panel y contexto; luego mostrar o asignar el caso a las personas autorizadas adecuadas.
Recoger señales humanas
Cada revisor abre el caso, aporta una señal válida y cubre el puesto que le corresponde.
Devolver el consenso
Resultado, advertencias, desacuerdos, finalidad y atribución vuelven al contexto original.
CONTINUAR