Les réponses arrivent sur le numéro mobile que votre contact connaît déjà.
REÇU SMS API · VOTRE MOBILE RESTE LA BOÎTE DE RÉCEPTION
Transformez chaque SMS reçu sur votre mobile en données exploitables par vos applications.
Votre contact envoie un SMS normal vers votre numéro mobile existant. Le message arrive d'abord sur votre téléphone connecté, puis SMSMobileAPI synchronise de manière sécurisée les données prises en charge afin que votre application puisse récupérer, classer et traiter la réponse.
Aucun numéro virtuel ne remplace votre téléphone : votre mobile, votre SIM et votre numéro existant restent au cœur de l’échange.
« Pouvez-vous me rappeler ? »
Pouvez-vous me rappeler ?
/getsms/200number+15550129841
deviceMobile commercial
statusPRÊT
Récupérez l'expéditeur, le message, le mobile destinataire, l'horodatage, le GUID et un alias optionnel.
Centralisez les réponses tout en conservant l'information sur le téléphone connecté ayant reçu chaque SMS.
L'EXPLICATION SIMPLE
Le API ne remplace pas votre téléphone. Il rend exploitables les SMS qu'il reçoit.
SMSMobileAPI ajoute une couche logicielle sécurisée autour d'une véritable boîte de réception mobile. Cela permet à votre CRM, plateforme de support ou application interne d'accéder aux données éligibles des messages reçus sans modifier le numéro utilisé par vos contacts.
Un contact envoie un SMS
Le contact écrit au numéro réel associé à votre SIM.
Votre mobile le reçoit
Le SMS arrive via votre opérateur mobile sur le téléphone connecté.
L'application le synchronise
Avec les autorisations requises et l'accès en arrière-plan, l'application officielle envoie de manière sécurisée les données des messages pris en charge vers votre compte.
Votre logiciel l'utilise
Récupérez-le avec le REST API, recevez un événement Webhook V2 ou affichez-le dans une intégration compatible.
UNE RÉPONSE QUE VOTRE APPLICATION PEUT UTILISER
Une seule requête renvoie le message et le contexte nécessaires pour le traiter.
Utilisez GET /getsms/ pour lister les SMS entrants synchronisés. Filtrez par mobile destinataire, demandez uniquement les messages non lus ou récupérez les messages après un timestamp Unix.
- number
- L'expéditeur au format international lorsque disponible.
- message
- Le texte du SMS synchronisé depuis le mobile connecté.
- sIdentifiantPhone
- Le mobile connecté qui a reçu le SMS.
- timestamp_unix
- L'heure du message, prête pour le tri et la synchronisation incrémentale.
- guid
- Une référence de message stable pour les opérations d'état de lecture et de suivi.
- alias
- Un libellé de contact ou d'application optionnel.
{
"result": {
"error": "",
"sms": [{
"sIdentifiantPhone": "508b004b4aadacc4",
"timestamp_unix": 1774041814,
"message": "Can you call me back?",
"number": "+15550129841",
"guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
"alias": "Alex Morgan"
}]
}
}CHOISISSEZ LE BON MODE DE LIVRAISON
Récupérez les messages par API — ou réagissez immédiatement avec Webhook V2.
Les deux méthodes utilisent les mêmes données mobiles connectées. Choisissez selon le fonctionnement de votre application, ou combinez-les pour des réactions rapides et une récupération fiable.
Votre application demande les messages lorsqu'elle est prête.
- Créez une boîte de réception ou une synchronisation planifiée
- Filtrer par mobile, heure ou état non lu
- Récupérer les messages après une interruption
SMSMobileAPI envoie un événement sms.received à votre destination HTTPS.
- Réagir sans boucle de sondage
- Utiliser une livraison durable et des tentatives automatiques
- Démarrer un workflow dès que l'événement est disponible
Plus qu'une simple liste de messages
Créez un workflow complet pour la réception de SMS.
/getsms/Lister les SMS reçus
Utilisez des filtres par mobile, horodatage et état non lu pour récupérer uniquement ce dont votre application a besoin.
/getsms/set-read/Marquer comme traité
Mettez à jour l'état de lecture API du SMSMobileAPI après que votre application a traité un message.
/getsms/update/Joindre un alias
Associez un nom de contact ou un libellé d'application à un message reçu.
/conversation/sms/list/Créez des conversations
Regroupez les messages entrants et sortants par numéro de téléphone pour une chronologie de support ou CRM.
Le fait de marquer un message comme lu via le API ne modifie pas son état de lecture dans l'application de messagerie du téléphone.
Que pouvez-vous construire ?
D'une réponse unique à un processus métier complet.
Créez une boîte de réception SMS partagée
Dirigez les réponses de plusieurs téléphones autorisés vers une vue de support unique tout en conservant l'information du mobile ayant reçu le message.
Complétez la chronologie du contact
Ajoutez les réponses entrantes au dossier client aux côtés des SMS sortants et de l'activité d'appels prise en charge.
Interprétez automatiquement les confirmations
Détectez les confirmations, annulations ou demandes de report et mettez à jour l'étape suivante.
Faites remonter les messages importants
Informez la bonne personne, appelez un API ou lancez une automatisation Workflow Studio lorsque les conditions sont remplies.
DE ZÉRO À LA PREMIÈRE RÉPONSE API
Recevez votre premier SMS via le API en quatre étapes contrôlées.
- 1
Installez et associez le mobile
Installez la dernière application officielle SMSMobileAPI et connectez le téléphone compatible à votre compte.
- 2
Activez l'accès aux SMS reçus
Dans l'application mobile, autorisez la synchronisation des SMS reçus et le fonctionnement en arrière-plan requis par votre workflow.
- 3
Envoyez un message de test unique
Envoyez un SMS depuis un autre numéro vers le mobile connecté et vérifiez-le dans le journal du tableau de bord SMS des messages reçus.
- 4
Appelez le point de terminaison de façon sécurisée
Conservez la clé API sur votre serveur, appelez /getsms/ et enregistrez le GUID afin que votre application puisse éviter un traitement en double.
FAQ — API : SMS reçus
Questions que les développeurs et les équipes opérationnelles posent en priorité.
Est-ce que le API reçoit le SMS à la place de mon mobile ?
Non. Votre mobile compatible connecté et sa carte SIM reçoivent d'abord le SMS. SMSMobileAPI synchronise ensuite les données de message prises en charge afin qu'elles puissent être récupérées par votre logiciel.
Plusieurs mobiles peuvent-ils alimenter la même application ?
Oui. Plusieurs mobiles autorisés peuvent être connectés à un même compte, et l'identifiant du mobile récepteur permet à votre application de préserver la source de chaque message.
Dois-je utiliser le sondage (polling) ou Webhook V2 ?
Utilisez GET /getsms/ lorsque votre application contrôle le calendrier de récupération ou nécessite une reprise. Utilisez l'événement Webhook V2 de sms.received lorsque vous souhaitez qu'une destination HTTPS réagisse dès que l'événement est disponible. De nombreux systèmes en production combinent les deux.
Comment éviter de traiter deux fois le même message ?
Stockez le GUID du message dans votre application et rendez le traitement idempotent. Après un traitement réussi, vous pouvez aussi mettre à jour l'état de lecture API de SMSMobileAPI.
Marquer un message comme lu modifie-t-il la boîte de réception du téléphone ?
Non. Le point de terminaison modifie l'état de lecture côté API utilisé par les flux de travail SMSMobileAPI; il ne marque pas le message comme lu dans l'application de messagerie du téléphone.
Puis-je répondre depuis mon application ?
Oui. Votre application peut appeler le point de terminaison d'envoi SMS afin qu'un mobile connecté sélectionné envoie la réponse via sa SIM et son numéro de mobile.
Permettez à votre logiciel d'interpréter chaque réponse utile reçue par votre mobile.
Connectez un téléphone, autorisez la synchronisation received-SMS et testez le parcours complet avant de l'étendre à votre CRM, plateforme d'assistance ou automatisation.
