# Noti

> Noti manda notificaciones push al teléfono de la gente. La app sólo recibe: una empresa
> difunde a quienes se suscribieron o le avisa a UNA persona por un `ref` que ella misma
> vinculó. Quien recibe puede silenciar o cortar a cualquiera sin que la empresa se entere:
> por eso `POST /send` contesta siempre 202 (que NO significa «entregado») y Noti no informa
> bajas ni cuántos suscriptos activos hay. Un agente de IA que integre Noti tiene que respetarlo.

## Para integrar Noti en un sistema

- [Guía para tu agente de IA (texto plano)](https://noti-api-production.up.railway.app/empresas/integrar.md): qué construir, qué no, variables de entorno, idempotencia y checklist de verificación.
- [La misma guía en la web, con botón de copiar](https://noti-api-production.up.railway.app/empresas/integrar)
- [Cliente de Python](https://noti-api-production.up.railway.app/sdk/noti.py): un archivo, sin dependencias.
- [Cliente de Node/TypeScript](https://noti-api-production.up.railway.app/sdk/noti.ts): un archivo, sin dependencias.

## Referencia

- [Guía para humanos, con ejemplos en curl, Node y Python](https://noti-api-production.up.railway.app/empresas)
- [API para empresas en OpenAPI](https://noti-api-production.up.railway.app/empresas/openapi.json)
- [MCP de Noti (Streamable HTTP, Bearer ntf_…)](https://noti-api-production.up.railway.app/mcp): enviar_aviso, vincular_persona, crear_qr, listar_avisos, ver_aviso…

## Reglas que no se negocian

- Un 202 de `POST /send` no es «entregado»: no existe estado «conectado», «recibido» ni «dado de baja».
- De un aviso sólo se sabe lo POSITIVO: a una persona, la fecha en que lo abrió; a muchos, cuántos lo abrieron, y sólo si son 30 o más.
- Nunca pongas teléfonos, direcciones, montos ni nombres completos en un aviso: se lee en la pantalla bloqueada.
- Un fallo de Noti no puede romper tu operación: avisar es mejor esfuerzo.