Integración de ABHA para aplicaciones de telemedicina: API V3 y guía de ABDM

Cómo integrar ABHA en una aplicación de telemedicina en 2026: llamadas a la API V3, OTP de Aadhaar, el flujo de consentimiento, hitos de M1 a M3, pruebas en entorno aislado y producción de ABDM.

Praveen SomanDirector ejecutivo de Sigosoft Actualizado 11 minutos de lectura
Un anciano participa en una videoconsulta por teléfono en su casa mientras su hija sostiene una carpeta con informes médicos antiguos.

Para integrar ABHA en una aplicación de telemedicina, regístrese en el entorno de pruebas de ABDM, obtenga un token de acceso a la puerta de enlace y acceda a la clave pública de ABDM. A continuación, cree o verifique el ABHA del paciente mediante las API de inscripción e inicio de sesión V3, cifrando el número Aadhaar y la OTP con RSA antes de enviarlos. Esto cubre el hito M1 de ABDM. Para compartir y recuperar registros de consulta, añada M2 y M3, y luego supere las pruebas funcionales de NHA y una auditoría de seguridad antes de obtener las claves de producción.

He aquí por qué es importante en la práctica. Un paciente en Kozhikode se conecta a una videoconsulta y el médico le pide el informe de HbA1c del año pasado. Sin ABHA, el paciente busca entre las fotos de WhatsApp mientras el tiempo corre. Con ABHA integrado, el paciente aprueba la solicitud en su teléfono y el informe aparece en la pantalla del médico. Ese pequeño detalle es lo que se está creando.

Las llamadas a la API que se describen a continuación siguen las API V3 de ABDM, que reemplazaron los flujos V1 y V2 anteriores.

Respuesta rápida

  • Qué es ABHA: un identificador sanitario de 14 dígitos en el marco de la Misión Digital Ayushman Bharat (ABDM), gestionada por la Autoridad Nacional de Salud (NHA).
  • Lo que hace tu aplicación con ello: crear un nuevo ABHA, verificar uno existente, mostrar la tarjeta ABHA y vincular los registros de consulta
  • ¿Qué hito? La creación y verificación de ABHA es M1. Compartir registros es M2 (HIP). Obtener registros es M3 (HIU).
  • Dónde lo construyas: El entorno aislado ABDM, utilizando las API V3.
  • Lo que necesitas para empezar: Pruebas funcionales de NHA, una auditoría de seguridad realizada por una agencia acreditada por CERT-In y credenciales de producción.

¿Por qué la integración de ABHA es importante para la telemedicina en 2026?

ABHA ya no es una identificación minoritaria. El Ministerio de Salud informó al Lok Sabha que se habían creado 95.99 crore de identificaciones ABHA para el 31 de julio de 2026. En la reunión del Grupo Directivo de la Misión ABDM, celebrada el 10 de julio de 2026, el ministerio también informó sobre más de 105 crore de registros de salud vinculados, 5.33 lakh de centros registrados y 2.72 lakh de centros que utilizan software habilitado para ABDM.

Gráfico de barras del número acumulado de identificaciones ABHA en India, que aumenta de 14.7 crore en 2021 a 95.99 crore en julio de 2026.

Para un negocio de telemedicina, eso cambia tres cosas:

  • Los pacientes ya tienen un ABHA.
    Muchos de ellos lo consiguieron en un hospital público o en un campamento. Pedirles que vuelvan a introducir sus datos resulta engorroso cuando bastaría con escanear un código QR o usar una contraseña de un solo uso.
  • Los pacientes del hospital lo solicitan.
    Los hospitales y clínicas que trabajan con programas gubernamentales esperan cada vez más contar con software compatible con ABDM.
  • Los médicos obtienen un mejor contexto
    Las recetas y los informes anteriores llegan al médico con su consentimiento, por lo que la consulta es más corta y segura.

Esta guía abarca ambas facetas del trabajo de ABHA: la perspectiva empresarial de ABDM (hitos, consentimiento, certificación y protección de datos) y las consultas sobre la versión 3 que realizan sus desarrolladores.

Hitos de integración de ABHA: M1, M2 y M3

MilestoneQué hace tu aplicación de telemedicinaFunción de ABDM
M1Cree su cuenta ABHA, verifique su cuenta ABHA, muestre la tarjeta ABHA y el código QR, y acepte la opción Escanear y Compartir al registrarse.Servicios de ABHA
M2Vincule cada consulta como un contexto de atención y comparta los registros cuando el paciente dé su consentimiento.Proveedor de información de salud (HIP)
M3Solicitar los registros del paciente a otros proveedores y mostrárselos al médico.Usuario de información de salud (UIS)
Diagrama de hitos de ABDM: M1 Creación y verificación de ABHA, M2 Compartir registros como HIP, M3 Obtener registros como HIU

Las guías de integración también describen un cuarto hito, M4, para las reclamaciones de seguros digitales a través del National Health Claims Exchange (NHCX). La mayoría de las aplicaciones de telemedicina no lo necesitan en su lanzamiento, pero vale la pena planificarlo si sus clientes son hospitales que presentan reclamaciones de seguros ( Nirmitee ).

Empiece con M1 y póngalo en funcionamiento con pacientes reales. Tenga en cuenta que NHA ha comunicado a los usuarios del entorno de pruebas en su foro de desarrolladores que se necesitan al menos dos hitos antes de la demostración final del entorno de pruebas, así que planifique M1 y M2 conjuntamente.

Integración de la API de ABHA: las llamadas V3, paso a paso.

Los hosts base en el entorno de pruebas son abhasbx.abdm.gov.in/abha/api para las llamadas a ABHA y dev.abdm.gov.in para la puerta de enlace. El entorno de producción utiliza hosts diferentes y nuevas credenciales, que NHA emite tras la salida del entorno de pruebas.

Paso 1: Obtener acceso al entorno de pruebas

Solicita acceso al entorno de pruebas ABDM con los datos de tu organización y el caso de uso (por ejemplo, una aplicación de teleconsulta). Tras la aprobación, recibirás un ID de cliente y un secreto de cliente. Guarda el secreto en un gestor de secretos desde el primer día, no en tu código.

Paso 2: Obtenga un token de acceso a la puerta de enlace.

Llama a la API de sesiones de la puerta de enlace con tu ID de cliente y tu secreto para obtener un token de portador. Cada llamada posterior envía estos encabezados:

EncabezadoValor
AutorizaciónToken de portador de la API de sesiones
ID DE SOLICITUDUn nuevo UUID para cada solicitud
TIMESTAMPHora actual en formato ISO 8601 UTC, por ejemplo, 2026-10-27T07:30:00.000Z
X-CM-IDsbx en el entorno de pruebas, abdm en producción.

Los tokens caducan, así que almacene en caché el token y actualícelo antes de que caduque, en lugar de llamar a la API de sesiones en cada solicitud.

Paso 3: Obtener la clave pública de ABDM

Llama a GET /v3/profile/public/certificate. ABDM usa esta clave para proteger los números Aadhaar, los números de teléfono móvil y las contraseñas de un solo uso (OTP) en tránsito. Guárdala en caché, pero actualízala periódicamente, ya que la clave se rota.

Paso 4: Encriptar el número Aadhaar

V3 rechaza los números Aadhaar y las OTP en texto plano. Encifíquelos con la clave pública usando RSA con relleno OAEP (SHA-1, MGF1), que el soporte de integración de ABDM describe como RSA/ECB/OAEPWithSHA-1AndMGF1Padding. En Node.js:

import crypto from 'node:crypto';

// publicKeyPem: la clave de /v3/profile/public/certificate, encapsulada como una clave pública PEM
función de exportación encryptForAbdm(valor, publicKeyPem) {
  devolver crypto.publicEncrypt(
    { clave: publicKeyPem, relleno: crypto.constants.RSA_PKCS1_OAEP_PADDING, oaepHash: 'sha1' },
    Buffer.from(valor, 'utf8')
  ).toString('base64');
}

Paso 5: Solicitar el código OTP de Aadhaar

POST /v3/enrollment/request/otp

{
  “txnId”: “”,
  “alcance”: [“abha-enrol”],
  “loginHint”: “aadhaar”,
  “loginId”: “ ”,
  “Sistema OTP”: “aadhaar”
}

La respuesta devuelve un txnId y un mensaje que indica que la OTP se envió al número de teléfono móvil vinculado al Aadhaar del paciente. Guarde el txnId para la próxima llamada.

Paso 6: Verifique el OTP y cree el ABHA.

POST /v3/enrollment/enrol/byAadhaar

{
  “authData”: {
    “authMethods”: [“otp”],
    “otp”: {
      “txnId”: “ ”,
      “otpValue”: “ ”,
      "móvil": " ”
    }
  },
  “consentimiento”: { “código”: “abha-enrollment”, “versión”: “1.4” }
}

Si el número de teléfono móvil que proporciona el paciente es diferente del número vinculado a su Aadhaar, ABDM le pedirá que lo verifique con una segunda OTP. Vuelva a llamar a /v3/enrollment/request/otp con el ámbito mobile-verify y otpSystem configurado como abdm, y luego a /v3/enrollment/auth/byAbdm.

Diagrama de secuencia de creación de ABHA: la aplicación obtiene un token y una clave pública, envía un número Aadhaar cifrado, el paciente recibe una OTP y ABDM devuelve el perfil ABHA.

Paso 7: Permita que los titulares de ABHA existentes inicien sesión.

La mayoría de sus pacientes ya tendrán un ABHA. Para ellos, utilice el flujo de inicio de sesión en lugar del de inscripción: /v3/profile/login/request/otp, y luego /v3/profile/login/verify. Los pacientes pueden iniciar sesión con su número ABHA o su número de teléfono móvil.

Paso 8: Muestre su tarjeta ABHA y acepte Scan & Share.

Tras la creación de la cuenta o el inicio de sesión, muestre al paciente su tarjeta ABHA (/v3/profile/account/abha-card) y su código QR (/v3/profile/account/qrCode). Para las clínicas que también atienden a pacientes sin cita previa, implemente la función Escanear y Compartir, donde el paciente escanea el código QR de su centro y sus datos aparecen en su pantalla de registro. El ministerio informa que se han generado casi 24 millones de tokens de Escanear y Registrarse hasta la fecha, por lo que los pacientes ya están familiarizados con el sistema.

Una vez que M1 funciona, cada teleconsulta se convierte en un contexto de atención vinculado al ABHA del paciente. Cuando otro proveedor lo solicita con el consentimiento del paciente, su aplicación envía los registros como un paquete FHIR cifrado. Para M3, su médico solicita el consentimiento, el paciente lo aprueba en su aplicación de historia clínica electrónica personal (PHR) y los registros llegan a su aplicación.

Un cambio en la versión 3 afecta a muchos equipos: la puerta de enlace llama a su servidor. En la versión 3, la detección de pacientes es síncrona y todas las devoluciones de llamada llegan a una única URL puente, con el encabezado X-HIP-ID que indica a qué centro se dirige la solicitud. Su sistema backend necesita puntos de devolución de llamada públicos y fiables, no solo llamadas salientes a la API.

En M2 y M3, los registros nunca pasan por un archivo central. El paciente decide, caso por caso, quién ve qué:

  1. Su médico, actuando como Usuario de Información Sanitaria (UIS), genera una solicitud de consentimiento a través del portal ABDM.
  2. El paciente lo aprueba en su aplicación de historial clínico electrónico personal y elige qué tipos de registros y qué período de tiempo desea compartir.
  3. La puerta de enlace notifica al proveedor que custodia los registros, el Proveedor de Información Sanitaria (HIP, por sus siglas en inglés).
  4. El sistema HIP envía un paquete FHIR cifrado a tu aplicación, que lo descifra y se lo muestra al médico.

De esto se derivan dos reglas. Enviar únicamente el contexto de atención y el intervalo de tiempo que el paciente aprobó, nunca el historial completo. Y mantener un registro de auditoría de cada solicitud de consentimiento, aprobación y transferencia de datos, ya que la auditoría de seguridad y cualquier consulta sobre protección de datos lo solicitarán.

Después de una teleconsulta, envíe la receta electrónica de vuelta a los registros vinculados a ABHA del paciente como un nuevo contexto de atención, para que el paciente pueda verla en su aplicación PHR y compartirla con el siguiente médico ( Medical365 ).

Diagrama de intercambio basado en el consentimiento: la aplicación del médico solicita los registros, el paciente los aprueba en su aplicación de historial clínico electrónico personal (HCE) y el otro hospital envía los registros cifrados.

Desde el entorno de pruebas de ABDM hasta la producción.

  1. Construye y prueba M1, y luego M2 o M3, en el entorno de pruebas.
  2. Superar las pruebas funcionales de NHA para cada hito.
  3. Obtenga una auditoría de seguridad de aplicaciones web (WASA) de un Agencia acreditada por CERT-InLas empresas de seguridad también denominan al resultado certificado Safe-to-Host.
  4. Realice una demostración del software a la NHA y envíe el formulario de salida del entorno de pruebas.
  5. Reciba las credenciales de producción y cambie a los servidores de producción.
  6. Registre cada centro en el Registro de Centros de Salud. La certificación cubre el software, no cada clínica que lo utiliza.
Seis pasos desde el acceso al entorno de pruebas ABDM hasta las claves de producción: compilación, pruebas funcionales, auditoría de seguridad, demostración de NHA y salida.

La NHA actualiza este proceso, así que confirme los pasos actuales en el sitio de pruebas de ABDM antes de planificar las fechas.

Errores comunes en la integración de ABHA

  1. Copiar tutoriales antiguos
    Muchas entradas de blog, incluida nuestra propia versión anterior de esta, muestran rutas V1 o V2. Compile solo en V3.
  2. Envío de valores Aadhaar o OTP simples
    V3 espera valores cifrados con RSA. Los valores sin cifrar no funcionan.
  3. Marcas de tiempo incorrectas
    Envíe la hora UTC en formato ISO 8601 y mantenga el reloj de su servidor sincronizado con NTP. Un reloj desincronizado provoca que las solicitudes rechazadas parezcan aleatorias.
  4. “Recurso prohibido” (código 900908)
    Esto suele significar que tu ID de cliente no está suscrito a esa API. Solicita al soporte de integración de ABDM que la habilite en lugar de modificar tu código.
  5. Credenciales con espacios ocultos
    Al copiar un secreto de cliente desde el portal, puede que se añada un espacio o un salto de línea al final. Elimínelo.
  6. Considerar ABDM como de salida únicamente.
    M2 y M3 dependen de que sus puntos finales de devolución de llamada sean accesibles desde la puerta de enlace.
  7. Ignorar la protección de datos
    Los flujos de ABHA manejan números Aadhaar y registros de salud. Registros de consentimiento del plan, cifrado y residencia de datos en la India bajo el Ley DPDP para aplicaciones de atención médica desde el comienzo.

Diseñar pantallas ABHA que los pacientes realmente terminan

La API es solo la mitad del trabajo. Los pacientes abandonan los flujos de ABHA cuando se sienten perdidos. Algunos hábitos pueden ayudar:

  • Pregunte primero si el paciente ya tiene una cuenta ABHA y, por defecto, inicie sesión en lugar de crear una.
  • Indica a dónde se enviará el código OTP ("al móvil vinculado a tu Aadhaar") antes de enviarlo.
  • Ofrezca malayalam, hindi, tamil y otros idiomas que utilicen sus pacientes.
  • Explique las solicitudes de consentimiento en palabras sencillas: quién quiere qué registros y durante cuánto tiempo.
  • Si ABHA falla, deje que el paciente continúe la consulta y vuelva a intentarlo más tarde.

Cómo Sigosoft crea aplicaciones de telemedicina compatibles con ABHA

Sigosoft desarrolla aplicaciones de telemedicina para clínicas, hospitales y empresas emergentes del sector salud. Nuestra aplicación Medicino , por ejemplo, combina la reserva de citas médicas, la videoconsulta y la entrega de medicamentos en un solo producto. Para nuestros clientes en India, tenemos previsto incluir ABHA en la primera versión, no como una función adicional posterior.

En un proyecto ABHA, nuestro equipo se encarga de:

Si está planificando un nuevo producto, nuestra guía sobre cómo crear un MVP de telemedicina sin tener que rediseñarlo posteriormente explica cómo dejar espacio para la toma de decisiones basada en resultados (ABDM) desde el principio.

Preguntas Frecuentes

¿Qué es la integración ABHA?

Permite que tu aplicación cree o verifique el número ABHA de un paciente y lo vincule a su historial médico. En términos de ABDM, esto corresponde al hito M1.

¿Qué es el entorno de pruebas ABDM?

Es el entorno de prueba donde se desarrollan y prueban las funcionalidades de ABHA, M2 y M3 antes de que NHA emita las credenciales de producción. Todas las organizaciones comienzan ahí, independientemente de su tamaño.

¿Qué versión de la API de ABHA debería usar en 2026?

Utilice las API V3. Los flujos V1 y V2 anteriores son obsoletos, y V3 requiere números Aadhaar cifrados con RSA y códigos OTP.

¿Es obligatoria la integración de ABHA para las aplicaciones de telemedicina?

No existe una regla general que exija que todas las aplicaciones de telemedicina integren ABHA. En la práctica, los hospitales y los programas gubernamentales esperan cada vez más software compatible con ABDM, por lo que esto influye en los pacientes a los que se puede atender.

¿Cuánto tiempo tarda la integración de ABHA?

M1 por sí solo se puede construir en semanas si su equipo conoce el entorno de pruebas. El camino completo a la producción también depende de las pruebas funcionales de NHA, la auditoría de seguridad y la demostración, así que planifique en meses, no en semanas. Los integradores publican estimaciones que van desde 8 a 12 semanas con un socio experimentado hasta 5 a 10 meses para una construcción desde cero (IGNEK). Considere esto como afirmaciones del proveedor, no como puntos de referencia.

¿Necesito también M2 y M3?

M1 cubre la propia ABHA. Para compartir registros de consultas se necesita M2, y para obtener registros de otros proveedores se necesita M3. La NHA ha solicitado al menos dos hitos antes de salir del entorno de pruebas.

¿Necesito un socio certificado para integrar ABHA?

No, cualquier organización registrada puede solicitar acceso al entorno de pruebas (sandbox). Un socio que haya trabajado en el entorno de pruebas le ahorrará tiempo principalmente en los detalles de la versión 3, las devoluciones de llamadas y la preparación de la auditoría.

¿Planea integrarse en ABHA?

Cuéntanos sobre tu aplicación, los hitos que necesitas alcanzar y la fecha de lanzamiento. Envíanos un correo electrónico a [email protected] , llámanos al +91 98462 37384 o envíanos tus requisitos , y te responderemos con una hoja de ruta del proyecto.

Fuentes

¿Le resultó útil este artículo?
Praveen Soman
Escrito por

Praveen Soman Director ejecutivo de Sigosoft

Emprendedor tecnológico y estratega de productos digitales, apasionado por desarrollar software escalable y resolver desafíos empresariales reales. Disfruta explorando la IA, las tecnologías emergentes, las startups y las ideas que dan forma al futuro de la tecnología.

Conecta en LinkedIn →
Discusión

Iniciar la discusión

¿Tienes preguntas o experiencias que quieras compartir? Nuestro equipo las lee y responde.

Este sitio utiliza Akismet para reducir el spam. Descubre cómo se procesan los datos de tus comentarios.

Gratis · Acuerdo de confidencialidad previo · Propiedad intelectual 100% suya

¿Ya has leído suficiente? ¡Vamos a construirlo!

Cuéntanos tu idea. Obtén una hoja de ruta con alcance, cronograma y costo en 2 horas.

WhatsApp