# Clés API

Les clés API sont optionnelles. Terminez d'abord [l'inscription](https://docs.voicelogica.ai/fr/getting-started/sign-up/), [l'abonnement](https://docs.voicelogica.ai/fr/getting-started/activate-subscription/) et [votre premier agent](https://docs.voicelogica.ai/fr/getting-started/your-first-agent/) avant d'en avoir besoin.

Ce sont des identifiants programmatiques pour l'API Voice Logica. Chaque clé est limitée aux opérations que vous autorisez et peut être restreinte à une adresse IP. La même clé signe également les clients MCP (ChatGPT, Claude) dans votre espace de travail.

Ouvrez **Team and access** depuis le groupe Account dans la barre latérale, puis sélectionnez l'onglet **API Keys**. Cette page contient également **Members**, **Pending invitations** et **Access Requests**.

> **Note:** Les clés pour les fournisseurs IA (OpenAI, ElevenLabs, ...) se trouvent sur la page **AI Provider Keys**, pas ici.
## Créer une clé API

1. **Ouvrez API Keys et créez une nouvelle clé**

   Sur l'onglet **API Keys**, cliquez sur **+ Api Key**.

     ![Onglet API Keys avec bouton + Api Key](https://docs.voicelogica.ai/assets/getting-started/api-keys-0.png)

2. **Choisissez un préréglage, nommez la clé et définissez une IP si nécessaire**

   Le tiroir **Create API key** s'ouvre à droite.

   - **Preset** - commencez par l'accès complet (toutes les opérations) ou un autre préréglage, puis affinez ci-dessous.
   - **API Key Name** - utilisez un nom d'objectif clair tel que `CRM Integration`, `Webhook Handler` ou `Initiate Call`.
   - **IP Address** - optionnel. Laissez-le vide pour autoriser n'importe quelle IP. Saisissez uniquement une adresse réelle lorsque l'appelant a une IP fixe. Ne saisissez pas `0.0.0.0` comme substitut pour "n'importe quelle IP" ; vide signifie déjà n'importe quelle IP.

     ![Tiroir Create API key avec nom CRM Integration](https://docs.voicelogica.ai/assets/getting-started/api-keys-1.png)

3. **Choisissez les opérations autorisées**

   Sous **API operation restrictions**, développez chaque groupe et basculez ce que cette clé peut appeler. Les groupes incluent **Calls**, **Agents**, **Workflows**, **VoIP & SIP**, **SMS**, **MCP**, **Billing**, **Shopify** et **Campaigns**. Laissez tout activé pour un accès complet, ou désactivez ce dont la clé n'a pas besoin.

     ![Groupes de restrictions d'opération API](https://docs.voicelogica.ai/assets/getting-started/api-keys-2.png)

4. **Créez la clé et copiez-la une fois**

   Cliquez sur **Create API Key**. La boîte de dialogue **Copy your API key** affiche la valeur complète une seule fois. Cliquez sur **Copy**, stockez la clé en lieu sûr, puis cliquez sur **Done**.

     ![Dialogue Copy your API key](https://docs.voicelogica.ai/assets/getting-started/api-keys-3.png)

> **La clé n'est affichée qu'une seule fois:** Après avoir fermé cette boîte de dialogue, le tableau n'affiche qu'une clé masquée. Vous ne pouvez plus voir la valeur complète. Si vous la perdez, révoquez la clé et créez-en une nouvelle.
> **Principe du moindre privilège:** N'accordez que les opérations dont une clé a besoin, utilisez une clé séparée par intégration, et définissez une restriction IP lorsque l'appelant a une adresse fixe. Si une clé est exposée, révoquez-la immédiatement.
## Gérer vos clés

Le tableau liste le **Name**, la **Key** masquée, le **Last Used** et la date **Created** de chaque clé. Utilisez la recherche pour trouver une clé par nom.

  ![Tableau des clés API avec CRM Integration](https://docs.voicelogica.ai/assets/getting-started/api-keys-4.png)

- **Edit** (crayon) - modifiez le nom, la restriction IP et les opérations autorisées. La valeur secrète elle-même n'apparaît plus jamais et ne peut pas être alternée sur place.
- **Revoke** (corbeille) - ouvre **Revoke API key?** Confirmez avec **Revoke** pour supprimer définitivement la clé. Les applications qui l'utilisent perdent immédiatement l'accès. Il n'y a pas d'action Delete séparée.

## Utiliser votre clé API

Authentifiez les requêtes en envoyant la clé dans l'en-tête `x-api-key` :

```
x-api-key: YOUR_API_KEY
```

Par exemple, pour démarrer un appel IA sortant :

```bash
curl -X POST https://api.voicelogica.ai/api/v1/phones/calls/initiate-call \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationNumber": "+302101234567",
    "agentId": "your-agent-id",
    "voipPhoneId": "your-voip-phone-id"
  }'
```

`destinationNumber` est requis ; passez `agentId` pour les appels IA sortants, et soit `voipPhoneId` soit `sipTrunkId` pour choisir la ligne sur laquelle l'appel sort. La référence interactive complète pour chaque endpoint se trouve sur [api.voicelogica.ai/api-docs](https://api.voicelogica.ai/api-docs).

> **Note:** Les appels sortants respectent par défaut les règles d'appel du pays de destination - par exemple pas d'appels entre 21:00-09:00 heure locale. L'API expose des indicateurs de contournement explicites si votre cas d'utilisation l'exige ; les appels entrants ne sont jamais restreints.
## Dépannage

**Mes requêtes retournent 401 Unauthorized**

- Confirmez que la clé est envoyée dans l'en-tête `x-api-key` - pas comme un token `Bearer`.
- Vérifiez que la clé n'a pas été révoquée dans le tableau API Keys.
- Si la clé a une restriction IP, vérifiez que la requête provient de cette adresse exacte.

**Mes requêtes retournent 403 Forbidden**

- Les restrictions d'opération de la clé n'incluent pas l'endpoint que vous appelez - modifiez la clé et activez le groupe d'opérations concerné.

## Prochaines étapes

> **Développez sur l'API:** Explorez la [référence API interactive](https://api.voicelogica.ai/api-docs), puis automatisez avec [Workflow Triggers](https://docs.voicelogica.ai/workflows/) - ou connectez un client MCP comme ChatGPT ou Claude à votre espace de travail en utilisant la même clé.
## Besoin d'aide ?

Si vous rencontrez des problèmes, l'équipe de support Voice Logica est disponible :

- EMAIL [support@voicelogica.ai](mailto:support@voicelogica.ai)
- DÉVELOPPEURS [developers@voicelogica.ai](mailto:developers@voicelogica.ai)
- RÉFÉRENCE API [api.voicelogica.ai/api-docs](https://api.voicelogica.ai/api-docs)