> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Envoyer un SMS

> Envoie un message SMS depuis votre numéro de téléphone Famulor via l’API. Déclenchez des SMS transactionnels ou de suivi après des appels vocaux IA, la capture de prospects ou des campagnes.

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Ce point de terminaison vous permet d’envoyer des messages SMS via vos numéros de téléphone achetés. Le SMS est envoyé via Twilio, et les coûts sont automatiquement déduits du solde de votre compte.

### Corps de la requête

<ParamField body="from" type="integer" required>
  L’identifiant de votre numéro de téléphone depuis lequel le SMS sera envoyé (doit être compatible SMS)
</ParamField>

<ParamField body="to" type="string" required>
  Le numéro de téléphone du destinataire au format international (par ex., « +4915123456789 »)
</ParamField>

<ParamField body="body" type="string" required>
  Le contenu du message SMS (300 caractères max.)
</ParamField>

### Champs de réponse

<ResponseField name="message" type="string">
  Message de succès confirmant que le SMS a été envoyé
</ResponseField>

<ResponseField name="data" type="object">
  Données supplémentaires concernant le SMS envoyé
</ResponseField>

### Réponses d’erreur

<ResponseField name="400 Bad Request" type="object">
  <Expandable title="Détails de l’erreur">
    <ResponseField name="message" type="string">
      Message d’erreur décrivant le problème (numéro de téléphone invalide, solde insuffisant, etc.)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="500 Internal Server Error" type="object">
  <Expandable title="Erreur serveur">
    <ResponseField name="message" type="string">
      Message d’erreur indiquant un échec d’envoi du SMS
    </ResponseField>

    <ResponseField name="error" type="string">
      Informations détaillées sur l’erreur
    </ResponseField>
  </Expandable>
</ResponseField>

### Remarques

* Le numéro de téléphone expéditeur doit appartenir à l’utilisateur authentifié
* Le numéro de téléphone expéditeur doit être compatible SMS
* L’abonnement du numéro de téléphone doit être actif (non expiré)
* Un solde de compte suffisant est requis pour couvrir les coûts du SMS
* Les numéros de téléphone sont automatiquement formatés au format E.164
* Les coûts des SMS varient selon le pays de destination et sont facturés par segment
* Les messages longs peuvent être divisés en plusieurs segments, augmentant le coût
* Le numéro de téléphone du destinataire doit respecter les normes internationales

<ResponseExample>
  ```json 200 Sent Successfully theme={null}
  {
    "message": "SMS sent successfully",
    "data": {
      "sms_id": "SMS_67890",
      "from": "+4912345678",
      "to": "+4915123456789",
      "body": "Hello! This is a test SMS from Famulor.",
      "segments": 1,
      "cost": 0.05,
      "currency": "EUR",
      "status": "sent"
    }
  }
  ```

  ```json 400 Invalid Request theme={null}
  {
    "message": "Invalid phone number format"
  }
  ```

  ```json 400 Insufficient Balance theme={null}
  {
    "message": "Insufficient balance to send SMS"
  }
  ```

  ```json 400 Phone Number Not SMS-Capable theme={null}
  {
    "message": "Phone number is not SMS-capable"
  }
  ```

  ```json 400 Phone Number Not Found theme={null}
  {
    "message": "From number not found"
  }
  ```

  ```json 500 Server Error theme={null}
  {
    "message": "Failed to send SMS",
    "error": "Twilio service temporarily unavailable"
  }
  ```
</ResponseExample>

<Tip>
  Pages associées : [Introduction](/fr/api-v1/introduction) et [Guide d’authentification](/fr/api-v1/authentication), et [Exemples d’intégration API](/fr/api-v1/introduction).
</Tip>