# Fiche connecteur VirtualSMS
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## VirtualSMS
URL : https://get-bruno.com/features/connectors/virtualsms
Référence texte : https://get-bruno.com/features/connectors/virtualsms/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Sécurité
Description : VirtualSMS fournit des numéros de téléphone SIM réels dans de nombreux pays. Le service sert à louer un numéro, vérifier des messages SMS reçus et consulter des informations de base avant ou pendant la location.
Authentification : API key
Présentation : VirtualSMS fournit des numéros de téléphone SIM réels dans de nombreux pays. Le service sert à louer un numéro, vérifier des messages SMS reçus et consulter des informations de base avant ou pendant la location.
Usage : Louer un numéro pour recevoir un code SMS
Exemple de demande : Je veux louer un numéro pour recevoir le code de vérification du compte « Atelier Martin ».
Résultat attendu : Une commande est créée avec un identifiant de commande et un numéro attribué pour recevoir des SMS.
À préciser : Le pays souhaité pour le numéro ; Le service visé pour la location ; Le besoin de réception d'un code SMS
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/virtualsms/actions/rent-number ; https://pipedream.com/apps/virtualsms/actions/list-countries ; https://pipedream.com/apps/virtualsms/actions/list-services ; https://pipedream.com/apps/virtualsms/actions/list-country-options
Usage : Lire les SMS reçus sur une location active
Exemple de demande : Je veux consulter les messages reçus pour la commande « ORD-2048 » liée à mon numéro actif.
Résultat attendu : L'état de la commande et la liste des messages reçus sont renvoyés si la location est active et si des SMS ont été reçus.
À préciser : L'identifiant de commande ; Une location active ; Le besoin de récupérer les messages reçus
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/virtualsms/actions/check-messages ; https://pipedream.com/apps/virtualsms/actions/list-order-id-options
Usage : Vérifier le solde avant une location
Exemple de demande : Je veux vérifier le solde du compte avant de louer un numéro pour « Boutique Lenoir ».
Résultat attendu : Le solde courant du compte est renvoyé en dollars américains pour une vérification préalable.
À préciser : Le besoin de contrôle de solde ; Le contexte de la future location ; Un compte VirtualSMS accessible
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/virtualsms/actions/get-balance
Limites propres au service : Le remboursement ou l'annulation n'est possible que si la location est encore active et sans SMS reçu, ou si la politique de remboursement l'autorise. La consultation des messages est une interrogation ponctuelle d'une location active. Le service liste des pays et des services pris en charge, mais cela ne garantit pas la disponibilité d'un numéro précis. Le déclencheur de SMS repose sur une interrogation périodique du service.
Vocabulaire français : Annuler une location — Annule une location active et peut rembourser le solde inutilisé selon l'état de la location et la politique applicable. (https://pipedream.com/apps/virtualsms/actions/cancel-rental)
Vocabulaire français : Vérifier les messages — Interroge une location active pour récupérer les SMS déjà reçus et l'état courant de la commande. (https://pipedream.com/apps/virtualsms/actions/check-messages)
Vocabulaire français : Obtenir le solde — Renvoie le solde actuel du compte en dollars américains. (https://pipedream.com/apps/virtualsms/actions/get-balance)
Vocabulaire français : Lister les pays — Liste les pays pris en charge avec des indicateurs de stock et l'identifiant de pays à utiliser pour louer un numéro. (https://pipedream.com/apps/virtualsms/actions/list-countries)
Vocabulaire français : Lister les options de pays — Récupère les valeurs possibles pour le champ pays. (https://pipedream.com/apps/virtualsms/actions/list-country-options)
Vocabulaire français : Lister les options d'identifiant de commande — Récupère les valeurs possibles pour le champ identifiant de commande. (https://pipedream.com/apps/virtualsms/actions/list-order-id-options)
Vocabulaire français : Lister les services — Liste les services pris en charge avec leurs codes, catégories et prix de base. (https://pipedream.com/apps/virtualsms/actions/list-services)
Vocabulaire français : Louer un numéro — Loue un numéro de téléphone SIM réel pour recevoir un code de vérification par SMS. (https://pipedream.com/apps/virtualsms/actions/rent-number)
Vocabulaire français : Nouveau SMS reçu — Déclenche un événement pour chaque SMS reçu sur une location active. (https://pipedream.com/apps/virtualsms/triggers/new-sms-received)
- action : Cancel Rental — Cancel an active rental and refund any unused balance. Cancellation is only possible while the rental is still active and no SMS has been received (or the cancellation policy permits a refund). See the documentation (https://pipedream.com/apps/virtualsms/actions/cancel-rental)
- action : Check Messages — Poll an active rental for any SMS messages received so far. Returns the current order state, including a messages array (each item has sender , content , received_at ) when one or more SMS have arrived. For event-driven workflows prefer the New SMS Received trigger. See the documentation (https://pipedream.com/apps/virtualsms/actions/check-messages)
- action : Get Balance — Retrieve the current account balance in USD. Useful for low-balance alerts or pre-flight checks before renting numbers. See the documentation (https://pipedream.com/apps/virtualsms/actions/get-balance)
- action : List Countries — List all supported countries with current stock indicators ( available_phones , total_phones ). Use the returned country_id (ISO-3166-1 alpha-2) when calling Rent Number . See the documentation (https://pipedream.com/apps/virtualsms/actions/list-countries)
- action : List Country Options — Retrieves available options for the Country field. (https://pipedream.com/apps/virtualsms/actions/list-country-options)
- action : List Order ID Options — Retrieves available options for the Order ID field. (https://pipedream.com/apps/virtualsms/actions/list-order-id-options)
- action : List Services — List all supported services (700+) with their service codes, categories, and base prices. Use the returned service_id (or code ) when calling Rent Number . See the documentation (https://pipedream.com/apps/virtualsms/actions/list-services)
- action : Rent Number — Rent a real-SIM virtual phone number to receive an SMS verification code. Returns the order ID and assigned phone number — pair this with the New SMS Received trigger or the Check Messages action to retrieve the code. See the documentation (https://pipedream.com/apps/virtualsms/actions/rent-number)
- trigger : New SMS Received — Emit new event for each SMS message received on any of your active rentals. Polls the VirtualSMS API on the configured interval (default 60s) and de-duplicates so each SMS is emitted exactly once. See the documentation (https://pipedream.com/apps/virtualsms/triggers/new-sms-received)