Brújula para desarrolladores

Para quien arma sus propias automatizaciones: creá tareas, anotá gastos o hablale al asistente desde Atajos del iPhone, Zapier, Make, n8n o tu propio código, con una llave de acceso que creás vos y podés revocar cuando quieras.

1. Creá tu llave

Cada herramienta lleva su propia llave. Así, si dejás de usar una, la revocás y el resto sigue andando.

Entrá a Brújula y andá a Ajustes → Desarrolladores.
Escribí para qué es (por ejemplo, "Atajos del iPhone"), elegí el permiso y tocá Crear llave. "Solo lectura" sirve para consultar; para crear tareas o hablar con el asistente hace falta "Lectura y escritura".
Copiala en ese momento: empieza con brj_ y, por seguridad, no se vuelve a mostrar. Si la perdés, creá otra y revocá la vieja.

Tratala como una contraseña: quien la tenga puede ver y cambiar tu agenda. Brújula guarda solo una huella de la llave, no la llave.

2. Con Siri: Atajos del iPhone

Decís "Oye Siri, Brújula", le hablás como por WhatsApp y te responde. Se arma una sola vez, en unos cinco minutos.

Abrí la app Atajos, tocá + y ponele de nombre Brújula. Ese nombre es lo que le vas a decir a Siri.
Agregá la acción Dictar texto.
Agregá Obtener contenido de URL con la dirección https://brujula.day/api/v1/mensaje. Tocá la flecha para ver más opciones:
Método: POST.
Encabezados: agregá uno con clave Authorization y valor Bearer, un espacio y tu llave.
Cuerpo de la solicitud: JSON, con un campo de texto llamado texto cuyo valor sea Texto dictado.
Agregá Obtener valor del diccionario y pedí la clave respuesta.
Terminá con Leer texto para que te conteste en voz alta, o con Mostrar resultado si lo preferís en pantalla.

Probá: "Oye Siri, Brújula" y después "mañana a las 10, dentista", o "¿qué tengo hoy?". Si el asistente necesita elegir entre opciones, te las nombra y le contestás con otro "Oye Siri, Brújula".

3. Zapier, Make y n8n

Las tres tienen un paso de pedido web que habla con Brújula. Se configura igual en todas:

Herramienta	Paso a usar
Zapier	Webhooks by Zapier → Custom Request
Make	Módulo HTTP → Make a request
n8n	Nodo HTTP Request

En ese paso: método POST, la dirección de la acción que quieras (abajo están todas), el encabezado Authorization: Bearer brj_… y el cuerpo en JSON.

Ideas para empezar

Cuando alguien completa un formulario, crear una tarea para revisarlo (POST /tareas).
Cuando llega el aviso de compra de tu banco al correo, anotar el gasto (POST /gastos).
Cuando se cierra una venta en tu sistema, mandarle al asistente "llamar a Ana el jueves para coordinar la entrega" (POST /mensaje).
Cada mañana, traer las tareas del día a una planilla (GET /tareas).

4. Referencia de la API

Para quien programa, o para configurar cualquier herramienta que haga pedidos web.

Qué	Cómo
Dirección base	`https://brujula.day/api/v1`
Autenticación	Encabezado `Authorization: Bearer brj_…`
Formato	JSON en el cuerpo y en la respuesta. Los errores vienen como `{"error": "…"}`, con su código HTTP.
Fechas y horas	`AAAA-MM-DD` y `HH:MM` (24 h), en hora de Uruguay.
Límite	120 pedidos por minuto por llave. El asistente tiene además un tope diario de mensajes.
Privacidad	La API no devuelve eventos de Google Calendar, y el asistente no los usa al responder por acá.

GET/yo

Tu cuenta y lo que necesitás para armar pedidos: roles, espacios compartidos, funciones activas, categorías de gasto y monedas.

curl https://brujula.day/api/v1/yo \
  -H "Authorization: Bearer brj_…"

POST/mensaje

Hablarle al asistente como por WhatsApp. Entiende lenguaje natural: agenda, consulta, marca como hecho y anota gastos. Devuelve respuesta (texto) y opciones (si te pregunta algo con respuestas cortas, mandá la elegida en el próximo mensaje).

curl https://brujula.day/api/v1/mensaje \
  -H "Authorization: Bearer brj_…" \
  -H "Content-Type: application/json" \
  -d '{"texto": "mañana a las 10, dentista"}'

{"respuesta": "Listo: dentista, mañana a las 10:00.", "opciones": []}

GET/tareas

Tareas entre desde y hasta (por defecto, los próximos 7 días; hasta 93 días). estado: pendiente (por defecto), hecha o todas. Con sin_fecha=1 se suman las que no tienen día.

curl "https://brujula.day/api/v1/tareas?desde=2026-10-12&hasta=2026-10-18" \
  -H "Authorization: Bearer brj_…"

POST/tareas

Crea una tarea. Solo titulo es obligatorio.

Campo	Qué es
titulo	Qué hay que hacer.
fecha, hora	Cuándo. Sin fecha queda en "Sin fecha".
duracion	Minutos.
notas	Detalle libre.
rol	Nombre de una parte de tu vida ("Trabajo"), o `rol_id`.
aviso	Minutos antes para avisarte por WhatsApp.
espacio_id	Para crearla en un espacio compartido.
en_google_calendar	`true` o `false`. Si no lo mandás, se publica cuando tiene fecha y tenés Google Calendar conectado.

curl https://brujula.day/api/v1/tareas \
  -H "Authorization: Bearer brj_…" \
  -H "Content-Type: application/json" \
  -d '{"titulo": "Revisar el formulario de Ana", "fecha": "2026-10-14", "hora": "09:30", "rol": "Trabajo"}'

GET/tareas/{id} PATCH DELETE

Ver, cambiar o borrar una tarea. Con PATCH mandá solo lo que cambia, por ejemplo {"estado": "hecha"} o {"fecha": "2026-10-15"}.

GET/gastos POST

Con la función Finanzas activa. GET devuelve los gastos de un mes (mes=AAAA-MM, por defecto el actual). POST anota uno: descripcion y monto son obligatorios; además moneda (UYU o USD), categoria, fecha, notas y espacio_id.

curl https://brujula.day/api/v1/gastos \
  -H "Authorization: Bearer brj_…" \
  -H "Content-Type: application/json" \
  -d '{"descripcion": "Supermercado", "monto": 1250.50, "categoria": "Súper"}'

POST/ingresos

Anota un ingreso (prende Ingresos si estaba apagado): descripcion y monto son obligatorios; moneda, fecha y categoria (Sueldo, Honorarios, Ventas, Turnos, Alquileres, Reintegros, Regalos, Otros) son opcionales.

POST/listas/items

Agrega cosas a una lista de un espacio: items (lista de textos, o texto separado por comas), lista (nombre o parte; sin él, la última abierta) y espacio_id (sin él, tu único espacio).

GET/tareas/nuevas · /tareas/hechas · /gastos/nuevos · /ingresos/nuevos · /turnos/nuevos

Lo último que pasó, del más nuevo al más viejo (hasta limite=100, por defecto 50): para herramientas que preguntan cada pocos minutos, como Zapier o Make. /tareas?q=palabras busca tareas por texto.