Clés API

Les clés API sont optionnelles. Terminez d’abord l’inscription, l’abonnement et votre premier 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.

   

   api-keys-0Expand

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.

   

   api-keys-1Expand

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.

   

   api-keys-2Expand

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.

   

   api-keys-3Expand

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.

api-keys-4Expand

• 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 :

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.

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, puis automatisez avec Workflow Triggers - 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

DÉVELOPPEURS

developers@voicelogica.ai

RÉFÉRENCE API

api.voicelogica.ai/api-docs