
# Téléphone Android comme passerelle SMS (Bêta)

Utilisez votre propre téléphone Android comme expéditeur de SMS. Au lieu de connecter un compte Twilio, vous installez une petite application open-source sur un téléphone Android, vous l'associez à votre espace de travail, et vos SMS sont envoyés et reçus via le numéro et le forfait mobile de ce téléphone.

> **Canal bêta.** La passerelle SMS Android est désormais disponible pour tous les utilisateurs disposant d'un forfait avec une allocation de canal, mais elle est encore nouvelle — attendez-vous à quelques imperfections occasionnelles, et notez que le comportement et les limites peuvent évoluer à mesure que le canal arrive à maturité. Si quelque chose ne fonctionne pas comme décrit, veuillez en informer le support.

---

## Pourquoi l'utiliser

La passerelle Android est conçue pour les **SMS conversationnels à faible volume** — répondre aux prospects, aux conversations IA et aux textos individuels. Elle est adaptée lorsque :

- Vous souhaitez continuer à envoyer des SMS depuis votre **numéro personnel ou professionnel existant**.
- Twilio est **surdimensionné ou mal adapté en termes de prix** pour votre pays ou votre volume.
- Vous préférez utiliser le **forfait SMS existant de votre opérateur** plutôt que de payer des frais par message.
- Vous voulez **éviter la paperasse liée à l'enregistrement auprès des opérateurs** (A2P 10DLC et similaires) exigée par Twilio.

Elle n'est **pas** conçue pour les envois groupés en masse — voir [Limitations](#limitations) ci-dessous.

> **Privilégiez Twilio pour l'échelle et la fiabilité.** Si vous envoyez des messages en volume, avez besoin d'une disponibilité garantie ou effectuez des diffusions SMS en masse, connectez plutôt un numéro Twilio — voir [Messagerie SMS](sms.md). Les deux sont des transports SMS alternatifs ; les messages, les contacts, l'IA et votre boîte de réception fonctionnent de la même manière dans les deux cas.

---

## Ce dont vous avez besoin

- **Un téléphone Android** avec une carte SIM active et un forfait SMS (un forfait SMS illimité ou généreux est fortement recommandé).
- **L'application gratuite et open-source "SMS Gateway for Android"** disponible sur [sms-gate.app](https://sms-gate.app) — téléchargez-la depuis le site ou ses [versions GitHub](https://github.com/capcom6/android-sms-gateway/releases/latest). Nous ne sommes pas les créateurs de cette application ; il s'agit d'un projet tiers.
- **Le téléphone doit rester allumé, connecté et sans restrictions** — consultez [Maintenir la fiabilité du téléphone](#keeping-the-phone-reliable).
- **Un forfait payant** — la passerelle Android est incluse dans votre quota de canaux.

Il n'y a **aucun frais de plateforme par message** et aucune facture Twilio — vous utilisez le forfait de votre propre opérateur téléphonique. Si l'IA génère une réponse, cette réponse utilise toujours des crédits IA, comme sur n'importe quel autre canal.

---

## Configuration de l'application passerelle

1. Installez **SMS Gateway for Android** depuis [sms-gate.app](https://sms-gate.app) sur le téléphone dont vous souhaitez utiliser le numéro.
2. Ouvrez l'application.
3. Activez le mode **Cloud Server** (l'option la plus simple — elle relaie via le serveur hébergé du projet afin que votre téléphone n'ait pas besoin d'une adresse publique).
4. L'application génère un **nom d'utilisateur** et un **mot de passe** sur l'écran d'accueil. Vous les collerez dans la plateforme dans la section suivante.
5. (Recommandé) Dans l'application, ouvrez **Settings → Webhooks**. Un webhook est une notification automatique que l'application envoie à la plateforme dès qu'un événement se produit — ici, dès qu'un message arrive.
6. Copiez la **Signing Key**. La coller dans la plateforme ajoute une vérification de signature supplémentaire sur les messages entrants.

> **Mode local (avancé).** Si vous préférez que le téléphone communique directement avec la plateforme sur votre propre réseau au lieu du relais cloud, l'application prend également en charge le mode Local Server. Vous devrez exposer le téléphone sur une adresse HTTPS accessible et saisir cette adresse comme URL de base lors de la connexion. Le mode Cloud est recommandé pour la quasi-totalité des utilisateurs.

---

## Connexion du téléphone à la plateforme

1. Dans la barre latérale gauche, cliquez sur **Paramètres** près du bas.
2. Dans le menu de gauche des paramètres, sous **Canaux**, cliquez sur **Canaux**.
3. Trouvez la carte **Passerelle SMS Android** et cliquez sur **Connecter**.
4. Saisissez le **Numéro de téléphone** — le numéro propre au téléphone au format international (E.164), par ex. `+14155551234`.
5. Saisissez le **Nom d'utilisateur de la passerelle** et le **Mot de passe de la passerelle** depuis l'écran d'accueil de l'application de passerelle.
6. Facultativement, collez la **Clé de signature du webhook** (recommandé) depuis les paramètres Webhooks de l'application.
7. Cliquez sur **Connecter**.


La plateforme valide les identifiants, enregistre les webhooks de message et de livraison sur la passerelle pour vous, et fait passer le statut à **Connecté**. Il n'est pas nécessaire de copier-coller des URL de webhook dans l'application : l'enregistrement est automatique.

### Vérification du statut

Une fois connecté, le bouton de la carte passe de **Connecter** à **Gérer**. Cliquez dessus pour rouvrir le panneau de la passerelle, où vous trouverez **Actualiser le statut** à tout moment. Cela vérifie à nouveau si la passerelle est joignable et indique si le téléphone est actuellement **en ligne**. Si le téléphone est en veille ou hors ligne, vous verrez un indicateur clair de hors ligne afin que vous sachiez que les SMS ne seront pas envoyés tant qu'il ne sera pas de retour.

### Déconnexion

Cliquez sur **Gérer** sur la carte pour rouvrir le panneau de la passerelle, puis cliquez sur **Déconnecter**. La plateforme supprime les webhooks qu'elle a enregistrés sur la passerelle et efface la connexion. Vos SMS seront alors redirigés vers Twilio si vous avez un numéro SMS Twilio connecté, ou les SMS seront désactivés si ce n'est pas le cas.

---

## Comment circulent les messages

### Entrants

1. Quelqu'un envoie un SMS au numéro de votre téléphone.
2. L'application passerelle sur le téléphone détecte le SMS et en informe la plateforme.
3. La plateforme crée un contact (s'il est nouveau), dépose le message dans votre boîte de réception et — si l'agent IA pertinent est actif — y répond.

### Sortants

1. Vous ou l'IA envoyez une réponse depuis la plateforme.
2. La plateforme transmet le message à votre passerelle.
3. Le téléphone l'envoie comme un SMS normal depuis votre numéro, via votre opérateur.
4. Lorsque l'opérateur renvoie un rapport, le statut du message passe à **Sent**, puis **Delivered** (ou **Failed**).

> **La passerelle Android est prioritaire pour l'envoi.** Lorsqu'elle est connectée, les réponses individuelles et celles de l'IA passent par votre téléphone. Si vous avez également un numéro SMS Twilio connecté, déconnectez la passerelle Android pour envoyer ces messages via Twilio à nouveau. Une exception dans les deux cas : **les campagnes et les diffusions SMS passent toujours par votre numéro Twilio**, jamais par le téléphone Android — l'envoi en masse depuis un combiné personnel est précisément ce qui entraîne le signalement des numéros, donc la plateforme ne le permet pas.

---

## Limitations

La passerelle Android dépend d'un téléphone physique que vous contrôlez, elle comporte donc des contraintes que vous ne rencontrerez pas avec Twilio. Examinez-les avant de l'utiliser pour des messages importants.

- **Le téléphone doit rester allumé et en ligne.** Pas de téléphone, pas de SMS. Gardez-le chargé, connecté au Wi-Fi ou aux données mobiles, et exclu de l'optimisation de la batterie.
- **Faible volume uniquement.** Les opérateurs signalent et limitent les téléphones qui envoient soudainement beaucoup de SMS. Ce canal est destiné aux conversations et aux réponses individuelles — **pas aux diffusions en masse**.
- **Les diffusions SMS en masse ne sont pas prises en charge sur ce canal.** Les envois de SMS en masse nécessitent un numéro Twilio connecté ; la plateforme vous le signalera si vous essayez d'en lancer un sans Twilio. Effectuez les diffusions via Twilio et gardez la passerelle Android pour les réponses conversationnelles.
- **Texte uniquement.** L'envoi et la réception de MMS (médias) ne sont pas pris en charge sur ce canal.
- **Les limites de l'opérateur s'appliquent.** L'allocation SMS de votre forfait téléphonique, les plafonds d'utilisation équitable et les éventuels frais par message sont entre vous et votre opérateur.
- **La confirmation de livraison dépend de votre opérateur.** Certains opérateurs signalent la livraison de manière fiable ; d'autres non. Un statut "Sent" signifie que le téléphone a expédié le SMS.
- **Risque lié au compte / numéro.** L'utilisation d'un numéro personnel pour des SMS professionnels automatisés peut enfreindre les conditions d'utilisation de votre opérateur et entraîner la limitation ou la suspension du numéro en cas d'abus. Utilisez-le de manière responsable, obtenez le consentement et incluez des instructions de désinscription.

---

## Maintenir la fiabilité du téléphone

Pour assurer la fluidité des messages sans interruption :

- **Désactivez l'optimisation de la batterie** pour l'application SMS Gateway (Paramètres Android → Applications → SMS Gateway → Batterie → Non restreint). Sinon, Android pourrait la fermer en arrière-plan.
- **Gardez l'écran accessible / autorisez l'application à s'exécuter en arrière-plan.** Un téléphone dédié laissé branché est idéal.
- **Restez sur un Wi-Fi ou des données mobiles stables.** Si le téléphone perd la connexion, les envois sont mis en file d'attente ou échouent jusqu'à ce qu'il soit de nouveau connecté.
- **Gardez la carte SIM active et en règle** auprès de votre opérateur.

---

## Dépannage

### "Impossible de valider les identifiants de la passerelle"

- Vérifiez à nouveau le **nom d'utilisateur** et le **mot de passe** sur l'écran d'accueil de l'application passerelle — ils sont régénérés si vous réinstallez ou réinitialisez l'application.
- Confirmez que le téléphone dispose d'une connexion Internet et que le mode **Serveur Cloud** est activé dans l'application.

### Le statut indique hors ligne / les SMS ne s'envoient pas

- Ouvrez l'application sur le téléphone et confirmez qu'elle est en cours d'exécution et qu'elle est connectée au serveur cloud.
- Vérifiez que le téléphone n'est pas en mode Doze / économiseur de batterie et que l'application est exclue de l'optimisation de la batterie.
- Appuyez sur **Refresh status** sur la carte après avoir remis le téléphone en ligne.

### Les SMS entrants ne s'affichent pas

- Confirmez que la connexion indique toujours **Connecté** (appuyez sur **Actualiser le statut**).
- Envoyez un SMS de test au numéro du téléphone depuis un autre téléphone.
- Assurez-vous que l'application Messages par défaut du téléphone ne bloque pas ou ne filtre pas l'expéditeur.

### Un SMS indique "Échec"

- L'opérateur l'a rejeté — vérifiez que le numéro du destinataire est valide et au format international.
- Confirmez que votre carte SIM dispose encore d'un forfait SMS et que le numéro n'est pas suspendu.
- Des taux d'envoi très élevés peuvent déclencher une limitation par l'opérateur ; ralentissez et maintenez un volume faible.

---

## Besoin d'aide ?

La passerelle SMS Android est en **Bêta**. Si vous rencontrez un problème non couvert ici, contactez <span data-t="supportEmail">hi@youraiconnector.com</span> avec :

- Le numéro de téléphone que vous avez connecté (pas le mot de passe).
- Si l'application de passerelle indique qu'elle est en ligne sur le téléphone.
- Une description du problème et le moment où il s'est produit.

Nous examinerons cela dès que possible.
