Aller au contenu

Passerelle SMS

KiwiDesk envoie ses SMS par un téléphone Android de la boutique, avec une carte SIM ordinaire (un forfait SMS illimité suffit). Le téléphone expédie les SMS demandés par KiwiDesk et lui renvoie les accusés de réception et les réponses des clients, qui arrivent dans la messagerie. Le téléphone n’a pas besoin d’être sur le même réseau que le serveur : il peut être en 4G/5G.

La passerelle se règle par boutique, dans Paramètres > Communications & SMS, onglet SMS.

Mode (libellé dans KiwiDesk) Principe Quand le choisir
Téléphone connecté (4G/Wi-Fi) Le téléphone se connecte lui-même à KiwiDesk et vient chercher les SMS à envoyer. Aucun service tiers, aucun port à ouvrir. Demande l’application de KiwiDesk sur le téléphone.
Cloud Push FCM (4G/5G) KiwiDesk passe par le relais api.sms-gate.app, qui réveille le téléphone par notification. Le plus simple avec l’application gratuite « SMS Gateway for Android ».
Réseau local / VPN KiwiDesk appelle directement le téléphone (http://IP:8080). Téléphone et serveur sur le même réseau, ou reliés par un VPN.
Webhook générique KiwiDesk appelle une adresse HTTP de votre choix. Une passerelle SMS professionnelle ou un autre outil (MacroDroid…).
Bloc Passerelle SMS : mode de connexion, adresse de la passerelle, identifiant, mot de passe et protection de la carte SIM.

Le bloc Passerelle SMS, ici en mode Réseau local / VPN sur une instance de test.

  1. Sur le téléphone, installez SMS Gateway for Android (projet libre capcom6/android-sms-gateway, disponible sur le Play Store et sur GitHub), autorisez l’envoi de SMS et désactivez l’optimisation de batterie pour cette application.
  2. Dans l’application, activez Serveur cloud et notez l’identifiant et le mot de passe affichés.
  3. Dans KiwiDesk, choisissez Cloud Push FCM (4G/5G), saisissez l’Identifiant et le Mot de passe, puis Enregistrer.
  4. Cliquez sur Enregistrer les webhooks : KiwiDesk déclare lui-même, dans l’application, les adresses où renvoyer les accusés et les SMS reçus.
  5. Cliquez sur Vérifier la connexion, puis saisissez un Numéro de test (un mobile) et cliquez sur Envoyer un SMS de test. Les étapes s’affichent : Mis en file par KiwiDesk, Envoyé sur le réseau, Reçu sur le mobile.

Le relais réveille le téléphone même en veille profonde. Le contenu des SMS transite par ce service.

Le bloc Réception des SMS donne l’URL du webhook entrant (https://<votre-domaine>/api/public/webhooks/sms/<boutique>) et la Clé de signature que le téléphone utilise pour signer ses envois ; un QR code permet de les copier dans l’application (Paramètres > Webhooks > Signing Key). Enregistrer les webhooks les déclare automatiquement dans les modes Cloud et Réseau local.

Générer une nouvelle clé invalide l’ancienne : les SMS reçus sont refusés tant que la nouvelle n’est pas saisie dans le téléphone.

Un SMS reçu est rattaché au client d’après son numéro et apparaît dans sa conversation ; une réponse « STOP » désinscrit le client des SMS.

Les opérateurs suspendent les lignes qui envoient trop de SMS trop vite. Le bloc Protection de la carte SIM fait partir les SMS un par un :

  • Pause min. (s) et Pause max. (s) : pause aléatoire entre deux envois, 4 à 9 s conseillés ;
  • SMS par heure : plafond horaire, 60 conseillés ;
  • SIM : la carte utilisée sur un téléphone double SIM.

Les numéros fixes (01 à 05, 09) sont toujours refusés : seuls les mobiles reçoivent des SMS. Les messages automatiques respectent en plus la plage d’envoi de la boutique (voir Messages automatiques et plages d’envoi).

  • « Passerelle SMS injoignable » : mauvaise adresse ou téléphone éteint, sans réseau, ou application arrêtée par l’économiseur de batterie. Laissez le téléphone branché et excluez l’application de l’optimisation de batterie.
  • Le SMS de test reste à « Mis en file par KiwiDesk » : le téléphone ne récupère pas les SMS (mode Téléphone connecté hors ligne, identifiants du relais erronés).
  • « Pas d’accusé de réception » : les webhooks ne sont pas enregistrés sur le téléphone, ou l’URL du webhook entrant n’est pas joignable depuis le téléphone.
  • Réponses des clients refusées : la clé de signature du téléphone ne correspond plus (nouvelle clé générée).
  • Envois en échec : ils sont listés en haut de la page de réglages et dans la messagerie ; Réessayer tout les remet en file, sauf ceux devenus périmés ou adressés à un client désinscrit.