Apprendre

Comment fonctionne Zling

Zling est un service simple de notifications push. Lorsque vous ajoutez un appareil dans l'application, il enregistre votre token Expo Push. Vous recevez ensuite une URL de webhook que vous pouvez appeler de n'importe où — un script, une pipeline CI/CD, un système domotique, ou tout autre système capable d'envoyer des requêtes HTTP.

Lorsque le webhook est appelé, nous transmettons la notification au service de notification push Apple (APNs) qui la livre sur votre appareil.

Pourquoi des Expo Push Tokens ?

Expo fournit une API unifiée sur iOS et Android. Votre application reçoit un token unique, et nous gérons la livraison via APNs (iOS) ou FCM (Android). Vous n'avez pas besoin de gérer les certificats APNs ou les clés FCM.

Secrets des webhooks

Chaque webhook possède un secret qui autorise les requêtes. Le webhook "partagé" envoie à tous vos appareils. Les webhooks spécifiques à un appareil n'envoient qu'à un seul appareil.

Gardez vos secrets en sécurité. Toute personne ayant une URL de webhook peut envoyer des notifications sur votre appareil. Renouvelez les secrets dans l'application en cas de compromission.

Niveaux d'interruption

iOS 15+ prend en charge les niveaux d'interruption qui contrôlent le comportement des notifications :

• Passif — ajoute à la liste de notifications sans alerter
• Actif — comportement normal de notification
• Urgent (temps-sensitive) — traverse le mode Ne pas déranger et les paramètres Focus
• Critique — nécessite un droit spécial, joue même en mode silencieux

Alertes critiques

Les alertes critiques nécessitent un droit spécial d'Apple. Elles jouent même lorsque Ne pas déranger est activé ou que la sonnerie est coupée. Ne demandez ceci que pour les notifications véritablement urgentes (médicales, de sécurité, de sécurité).

Dépannage

Notifications non reçues ?

• Vérifiez que votre appareil est en ligne (pas en mode avion)
• Vérifiez que les notifications ne sont pas filtrées par un mode Focus
• Vérifiez si vous avez accidentellement supprimé l'application (les tokens sont invalidés)
• Assurez-vous que les notifications sont activées dans les paramètres iOS > Zling

Vous recevez "DeviceNotRegistered" ?

Le token de l'appareil n'est plus valide. Rouvrez l'application pour le ré-enregistrer, ou supprimez l'appareil de l'application.

Exemples d'intégration

Zling fonctionne avec tout ce qui peut envoyer des requêtes HTTP :

GitHub Actions

- name: Notify on failure
  if: failure()
  run: |
    curl -X POST https://<votre-projet>.convex.site/v1/br_usr_votre_secret \
      -d 'Deployment failed 💥'

Home Assistant

service: rest_command.zling_notification
data:
  payload: '{"title":"Motion detected","message":"Someone is at the door"}'

IFTTT

Utilisez l'applet Webhook avec l'URL https://<votre-projet>.convex.site/v1/br_usr_votre_secret et la méthode POST.