02 51 76 0 34

Accès client :  mot de passe oublié   inscription

       (oubli)
AccueilDéveloppeurs / API › Domoticz

Envoyer des SMS avec Domoticz

Mis à jour le 17 septembre 2026

Détecteur de fuite, ouverture de porte, congélateur trop chaud : Domoticz sait réagir, encore faut-il être prévenu quand le téléphone n'a pas l'application ouverte. Sans clé GSM ni carte SIM, deux méthodes envoient un SMS via l'API 123-SMS : la notification « Custom HTTP/Action » de Domoticz, sans une ligne de code, ou un script dzVents pour des messages sur mesure.

1Méthode 1 : la notification Custom HTTP/Action

  1. Configuration › Paramètres › Notifications, section Custom HTTP/Action : cochez Activé.
  2. FIELD1 : votre identifiant ; FIELD2 : votre clé API ; TO : votre numéro (33601020304).
  3. URL/Action : collez l'adresse ci-dessous (méthode GET).
  4. Bouton Test, puis Appliquer les paramètres.
https://www.123-sms.net/http.php?email=#FIELD1&pass=#FIELD2&numero=#TO&message=#MESSAGE

Sur chaque dispositif à surveiller, bouton Notifications : choisissez le déclencheur (activé, supérieur à…), écrivez le message personnalisé et cochez le système Custom HTTP/Action.

Vérifiez le premier SMS : selon la version de Domoticz, les accents ou certains caractères du message peuvent être mal transmis dans l'URL. En cas de souci, préférez un texte sans accents ou la méthode dzVents, qui encode le message explicitement.
Identifiant et clé API : ils sont transmis par e-mail à l'inscription ; la clé se régénère dans l'espace client, rubrique API. Pour valider la configuration sans consommer de crédit, utilisez l'envoi à blanc : l'API répond 92 sans envoyer de SMS.

2Méthode 2 : un script dzVents

Configuration › Plus d'options › Événements+dzVentsMinimal, puis collez :

local IDENTIFIANT = 'votre_identifiant'
local CLE_API = 'XXXXXX'
local NUMEROS = { '33601020304' }

return {
    on = { devices = { 'Detecteur fuite garage' } },
    execute = function(domoticz, device)
        if device.state ~= 'On' and device.state ~= 'Alarm' then return end
        local message = 'ALERTE ' .. device.name .. ' (' .. os.date('%H:%M') .. ')'
        for _, numero in ipairs(NUMEROS) do
            domoticz.openURL({
                url = 'https://www.123-sms.net/http.php',
                method = 'POST',
                headers = { ['Content-Type'] = 'application/x-www-form-urlencoded' },
                postData = 'email=' .. domoticz.utils.urlEncode(IDENTIFIANT)
                    .. '&pass=' .. domoticz.utils.urlEncode(CLE_API)
                    .. '&numero=' .. domoticz.utils.urlEncode(numero)
                    .. '&message=' .. domoticz.utils.urlEncode(message)
            })
        end
    end
}

Remplacez le nom du dispositif et l'état attendu (On, Open, Alarm…) selon votre matériel. L'heure ajoutée au message évite que l'API refuse une alerte identique répétée dans la journée (code 91).

Numéros : 33601020304 ou 0601020304 pour la France ; pour l'étranger, l'indicatif précédé de 00 ou de + (converti en 00).

3Et la fin de la 2G ?

Beaucoup d'installations Domoticz envoyaient leurs SMS par une clé 3G ou un modem GSM. Avec l'extinction de la 2G en 2026 puis de la 3G, ces clés s'arrêtent : l'envoi par Internet via l'API 123-SMS les remplace, sans matériel ni abonnement. Voir fin de la 2G et de la 3G.

Questions fréquentes

Faut-il une clé GSM pour envoyer des SMS avec Domoticz ?

Non : Domoticz appelle l'API 123-SMS par Internet, via la notification Custom HTTP/Action ou un script dzVents. Aucun modem ni carte SIM n'est nécessaire.

Quelle méthode choisir ?

La notification Custom HTTP/Action suffit pour des alertes simples configurées dispositif par dispositif. Le script dzVents convient pour des messages construits (plusieurs capteurs, conditions, plusieurs numéros).

Comment tester sans consommer de crédit ?

Ajoutez &test=o à la fin de l'URL de la notification : l'API valide la requête et répond 92 sans envoyer de SMS. Retirez-le ensuite.

Que faire si le SMS n'arrive pas ?

Vérifiez l'identifiant et la clé API (code 82), le crédit (code 83) et le format du numéro (code 84), ainsi que l'accès Internet du serveur Domoticz en HTTPS.

Pourquoi le SMS pour l'astreinte ?

Parce qu'il réveille : il arrive en quelques secondes, sans application ni connexion Internet sur le téléphone de l'astreinte. Et chez 123-SMS, les crédits n'expirent jamais : une réserve d'alerte reste disponible tant qu'elle n'est pas consommée.

Combien coûte une alerte SMS ?

De 0,23 € à 0,075 € HT le SMS selon le volume de crédits, sans abonnement ; les crédits n'expirent jamais.

Testez avec votre propre besoin

5 SMS offerts pour votre essai, sur simple demande : expliquez-nous votre installation Domoticz et nous créditons votre compte professionnel pour un premier envoi en conditions réelles. Offre réservée aux professionnels : entreprises, associations et collectivités.

Demander 5 SMS de test Inscription gratuite Contacter l'équipe

L'essentiel 123-SMS

  • Sans abonnement ni frais d'installation.
  • Crédits SMS sans date d'expiration.
  • Prix dégressifs de 0,23 à 0,075 € HT le SMS.
  • API HTTP(S), envoi par e-mail ou depuis l'interface web.
  • Service français, opéré depuis 2002.