SMS pour GLPI : le plugin 123-SMS

1Ce que fait le plugin

Un ascenseur bloqué, un serveur qui tombe, un ticket « très haute » ouvert à 3 h du matin : le technicien d'astreinte doit le savoir tout de suite. GLPI sait déjà tout ; il lui manquait le canal qui réveille. Le plugin sms123, développé par 123-SMS sous licence MIT, branche GLPI sur l'API SMS :

Chaque envoi est historisé : date, numéro, message, origine, ticket lié, code retour de l'API et son explication en clair.

<?php
/**
 * 123-SMS pour GLPI — alertes d'astreinte et notifications par SMS.
 * Licence MIT : réutilisation libre. Compatible GLPI 10.0 et 11.0.
 */
function plugin_init_sms123()
{
    global $PLUGIN_HOOKS;

    $PLUGIN_HOOKS['csrf_compliant']['sms123'] = true;
    $PLUGIN_HOOKS['config_page']['sms123']    = 'front/config.form.php';

    // Un ticket est créé : on prévient l'astreinte si l'urgence le justifie.
    $PLUGIN_HOOKS['item_add']['sms123']    = array('Ticket' => 'plugin_sms123_ticket_add');
    // Un ticket passe en résolu : on informe le demandeur.
    $PLUGIN_HOOKS['item_update']['sms123'] = array('Ticket' => 'plugin_sms123_ticket_update');
}

/** Appel de l'API ; le code retour est historisé (80 = envoyé). */
$resultat = PluginSms123Api::envoyer($numero, $message, $tickets_id, 'creation');

2Installation en 5 minutes

• Décompressez l'archive dans le dossier plugins/ de GLPI — vous devez obtenir plugins/sms123/setup.php ;
• Configuration › Plugins : installez puis activez « 123-SMS » ;
• Ouvrez la configuration (la roue dentée) et renseignez l'identifiant et la clé API (transmis par e-mail à l'inscription, espace client › API) ;
• Cliquez sur Tester la connexion : le solde du compte s'affiche ;
• Cochez Activer les alertes, saisissez les numéros d'astreinte et le seuil d'urgence, puis créez un ticket de test.

3Personnaliser les messages

Les deux modèles acceptent des variables remplacées à l'envoi : {id} {titre} {urgence} {demandeur} {entite} {categorie}.

Par exemple Ticket #{id} ({urgence}) : {titre} - {demandeur} devient « Ticket #4218 (tres haute) : Ascenseur bloque batiment B - Mairie du Havre ». Le message est tronqué à 160 caractères, la longueur d'un SMS standard.

4Vérifier qu'un SMS est bien parti

Pas besoin d'attendre : la page de configuration et la page d'envoi affichent l'historique avec le code retour de l'API. 80 = message parti. Les échecs sont aussi tracés dans le journal GLPI sms123.

5Télécharger

123-sms_glpi.zip — plugin GLPI 10 et 11

Licence MIT, code source sur GitHub. Aucune dépendance : le plugin appelle directement l'API HTTPS.