Skip to main content
Push es el toque en el hombro del usuario: lo devuelve a su sitio o aplicación sin SMS ni correo electrónico, ideal para usuarios que ya aceptaron notificaciones.

​
¿Qué es Push on Notifique?

Es el canal para alertar en el navegador o la aplicación para los usuarios que otorgaron permiso. Organiza Push App, dispositivos y envíos en el mismo espacio de trabajo; su integración almacena ID de dispositivo (y puede vincularlos a un contacto CRM) y los envía cuando es necesario. Puede:
  • Crear aplicaciones push con VAPID Web (automático), FCM (Android) y APNs (iOS)
  • Registrar dispositivos en web (script) o mobile (token FCM/APNs), con contactId opcional
  • Enviar a device IDs o toContacts (todos los dispositivos del contacto)
  • Rich Web Push: image, badge, tag, actions, requireInteraction, etc.
  • Programar y cancelar envíos futuros
  • Seguimiento de entrega y clics vía API o webhook
  • BYOK: Firebase/APNs en Integraciones (como Resend/SES en email)
Piense en un recordatorio en la pantalla del teléfono: breve, directo, para personas que ya dijeron “sí” a las notificaciones.
A diferencia de WhatsApp, push no utiliza una instancia de canal. Solo necesita una aplicación Push, dispositivos registrados y una clave API con los alcances adecuados.
El sonido personalizado funciona en mobile (APNs/FCM). En navegadores modernos, el sonido custom en Web Push es limitado o no está disponible.

​
¿Cuándo usarlo?

Funciona muy bien para carrito abandonado, actualizaciones rápidas y traer de vuelta a los usuarios. Si nunca abrieron el sitio o le negaron el permiso, utilice email o SMS. Contenido HTML largo → correo electrónico.

​
Cómo funciona en la práctica

  1. Cree una aplicación Push, Web VAPID se genera automáticamente (o configure sus propias claves más adelante)
  2. Registrar dispositivos cuando el navegador entregue la suscripción a su backend, guarde el ID del dispositivo
  3. Enviar con to (conjunto de ID de dispositivos), título y/o cuerpo
  4. La plataforma pone en cola, envía y actualiza el estado; su backend recibe alertas si configuró webhooks
Each API Key belongs to one workspace. On v1 do not send x-workspace-id.

​
Enviar ciclo de vida

Después de POST, la notificación pasa por QUEUED o SCHEDULED, luego SENT, DELIVERED o CLICKED según informa el dispositivo. Los fracasos se convierten en FAILED; los horarios cancelados se convierten en CANCELLED. La entrega y los clics pueden ser informados por el trabajador de servicio del cliente. Los webhooks notifican a su backend (push.delivered, push.clicked).

​
Qué puedes hacer

  • Enviar de 1 a 100 ID de dispositivo por llamada (1 crédito por notificación)
  • Horario con schedule.sendAt
  • Historial de consultas o un envío por identificación
  • Cancelar envíos programados mientras el estado sea SCHEDULED
  • Idempotencia con encabezado Idempotency-Key
  • Prioridad en options.priority: high, normal, low
  • Restringir por aplicación con pushAppIds en la tecla, fuera de la lista → 403 (PUSH_APP_NOT_ALLOWED)
Detalles de campo y error: Referencia de API en la pestaña Push (barra lateral).

​
Después de tu primer envío

  • Seguimiento vía webhooks (push.sent, push.delivered, push.clicked, push.failed)
  • Elimina dispositivos con suscripciones no válidas cuando recibas push.failed
  • Prueba en Sandbox con sk_test_... antes de la producción

​
Próximos pasos