Déclenchez automatiquement une URL, un protocole ou une commande sur votre poste à chaque événement d'appel, par exemple pour afficher la fiche de l'appelant dans votre CRM dès la sonnerie.
Cette rubrique est destinée aux intégrateurs et aux administrateurs. Dans la plupart des entreprises, elle est configurée pour vous : si personne ne vous a demandé d'y intervenir, vous n'avez rien à y régler et pouvez laisser l'interrupteur désactivé. Elle est disponible sur l'application de bureau (Windows, macOS et Linux).
Étapes
- Ouvrez Paramètres dans la barre latérale, puis cliquez sur Action des événements d'appel externes.
- Activez l'interrupteur Activer l'action sur les événements d'appel externes.
- Choisissez le Mode d'action : URL / Protocole appelle une URL, ouvre un lien de protocole ou envoie une requête API ; Commande exécute un programme ou un script local avec des arguments. En mode Commande, activez aussi l'interrupteur Autoriser l'exécution de commandes, qui apparaît sous le sélecteur.
- Pour une URL, choisissez l'Exécution de l'URL : Ouvrir en externe lance le gestionnaire d'URL ou de protocole ; Appel API en arrière-plan envoie la requête HTTP/HTTPS sans ouvrir de fenêtre.
- Renseignez la Cible de l'action : l'URL, le protocole ou la commande à exécuter.
- Pour une URL, choisissez la Transmission des paramètres URL : Paramètres GET ajoute les valeurs à l'URL ; POST JSON payload les envoie dans le corps de la requête et nécessite l'appel API en arrière-plan.
- Cochez les Événements pris en charge qui déclenchent l'action.
- Cochez les Paramètres à transmettre.
- Cliquez sur Tester l'action, puis sur Sauvegarder.
Événements et paramètres disponibles
Par défaut, tous les événements et tous les paramètres sont cochés.
Les événements pris en charge : Sonnerie d'appel entrant (INCOMING_CALL_RINGING), Début d'appel sortant (OUTGOING_CALL_START), Répondre à l'appel (CALL_ANSWER), Mise en attente de l'appel (CALL_HOLD), Reprise de l'appel (CALL_UNHOLD) et Fin d'appel (CALL_HANGUP).
Les paramètres transmis : call_event (constante d'événement d'appel), call_id (SIP Call-ID), caller_name (nom affiché de l'appelant, quand il est disponible), caller_number (numéro de l'appelant), callee_number (numéro ou extension de destination) et call_status (statut dérivé de l'événement : RINGING pendant la sonnerie, ANSWERED après la réponse, ENDED en fin d'appel, par exemple).
Exemples
-
Fiche CRM à la réponse (URL / Protocole, Ouvrir en externe, Paramètres GET) : avec la cible
https://crm.example.com/screen-pop, l'application ouvre à la réponsehttps://crm.example.com/screen-pop?call_event=CALL_ANSWER&caller_number=15551234567&caller_name=Jane+Smith. -
Envoi vers un outil d'analyse (URL / Protocole, Appel API en arrière-plan, POST JSON payload) : avec la cible
https://analytics.company.com/events, l'application envoie en fin d'appel{"call_event":"CALL_HANGUP","call_id":"abc123","call_status":"ENDED"}. -
Script local (Commande) : avec la cible
notify_agent.exe call_event caller_number call_id, l'application exécute à la réponsenotify_agent.exe CALL_ANSWER +15551234567 abc123. -
Application de bureau via protocole (URL / Protocole, Ouvrir en externe) : avec la cible
crmapp://popup, l'application ouvrecrmapp://popup?caller_number=15551234567&caller_name=Jane+Smith.
Sécurité et journalisation
Dans le bloc Sécurité et logging :
- La Durée de déduplication (TTL) (ms) évite les déclenchements multiples pour un même événement pendant le délai indiqué (300000 ms par défaut). Un délai trop long peut ignorer des événements répétés légitimes, comme des mises en attente et reprises rapprochées.
- Décochez Journaliser l'URL, le payload ou la commande exactes si vos URL, payloads ou arguments de commande peuvent contenir des données sensibles : les journaux affichent alors
detailsOmittedà la place.
Recommandations :
- Ne transmettez que les paramètres dont votre système cible a réellement besoin.
- Pour les appels API en arrière-plan, utilisez toujours des URL HTTPS et, si votre service le permet, un jeton d'authentification.
- N'utilisez le mode Commande qu'avec des exécutables de confiance et testés : une commande malveillante peut compromettre votre poste.
Bon à savoir
- Tester l'action utilise des données d'appel d'exemple générées par l'application : aucun appel réel n'est nécessaire pour valider votre configuration.
- Les actions s'exécutent en arrière-plan et ne ralentissent jamais vos appels, même si le service externe est lent ou indisponible. En mode API, l'application s'isole des pannes du service externe : délai d'attente de 5 secondes, 3 requêtes simultanées au maximum, coupure temporaire après 3 échecs consécutifs avec reprise au bout de 60 secondes.
- En mode Commande, si seul l'exécutable est renseigné, les paramètres sélectionnés sont ajoutés automatiquement ; sinon, les constantes sont remplacées par les valeurs réelles de l'appel.
- Le bouton Réinitialiser rétablit les réglages de la rubrique.