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

# Démarrage rapide

> Créez votre premier agent IA et passez un appel en 5 minutes

## Aperçu

Créez un agent vocal avec un simple prompt, attachez-y un numéro de téléphone et passez votre premier appel. Vous apprendrez également à intégrer le widget sur votre site web.

Dans ce démarrage rapide, vous allez :

1. Créer un agent
2. Passer un appel de test
3. Intégrer le widget sur votre site

<Info>
  **Prérequis** — Vous avez besoin d'un [compte Orova](https://app.orova.ai) et d'une clé API.
</Info>

## 1. Créer un agent

<Tabs>
  <Tab title="Tableau de bord">
    <Steps>
      <Step title="Accédez à Agents">
        Dans le tableau de bord Orova, accédez à **Agents** dans la barre latérale.
      </Step>

      <Step title="Créez un nouvel agent">
        Cliquez sur **Create Agent** et donnez-lui un nom.
      </Step>

      <Step title="Ajoutez un system prompt">
        ```text theme={null}
        You are a friendly phone support assistant for Acme Corp.
        Greet the caller and offer help. Keep responses under 30 words.
        If a transfer is requested, confirm the reason first.
        ```
      </Step>

      <Step title="Configurez les fournisseurs">
        Choisissez vos fournisseurs LLM, TTS et STT. Les valeurs par défaut conviennent parfaitement pour démarrer :

        * **LLM** : OpenAI GPT-4o-mini
        * **TTS** : ElevenLabs
        * **STT** : Deepgram
      </Step>

      <Step title="Définissez un premier message">
        Ajoutez une salutation telle que : *« Hi there! Thanks for calling Acme Corp. How can I help you today? »*
      </Step>
    </Steps>
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl -X POST https://app.orova.ai/api/agents \
      -H "x-api-key: YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "Support Agent",
        "llm_provider": "openai",
        "llm_model": "gpt-4o-mini",
        "tts_provider": "elevenlabs",
        "stt_provider": "deepgram",
        "system_prompt": "You are a friendly phone support assistant.",
        "first_message": "Hi there! How can I help you today?"
      }'
    ```
  </Tab>
</Tabs>

## 2. Passer un appel de test

<Tabs>
  <Tab title="Appel web (navigateur)">
    La manière la plus rapide de tester. Sur la page de détail de l'agent, cliquez sur **Talk to Agent** pour démarrer un appel WebRTC directement dans votre navigateur.
  </Tab>

  <Tab title="Appel téléphonique">
    <Steps>
      <Step title="Ajoutez un numéro de téléphone">
        Accédez à **Phone Numbers** → recherchez et achetez un numéro Twilio, ou importez le vôtre.
      </Step>

      <Step title="Affectez-le à l'agent">
        Affectez le numéro de téléphone à votre agent en mode **inbound** ou **outbound**.
      </Step>

      <Step title="Appelez-le">
        Pour les appels entrants : appelez le numéro depuis votre téléphone. Votre agent répond automatiquement.

        Pour les appels sortants via 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"
          }'
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 3. Intégrer le widget

Ajoutez le widget Orova à n'importe quel site web avec une seule balise script :

```html theme={null}
<script
  src="https://app.orova.ai/widget/orova-widget.js"
  data-api-key="YOUR_API_KEY"
  data-agent-id="AGENT_ID"
  data-server-url="https://app.orova.ai"
  data-mode="voice"
  data-title="Acme Support"
></script>
```

C'est tout. Un bouton flottant apparaît sur votre site. Les utilisateurs peuvent discuter, appeler ou faire un appel vidéo avec votre agent.

<Tip>
  Consultez [Configuration du widget](/fr/widget/configuration) pour toutes les options de personnalisation, notamment les thèmes, les couleurs et le positionnement.
</Tip>

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Configuration de l'agent" icon="sliders" href="/fr/agents/configuration">
    Affinez les fournisseurs LLM, TTS et STT
  </Card>

  <Card title="Intégrations" icon="plug" href="/fr/integrations/overview">
    Connectez HubSpot, Salesforce, Slack et plus encore
  </Card>

  <Card title="Numéros de téléphone" icon="phone" href="/fr/phone-numbers/overview">
    Configurez les appels entrants et sortants
  </Card>

  <Card title="Référence API" icon="book" href="/fr/api-reference/overview">
    Documentation complète de l'API REST
  </Card>
</CardGroup>
