órbita.
API pública

Tus números de Órbita, en tus propios sistemas.

Con un token, cualquier sistema de la clínica lee sus datos de Órbita Chat. Es sólo de lectura, cada token ve únicamente lo que le habilitaste y nunca entrega el texto de los mensajes.

Ver la documentación ↗Volver a Órbita Gestión

Cómo funciona

01Creás un tokenEn Configuración › API › «Nuevo token». Le ponés un nombre, eliges qué puede leer, de qué líneas y hasta cuándo vale. Se muestra una sola vez.
02Tu sistema lo usaCada pedido lleva el token en el encabezado: «Authorization: Bearer oapi_…». Todo es GET y vuelve en JSON.
03Lee tus númerosChats, campañas, turnos agendados, tipificaciones y envíos de plantillas, para cruzarlos con tu tablero, tu planilla o tu sistema de gestión.

Qué se puede leer

Cada dato se habilita por separado. Si el token no tiene el permiso, esa consulta responde que no puede.

LíneasGET /v1/lineas
Las líneas de WhatsApp de la clínica. Cualquier token las ve.
Chats recibidosGET /v1/chats
Cada chat del período: cuándo escribió el paciente por primera vez, quién inició la conversación y de qué campaña vino.
CampañasGET /v1/campanas
Las campañas y sus anuncios, de Meta, Google, TikTok, la web u otros orígenes.
AgendadosGET /v1/agendados
Los turnos que salieron del chat: los que dio el asistente y los que dio una persona del equipo.
TipificacionesGET /v1/sesiones
Cómo terminó cada conversación, según la clasificación de la IA o la corrección del equipo.
Envíos de plantillasGET /v1/envios
Por plantilla, día y línea: enviados, entregados, leídos, respondidos y fallidos.

Un pedido, de ejemplo

curl "https://api.hiorbita.com/v1/envios\
?desde=2026-10-01T00:00:00-03:00\
&hasta=2026-10-08T00:00:00-03:00" \
  -H "Authorization: Bearer oapi_TU_TOKEN"
{
  "envios": [
    {
      "plantilla": "recordatorio_turno",
      "dia": "2026-10-02",
      "enviados": 48, "entregados": 47,
      "leidos": 39, "respondidos": 31,
      "fallidos": 1
    }
  ]
}
Ejemplo ilustrativo: los números no son de una clínica real.

Lo que nunca sale

El texto de los mensajes: la API entrega números y fechas, no conversaciones.
Los teléfonos de los pacientes, salvo que el token tenga ese permiso. Vienen apagados.
Los identificadores propios de Meta: sólo los de Órbita para campañas y anuncios.
Las líneas que el token no tiene habilitadas.

Límites

60
pedidos por minuto
4
pedidos a la vez
10.000
pedidos por día
31 días
por consulta
500
filas por página

Para un tablero alcanza con consultar cada 5 a 15 minutos.

Todo el detalle, en la documentación.

Abrir api.hiorbita.com/docs ↗