Nueve canales, y una rejilla.

Dos sistemas distintos comparten la palabra «notificación», y confundirlos cuesta una tarde. Los canales son lo que dispara un monitor o una automatización. Las preferencias son lo que la plataforma te cuenta. Esta página los separa.

reparto ▸ dos sistemas

¿De cuál hablas?

Los dos viven en Ajustes, los dos dicen «notificaciones», y no comparten lista de canales. Empieza aquí:

canales ▸ nueve

Configura un canal.

Configura cada uno una vez para la organización y añádele destinatarios. Cada canal tiene un envío de prueba.

destinatarios ▸ channel:id

Nombrar a quién avisar.

Cuando un canal ya tiene destinatarios, una automatización se refiere a ellos con cadenas "channel:id" — por ejemplo ["pushover:1","email:3"]. Una sola llamada lista todos los destinatarios de todos los canales, cada uno con su identificador enmascarado, que es lo que pinta un selector.

{
  "channels": ["pushover", "email"],
  "recipients": ["pushover:1", "email:3"]
}

curl https://api.usewrit.app/api/notifications/recipients/all \
  -H "Authorization: Bearer $WRIT_API_KEY"

controles ▸ toda la organización

Controles de entrega.

Se aplican a toda la organización, no por canal — para que una noche movida no acabe en cien mensajes:

placeholders ▸ alertas de cambio

Qué puedes poner en el mensaje.

Las notificaciones de cambio insertan estos placeholders en tu plantilla de mensaje. Agrupados por lo que responden:

relé ▸ desde un dispositivo

Un dispositivo vinculado pasando el testigo a la nube.

Un dispositivo ejecuta automatizaciones en local, pero algunos canales necesitan la nube para entregar. Solo email, pushover, SMS, WhatsApp y Signal pasan por el relé; webhook, Slack, Discord y Telegram los entrega el propio dispositivo, porque puede alcanzarlos directamente.

curl -X POST https://api.usewrit.app/api/notifications/relay \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channels": ["email", "pushover"],
    "recipients": ["email:3", "pushover:1"],
    "title": "Price dropped",
    "message": "Now $41.00, was $49.00.",
    "url": "https://example.com/product/42"
  }'

preferencias ▸ la otra rejilla

Preferencias de notificación de la plataforma.

Este es el segundo sistema: lo que Writ te cuenta, por usuario, en GET y PUT /api/notifications/preferences. Otro conjunto de canales, otro propósito.

Seis canales

No son los mismos nueve de arriba:

Siete categorías

Los eventos se agrupan para poder razonar sin leer fila por fila:

Cuatro reglas que sorprenden

1. La rejilla es dispersa. Solo se muestran los canales que un evento ofrece de verdad — una celda vacía no es un interruptor que te falte.
2. Algunas celdas están bloqueadas y siempre activas: alertas de seguridad, problemas de pago e invitaciones de equipo. La API no guarda una anulación para ellas.
3. Algunos eventos son solo por email, a propósito.
4. Las alertas de cambio por monitor viven deliberadamente fuera de esta rejilla, con sus propios ajustes por destino.

referencia ▸ siguiente

Sigue

faq

Preguntas de notificaciones, respondidas.

fin ▸ conectar

Mándate una prueba.

Configura un canal, añade un destinatario y dispara el envío de prueba antes de necesitarlo.