Documentation SMS

Envoyer un SMS

Point final : 

Paramètres:

Exemple:

Renvoyer un SMS non envoyé

Ce point de terminaison API est utilisé pour renvoyer un SMS non envoyé (uniquement si le message a un statut d'erreur).

Point final :

Paramètre: 

Exemple: 

Journal des SMS envoyés depuis l'API

Ce point de terminaison API est utilisé pour récupérer le journal des messages SMS envoyés via l'API.

Point final : 

Paramètre:

Exemple:

Liste des SMS envoyés depuis un mobile

Ce point de terminaison API permet de lister les SMS envoyés depuis votre appareil mobile et synchronisés avec votre compte SMSMobileAPI.

Important: Cette fonctionnalité est disponible à partir de la version Android 4.1.20.

Important: Cette fonctionnalité est non activé par défaut dans l'application Android.

Confidentialité: Toutes les informations synchronisées sont anonymisées, confidentielles et traitées en toute sécurité.

Limite de l'historique : Cette API renvoie toujours les données de la dernière 7 jours seulement.

Note: Si vous envoyez des SMS en utilisant le point de terminaison API standard https://api.smsmobileapi.com/sendsms/Ces SMS peuvent également apparaître dans cette liste car ils sont physiquement envoyés depuis votre appareil mobile.

Point final :

Paramètres: 

Champs renvoyés : 

Exemple: 

Exemple avec filtres :

Exemple avec période prédéfinie :

SMS reçu

Ce point de terminaison API est utilisé pour récupérer les messages SMS reçus sur le smartphone. 

Point final :

Paramètre: 

Exemple:

Marquer les messages SMS reçus comme lus

Ce point de terminaison d'API est utilisé pour marquer un SMS reçu comme lu dans le État de l'API uniquement.
Cela ne modifie pas le statut de lecture sur le smartphone.  

Point final :

Paramètre: 

Exemple:

Mettre à jour l'alias SMS

Ce point de terminaison d'API est utilisé pour mettre à jour l'alias d'un SMS reçu à l'aide de son GUID.

Note: Le alias Ce paramètre peut être vide. Dans ce cas, l'alias sera effacé.

Point final :

Paramètres: 

Exemple: 

Exemple pour supprimer l'alias :

Supprimer les SMS

Ce point de terminaison d'API est utilisé pour supprimer les messages SMS du journal du serveur de l'API SMS Mobile.

Point final : 

Paramètre:

Exemple:

Remarque : Seuls les SMS enregistrés dans les journaux du serveur seront supprimés. Les SMS présents sur l’appareil ne seront pas supprimés.

Liste des conversations SMS

Ce point de terminaison API permet de lister les conversations SMS liées à votre compte.

Chaque conversation est regroupée par numéro de téléphone et contient les SMS entrants et sortants associés.

Note: Le point de départ de la conversation est défini par le origineConversation paramètre:

• received: les conversations sont d'abord détectées à partir des SMS reçus dans logsmsreceive
• sent: les conversations sont d'abord détectées à partir des SMS envoyés dans logsmssent

Note: Si numero Si cette information n'est pas fournie, l'API ne renvoie que les conversations les plus récentes. Par défaut, la dernière 20 Les conversations sont renvoyées.

Note: Pour les SMS sortants, si timearea_of_message est disponible (exemple : UTC+02La date affichée est automatiquement convertie à l'aide de cette valeur. Cette date convertie sert également au tri.

Note: Si resume=1Seuls les derniers messages de chaque conversation sont affichés. Utilisez resume_line_how définir le nombre de messages les plus récents à inclure.

Point final :

Paramètres: 

Détails du comportement : 

Exemple 1 - Lister les dernières conversations issues des SMS reçus : 

Exemple 2 - Lister les dernières conversations issues des SMS envoyés :

Exemple 3 - Filtrer un numéro de téléphone spécifique :

Exemple 4 - Filtrer par plage de dates :

Exemple 5 - Reprise du mode avec les 3 derniers messages par conversation :

Exemple de réponse réussie : 

{ "success": true, "origineConversation": "received", "resume": 0, "resume_line_how": null, "conversations": [ { "phone_number": "+10470000001", "contact_alias": "John Doe", "messages": [ { "direction": "incoming", "message_id": "msg_1001", "date": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "message": "Bonjour, je souhaite obtenir plus d'informations.", "status": "received", "mobile_sid": "device_sid_1" }, { "direction": "outgoing", "message_id": "msg_1002", "date": "2026-03-13 10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "Bien sûr, que souhaitez-vous savoir ?", "status": "envoyé", "mobile_sid": "device_sid_2" } ] } ] }

Champs de réponse :

Exemple d'erreur :

{ "success": false, "error": "Paramètre requis manquant : apikey" }

Remarques :

Passerelle – Liste des mobiles connectés

Liste des mobiles connectés à votre Passerelle SMS.

Point final :

Paramètres:

Exemple:

Passerelle – Mettre à jour une étiquette mobile

Mettre à jour l'étiquette (nom_reference) d'un mobile connecté.

Point final :

Paramètres:

Exemple:

Important: L'étiquette est obligatoire mais peut être vide. (étiquette=).

Passerelle – Supprimer un mobile connecté

Supprimez un mobile connecté à votre passerelle (supprime toutes les lignes d'historique pour ce SID).

Point final :

Paramètres:

Exemple:

Webhook – SMS reçus

Ce système de webhook envoie une requête POST à l'URL configurée à chaque réception d'un SMS. Le système assure des mises à jour en temps réel en envoyant les détails du SMS à l'URL du webhook spécifiée.

Comment configurer le Webhook dans le tableau de bord

Suivez ces étapes pour configurer l’URL de votre webhook dans le tableau de bord :

1. Connectez-vous à votre compte sur le Tableau de bord de l'API mobile SMS.
2. Accédez au Paramètres du webhook section.
3. Saisissez l'URL de votre webhook (par exemple, https://example.com/webhook-endpoint).
4. Cliquez sur le Enregistrer le Webhook bouton. 
5. Une fois enregistré, le système commencera à envoyer les détails du SMS à l'URL configurée.

Charge utile du webhook

Lorsqu'un SMS est reçu, le système envoie la charge utile JSON suivante à l'URL de votre webhook :

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "Bonjour, ceci est un test.", "number": "+123456789", "guid": "abcde12345" }

Champs de charge utile :

• date: Date à laquelle le SMS a été ajouté (AAAA-MM-JJ).
• heure: Heure à laquelle le SMS a été ajouté (HH:mm:ss).
• heure_reçue : Heure à laquelle le SMS a été reçu.
• message: Contenu du SMS. 
• nombre: Numéro de téléphone de l'expéditeur.
• guide: Identifiant unique du SMS.

Exemple de point de terminaison Webhook

Votre serveur doit être prêt à gérer les requêtes POST entrantes. Vous trouverez ci-dessous un exemple de script PHP pour traiter la charge utile du webhook :

Tester le Webhook

Pour tester la configuration de votre webhook, utilisez des outils tels que :

• Webhook.site
• DemandeBin

Dépannage

• Assurez-vous que l’URL du webhook est correcte et accessible au public.
• Vérifiez que votre serveur renvoie un code d’état HTTP 200 pour les requêtes réussies.
• Vérifiez les journaux de votre serveur pour détecter d’éventuelles erreurs dans le traitement de la charge utile.

SMS enrichis

Authentification

L'API SMSMobile prend en charge deux méthodes d'authentification : à l'aide d'une simple clé API ou du protocole OAuth2 avec un ID client et un secret client.

1. Authentification par clé API

 Cette méthode nécessite une clé API qui peut être incluse comme paramètre dans une requête GET ou POST.

2. Authentification OAuth2

OAuth2 offre une méthode d'authentification plus sécurisée.
Utilisez un ID client et un secret client pour obtenir un jeton d'accès, puis incluez-le dans le Autorisation en-tête.

Le client_id et le client_secret sont disponibles dans votre tableau de bord.
Téléchargez l'application mobile maintenant ou Accédez à votre tableau de bord.

Obtention d'un jeton d'accès

Utilisation du jeton d’accès :

Quelle méthode devriez-vous utiliser ?

- Utiliser Authentification par clé API pour des intégrations rapides et simples.

- Utiliser Authentification OAuth2 pour une sécurité et une évolutivité accrues.