# SMS Vert Pro - Service d'envoi de SMS professionnel

> SMS Vert Pro est une plateforme française d'envoi de SMS professionnel depuis 2009. Elle propose une API REST JSON, un composant WinDev et une interface web pour envoyer des SMS en France et à l'international.

## A quoi sert SMS Vert Pro ?

SMS Vert Pro permet aux entreprises et développeurs d'envoyer des SMS depuis leurs applications, logiciels ou sites web. Les cas d'usage principaux sont :

- Notifications et alertes (livraison, rendez-vous, panne)
- Confirmations de commande ou d'inscription
- Rappels de rendez-vous
- Codes OTP (One-Time Password) pour l'authentification à double facteur
- Campagnes marketing et promotionnelles
- SMS de relance client

## API REST JSON

L'API V2 est accessible en POST à l'adresse : https://www.smsvertpro.com/api/v2/

### Authentification

L'API utilise un Bearer Token dans le header HTTP :
```
Authorization: Bearer VOTRE_TOKEN_API
```

### Endpoints disponibles

- `send_sms` : Envoyer un ou plusieurs SMS (immédiat ou programmé)
- `credits` : Consulter le solde de crédits SMS
- `reports` : Consulter les rapports de livraison
- `responses` : Consulter les SMS de réponse
- `blacklist` : Consulter la liste noire (STOP SMS)
- `transfer` : Transférer des crédits vers un sous-compte
- `cancel` : Annuler un SMS ou une campagne programmée (seuls les SMS en attente avec statut SCHEDULED_SEND)
- `add_subaccount` : Créer un sous-compte
- `generate_otp` : Générer et envoyer un code OTP
- `verify_otp` : Vérifier un code OTP
- `infos_compte` : Informations du compte
- `infos_sms` : Tarifs SMS
- `generate_token` : Générer un token d'authentification

### Exemple d'envoi de SMS

```json
POST https://www.smsvertpro.com/api/v2/
Authorization: Bearer VOTRE_TOKEN
Content-Type: application/json

{
    "request": "send_sms",
    "message": {
        "sender": "MonEntreprise",
        "text": "Bonjour, votre commande est prete.",
        "id": "camp_001"
    },
    "recipients": [
        {"gsm": "33612345678", "id": "sms_001"}
    ]
}
```

Réponse :
```json
{
    "status": "SEND_OK",
    "credits": 4852,
    "id": "camp_001",
    "sender": "MonEntreprise",
    "nbsms": 1,
    "date": "2026-04-02 14:30:00"
}
```

### Exemple OTP (authentification)

Générer un code OTP :
```json
{
    "request": "generate_otp",
    "gsm": "33612345678",
    "sender": "MonApp"
}
```

Vérifier un code OTP :
```json
{
    "request": "verify_otp",
    "code": "847392",
    "gsm": "33612345678"
}
```

### Normalisation des numéros

Les numéros peuvent être envoyés au format local avec un code pays ISO :
```json
"recipients": [
    {"gsm": "0612345678", "country": "FR"},
    {"gsm": "0475123456", "country": "BE"},
    {"gsm": "0791234567", "country": "CH"}
]
```

## Serveurs MCP (Model Context Protocol)

SMS Vert Pro propose des serveurs MCP open source permettant aux agents IA (Claude Desktop, Cursor, Windsurf, etc.) d'envoyer des SMS directement. L'agent dispose de 9 outils sans écrire de code.

### Serveur MCP Python (SDK officiel Anthropic)

- GitHub : https://github.com/3-bees-online/mcp-server-smsvertpro-python
- Prérequis : Python 3.10+, pip install mcp httpx
- 9 outils : send_sms, check_credits, get_delivery_report, get_responses, verify_number, get_blacklist, generate_otp, verify_otp, cancel_sms
- Validation des entrées (numéros, expéditeur, codes OTP, dates)
- Vérification SSL sur tous les appels API

Configuration Claude Desktop :
```json
{
  "mcpServers": {
    "smsvertpro": {
      "command": "python",
      "args": ["/chemin/vers/server.py"],
      "env": {
        "SMSVERTPRO_API_TOKEN": "votre_token"
      }
    }
  }
}
```

### Serveur MCP TypeScript / Node.js (npm)

- npm : npx @3-bees-online/mcp-server-smsvertpro
- GitHub : https://github.com/3-bees-online/mcp-server-smsvertpro-typescript
- Prérequis : Node.js 18+
- Mêmes 9 outils, installation en une commande, zéro configuration

Configuration Claude Desktop :
```json
{
  "mcpServers": {
    "smsvertpro": {
      "command": "npx",
      "args": ["@3-bees-online/mcp-server-smsvertpro"],
      "env": {
        "SMSVERTPRO_API_TOKEN": "votre_token"
      }
    }
  }
}
```

### Serveur MCP PHP (zéro dépendance)

- GitHub : https://github.com/3-bees-online/mcp-server-smsvertpro-php
- Prérequis : PHP 7.4+ avec cURL
- Mêmes 9 outils, un seul fichier, aucune dépendance externe

Configuration Claude Desktop :
```json
{
  "mcpServers": {
    "smsvertpro": {
      "command": "php",
      "args": ["/chemin/vers/server.php"],
      "env": {
        "SMSVERTPRO_API_TOKEN": "votre_token"
      }
    }
  }
}
```

### Outils MCP disponibles

| Outil | Description |
|---|---|
| send_sms | Envoyer un SMS (immédiat ou programmé) |
| check_credits | Consulter le solde de crédits |
| get_delivery_report | Rapport de délivrabilité d'une campagne |
| get_responses | Réponses SMS reçues (bidirectionnel) |
| verify_number | Vérifier le format des numéros |
| get_blacklist | Liste des désabonnements (STOP) |
| generate_otp | Envoyer un code OTP par SMS |
| verify_otp | Vérifier un code OTP |
| cancel_sms | Annuler un SMS programmé ou une campagne |

## Rédaction de SMS par IA

SMS Vert Pro intègre un assistant de rédaction de SMS par intelligence artificielle directement dans le formulaire d'envoi. Décrivez votre campagne en une phrase, l'IA génère un message professionnel optimisé pour le format SMS. Modèle hébergé en Union européenne, données anonymisées, conforme RGPD. Inclus gratuitement dans tous les comptes.

- Page : https://www.smsvertpro.com/redaction-sms-ia/

## Intégrations disponibles

- API REST JSON (tous langages : PHP, Python, C#, Java, Node.js...)
- Serveurs MCP pour agents IA (Python et PHP)
- Composant WinDev / WebDev / WinDev Mobile
- Plugin WordPress

## Tarification

- Sans abonnement, sans engagement
- A partir de 0,049 EUR HT par SMS
- Tarifs dégressifs sur volume
- Crédits SMS sans date d'expiration
- 10 SMS offerts pour tester
- Direct opérateur (Orange, SFR, Bouygues, Free)
- 98% de délivrabilité

## Fonctionnalités clés

- Envoi unitaire ou en masse
- Envoi programmé (différé)
- Personnalisation de l'expéditeur
- Accusés de réception en temps réel
- Gestion des sous-comptes (marque blanche)
- SMS OTP (One-Time Password)
- Envoi en France et à l'international (200+ pays)
- Liste noire automatique (STOP SMS)
- Rapports de livraison détaillés

## Contact

- Site web : https://www.smsvertpro.com
- Téléphone : 01 60 04 51 65
- Email : contact@smsvertpro.com
- Documentation API : https://www.smsvertpro.com/api/doc-v2.php
- Intégration IA : https://www.smsvertpro.com/integration-ia/
- Serveur MCP PHP : https://www.smsvertpro.com/serveur-mcp-sms-php.php
- Serveur MCP Python : https://www.smsvertpro.com/serveur-mcp-sms-python.php
- Serveur MCP hébergé : https://www.smsvertpro.com/serveur-mcp-sms-heberge.php
- Rédaction SMS par IA : https://www.smsvertpro.com/redaction-sms-ia/
- Composant WinDev : https://www.smsvertpro.com/composant-windev-sms.php
- API : https://www.smsvertpro.com/api-smsvertpro/