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

# Passer un appel

> Lance un appel téléphonique sortant avec un assistant IA Famulor spécifique via l'API. Transmettez les données du lead et déclenchez des conversations vocales automatisées de façon programmatique.

<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 de lancer un appel téléphonique.

### Corps de la requête

<ParamField body="phone_number" type="string" required>
  Le numéro de téléphone du client au format E.164 (par ex. +1234567890)
</ParamField>

<ParamField body="assistant_id" type="integer" required>
  L'ID de l'assistant avec lequel passer l'appel
</ParamField>

<ParamField body="variables" type="object">
  Les variables à transmettre au lead

  <Expandable title="Propriétés des variables">
    <ParamField body="customer_name" type="string" default="<string>">
      Le nom du client
    </ParamField>

    <ParamField body="email" type="string" default="<string>">
      L'adresse e-mail du client
    </ParamField>
  </Expandable>
</ParamField>

### Réponse

<ResponseField name="message" type="string">
  Message de confirmation indiquant que l'appel a bien été lancé
</ResponseField>

<ResponseField name="call_id" type="integer">
  L'ID unique de l'appel créé
</ResponseField>

<ResponseField name="status" type="string">
  Le statut initial de l'appel (par ex. "initiated")
</ResponseField>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "message": "Call initiated successfully",
    "call_id": 480337,
    "status": "initiated"
  }
  ```

  ```json 400 Invalid Phone Number theme={null}
  {
    "message": "Invalid phone number format. Please use E.164 format (e.g. +1234567890)"
  }
  ```

  ```json 404 Assistant Not Found theme={null}
  {
    "message": "Assistant not found or does not belong to the authenticated user"
  }
  ```

  ```json 422 Insufficient Balance theme={null}
  {
    "message": "Insufficient balance to make call. Please top up your account."
  }
  ```
</ResponseExample>

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