Aller au contenu

Configurer les SMS

Newapp peut envoyer des SMS aux agents ou aux usagers via un fournisseur de messagerie externe. La configuration s'effectue via des paramètres dédiés dans l'espace de travail.

Attention

Les identifiants et mots de passe des fournisseurs doivent être chiffrés avant d'être saisis dans les paramètres de l'espace de travail. Rapprochez-vous de votre équipe technique ou de l'équipe Newapp pour le chiffrement.

Paramètre SMS_SENDER

Définit le nom de l'expéditeur affiché sur le téléphone du destinataire.

  • Maximum : 11 caractères
  • Ce nom doit être déclaré et autorisé auprès du fournisseur SMS (obligatoire depuis septembre 2024)

Paramètre SMS_PROVIDER

Désigne le fournisseur SMS retenu pour l'espace de travail. Deux valeurs sont acceptées :

Valeur Fournisseur
smsenvoi smsenvoi (ICM)
ovh API SMS d'OVHcloud

Les paramètres à renseigner ensuite dépendent de cette valeur.

Fournisseurs supportés

smsenvoi

Paramètre Valeur Description
SMS_PROVIDER smsenvoi Sélectionne le fournisseur smsenvoi
SMS_LOGIN chaîne Adresse email du compte smsenvoi
SMS_PASS chaîne chiffrée Mot de passe du compte, chiffré avant saisie
SMS_URL chaîne https://sms.icm-data.com/API/v1.0/REST/

OVH

L'espace de travail se connecte à l'API SMS d'OVHcloud à l'aide d'un jeu de clés (clé d'application, secret, consumer key) généré une seule fois depuis le portail OVH.

Paramètre Valeur Description
SMS_PROVIDER ovh Sélectionne le fournisseur OVH
SMS_ACCOUNT sms-ab12345-1 Identifiant du service SMS OVH, visible dans l'espace client OVH sous Télécom > SMS
SMS_APP_KEY chaîne Clé d'application générée à l'étape ci-dessous
SMS_APP_SECRET chaîne chiffrée Secret d'application généré à l'étape ci-dessous, chiffré avant saisie
SMS_CONSUMER_KEY chaîne Consumer key générée à l'étape ci-dessous

Générer les clés API OVH

  1. Connectez-vous au portail OVH avec l'identifiant (nic-handle) qui gère le service SMS.

  2. Ouvrez la page de création de jeton OVH, pré-remplie avec les droits attendus par Newapp :

    https://www.ovh.com/auth/api/createToken?GET=/sms/&GET=/sms/*&GET=/sms/*/jobs&POST=/sms/*/jobs

  3. Renseignez :

    • Account ID : votre identifiant OVH
    • Password : votre mot de passe OVH
    • Script name : un libellé libre, par exemple Newapp SMS
    • Validity : Unlimited, pour éviter d'avoir à régénérer les clés à expiration

  4. Vérifiez que les droits proposés sont bien les quatre suivants :

    Méthode Chemin
    GET /sms/
    GET /sms/*
    GET /sms/*/jobs
    POST /sms/*/jobs

  5. Validez. OVH affiche alors trois valeurs : Application Key, Application Secret et Consumer Key.

  6. Reportez ces valeurs dans les paramètres de l'espace de travail : SMS_APP_KEY, SMS_APP_SECRET (chiffré au préalable) et SMS_CONSUMER_KEY.

Pour la liste complète des paramètres disponibles et leur syntaxe, consultez la Référence des paramètres.