Copy page

Guías

Poner a una persona del equipo disponible o ausente desde tu sistema

Tu sistema cambia si una persona de tu equipo recibe casos nuevos. Sirve cuando los turnos viven en otro lado: al salir de turno la pones ausente y el reparto deja de asignarle casos, sin que ella apriete su botón.

Base de la API de Lelemon: https://api.lelemon.cl

La idea de fondo: es el mismo estado que cambia la persona en su pantalla. El reparto lo lee de ahí, así que se entera igual que si ella lo hubiera cambiado.

Antes de empezar

Dos alcances, separados a propósito. Se emiten en Integraciones API del dashboard.

Alcance	Qué deja hacer
miembros:read	Ver el estado de una persona.
miembros:write	Cambiarlo.

A la persona se la identifica por su email. Tiene que ser un miembro activo de tu organización.

Ver el estado

Code
GET https://api.lelemon.cl/v1/external/miembros/[email protected]
Authorization: Bearer <tu credencial>

Code
{
  "email": "[email protected]",
  "estado": "disponible",
  "disponibleParaRepartir": false,
  "cambiadoEl": "2026-10-21T21:30:00.000Z",
  "extendidoHasta": null
}

Campo	Qué es
estado	disponible o ausente: lo que quedó marcado, por la persona o por tu sistema.
disponibleParaRepartir	Si el reparto le asignaría un caso nuevo ahora mismo. Considera el horario de atención de tu organización.
cambiadoEl	La última vez que se cambió el estado. null si nunca.
extendidoHasta	Hasta cuándo pidió la persona seguir recibiendo casos pasado el horario. null si no hay.

Cambiarlo

Code
PUT https://api.lelemon.cl/v1/external/miembros/disponibilidad
Content-Type: application/json

{ "email": "[email protected]", "estado": "ausente" }

estado es disponible o ausente. La respuesta tiene la misma forma que el GET, con cómo quedó la persona.

• ausente saca a la persona del reparto y le quita la extensión de horario que haya pedido.
• Si la persona ya estaba en ese estado, no se escribe nada y su extensión de horario se conserva. Repetir el pedido es seguro: puedes correrlo en cada ciclo de tu flujo.
• No cambia el rol de la persona, ni si recibe casos en general, ni los embudos que ve. Sólo el estado.

Poner disponible fuera de horario

Si tu organización tiene horario de atención, el sistema marca como ausente, a la hora de repartir, a quien está disponible fuera de ese horario. Esa regla no se guarda en el estado: se evalúa cada vez que llega un caso.

Por eso, si tu flujo pone disponible a alguien fuera de horario:

• estado queda en disponible.
• disponibleParaRepartir queda en false, y el reparto la trata como ausente hasta que abra el horario.
• Sólo la propia persona puede pasar por encima del horario, pidiendo seguir un rato más desde su pantalla. Entonces extendidoHasta trae la hora y disponibleParaRepartir vale true hasta ahí.

Tu organización sin horario de atención configurado no tiene auto-away: disponible basta.

Errores

Código	Qué pasó
400	Falta el email o no es un email, o estado no es disponible ni ausente.
401	Falta la credencial o no sirve.
403	A la credencial le falta miembros:read (ver) o miembros:write (cambiar).
404	Ese email no es un miembro activo de tu organización. Es la misma respuesta si el email existe en otra organización.
429	Pasaste un techo por minuto, compartido por toda la API externa. Espera y reintenta.

Lo que esta ruta no hace

• No crea, invita ni saca miembros.
• No cambia el rol, ni si la persona recibe casos, ni los embudos que ve.
• No entrega el nombre ni los casos de la persona.