> ## 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.

# Appels téléphoniques

> Passez et recevez des appels téléphoniques avec votre agent IA via Twilio

## Vue d'ensemble

Orova utilise Twilio pour l'intégration des appels téléphoniques. Votre agent peut recevoir des appels entrants et passer des appels sortants vers n'importe quel numéro de téléphone.

## Appels entrants

<Steps>
  <Step title="Achetez ou importez un numéro de téléphone">
    Allez dans **Numéros de téléphone** dans le tableau de bord. Recherchez un numéro ou importez votre numéro Twilio existant.
  </Step>

  <Step title="Attribuez-le à un agent">
    Attribuez le numéro à votre agent en mode **entrant**. Orova configure automatiquement les webhooks Twilio.
  </Step>

  <Step title="Appelez le numéro">
    Quand quelqu'un appelle le numéro, Orova achemine l'appel vers votre agent. L'agent prononce le premier message et démarre la conversation.
  </Step>
</Steps>

### Comment fonctionne le routage entrant

1. Un appel arrive sur votre numéro de téléphone Orova
2. Orova l'achemine vers l'agent attribué
3. L'agent prononce le premier message et démarre la conversation

## Appels sortants

### Depuis le tableau de bord

Dans la page **Contacts**, sélectionnez des contacts et cliquez sur **Appeler**. Choisissez l'agent et le numéro de téléphone à utiliser.

### Depuis l'API

```bash theme={null}
curl -X POST https://app.orova.ai/api/optimus/phone-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"
  }'
```

### Flux d'un appel sortant

1. Orova initie l'appel via Twilio
2. Lorsque le destinataire répond, l'agent prononce le premier message
3. Le moteur vocal en temps réel gère la conversation
4. La détection de messagerie vocale s'exécute automatiquement — si une messagerie vocale est détectée, l'appel se termine

## Raisons de fin d'appel

| Raison               | Description                                               |
| -------------------- | --------------------------------------------------------- |
| `user_hangup`        | L'utilisateur a mis fin à l'appel                         |
| `agent_goodbye`      | L'agent a dit au revoir via l'outil end\_conversation     |
| `user_idle_timeout`  | L'utilisateur est resté silencieux trop longtemps         |
| `voicemail_detected` | Une messagerie vocale a été détectée sur un appel sortant |
| `no_answer`          | Le destinataire n'a pas répondu                           |
| `customer_busy`      | La ligne du destinataire était occupée                    |

## Enregistrements

Lorsque `recording_enabled` est activé sur l'agent, les appels sont automatiquement enregistrés. Accédez aux enregistrements via la page Historique ou l'API.