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

# Passer un appel téléphonique

> Lancer un appel téléphonique sortant

## Requête

```bash theme={null}
curl -X POST https://app.orova.ai/api/optimus/call \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantId": "AGENT_ID",
    "phoneNumber": "+1234567890",
    "phoneNumberId": "PHONE_NUMBER_ID",
    "contactName": "John Doe",
    "workspaceId": "WORKSPACE_ID"
  }'
```

## Paramètres

| Champ           | Type   | Requis | Description                                                  |
| --------------- | ------ | ------ | ------------------------------------------------------------ |
| `assistantId`   | string | Oui    | Agent à utiliser pour l'appel                                |
| `phoneNumber`   | string | Oui    | Numéro de téléphone de destination (E.164)                   |
| `phoneNumberId` | string | Oui    | Numéro Orova depuis lequel appeler                           |
| `contactName`   | string | Non    | Nom du contact pour l'historique et l'injection de variables |
| `workspaceId`   | string | Oui    | ID de l'espace de travail                                    |

## Réponse

```json theme={null}
{
  "call_id": "call_abc123",
  "status": "initiated"
}
```

## Remarques

* Une vérification des crédits est effectuée avant l'appel. Renvoie `402` si les crédits sont insuffisants.
* Si `contactName` est fourni, Orova recherche le contact et injecte ses données sous forme de variables.
* L'appel est lancé via Twilio. L'agent prononce le premier message lorsque le destinataire répond.