Skip to main content

​
À quoi ça sert

L’intégration Pushover permet à vos agents d’envoyer une notification push sur votre compte, pendant l’appel. Par exemple : prévenir l’équipe qu’un client demande un rappel, ou alerter un responsable qu’une demande urgente vient d’être prise. Comme pour les autres intégrations, vous branchez votre propre compte : Bookivox ne fournit aucun identifiant. Vous créez une application dans Pushover pour obtenir son jeton, puis vous copiez votre clé de destinataire.
Le destinataire est figé dans la connexion : une fois la clé enregistrée, l’agent ne peut pas notifier un autre compte. Seul le texte de la notification varie d’un appel à l’autre.

​
Ce qu’il faut préparer

Le jeton d’application identifie qui envoie, la clé du destinataire identifie qui reçoit. Les deux sont nécessaires : Pushover n’accepte jamais une notification sans l’un des deux.

​
Connecter Pushover

1

Créer l'application

Dans Pushover, ouvrez Your Applications et créez une application dédiée à Bookivox. Copiez son jeton.
2

Copier la clé du destinataire

Sur la page d’accueil de Pushover, copiez votre clé utilisateur. Pour notifier un groupe, utilisez la clé du groupe.
3

Saisir les deux valeurs

Dans Intégrations → Pushover, collez le jeton et la clé. Le formulaire vérifie qu’il s’agit bien de 30 caractères alphanumériques.
4

Cocher l'action

Sélectionnez Envoyer une notification. Elle devient un outil indépendant.
5

Vérifier la connexion

Cliquez sur Créer les outils. Bookivox valide le jeton et la clé avec POST /1/users/validate.json, sans envoyer de notification : un bandeau vert confirme la création, une erreur est affichée sinon.
6

Attacher l'outil

Rattachez l’outil à un nœud agent. Il s’exécute pendant l’appel.

​
Ce que l’agent peut faire

L’agent fournit message, et s’il le souhaite title et priority. Le jeton et la clé du destinataire ne sont jamais des paramètres : ils sont injectés par la credential.
La priorité va de -2 (silencieuse) à 1 (haute). La priorité d’urgence 2 exige des champs supplémentaires (retry, expire) et n’est pas exposée : elle ne peut pas être déclenchée par l’agent.

​
Cas d’usage

​
Comment ça marche

  1. Bookivox crée une credential custom_header qui ne contient aucun en-tête, seulement deux champs de corps : token et user.
  2. À chaque appel, ces deux champs écrasent les arguments produits par le modèle : l’agent ne peut pas viser un autre compte.
  3. La requête part vers l’URL fixe https://api.pushover.net/1/messages.json en POST, en JSON, avec un timeout de 10 000 ms.
  4. Un outil http_api est créé avec config.provider = "pushover" et config.operation = "send_notification".
  5. Pushover renvoie un statut et un identifiant de requête que l’outil restitue à l’agent.

​
Rédiger la description de l’outil

La description décide quand l’agent envoie la notification. Rédigez-la comme une consigne :
Une notification est irréversible et arrive immédiatement sur l’appareil du destinataire. Précisez dans le prompt que l’agent doit confirmer à voix haute avant d’envoyer.

​
Sécurité

Créez une application dédiée à Bookivox et supprimez-la en cas de doute depuis Pushover. Une application partagée avec un autre usage ne peut pas être supprimée sans interrompre cet autre usage.

​
Ce qui est déconseillé

​
Limites et dépannage

Intégrations

Toutes les intégrations et les catégories d’outils.

API HTTP

Comprendre les outils HTTP : paramètres, presets, credentials.
Last modified on November 3, 2026