> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

### ElevenAgents

- **Remplacements de branche et d'environnement WhatsApp** : les [messages WhatsApp sortants](/docs/fr/api-reference/whats-app/outbound-message) et les [appels sortants](/docs/fr/api-reference/whats-app/outbound-call) respectent désormais `branch_id` et `environment` transmis dans `conversation_initiation_client_data`. Les remplacements sont validés avant tout envoi, une branche ou un environnement inconnu est rejeté avec une erreur, et ils persistent pour la conversation. Ainsi, la réponse d'un client reprend sur la [branche](/docs/fr/eleven-agents/operate/versioning) et l'[environnement](/docs/fr/eleven-agents/integrate/environment-variables) demandés. Consultez le [guide WhatsApp](/docs/fr/eleven-agents/whatsapp) pour des exemples.
- **API de procédures** : ajout de huit opérations publiques limitées à une branche pour gérer les [procédures](/docs/fr/eleven-agents/customization/procedures). Vous pouvez créer, lister, récupérer et supprimer des procédures, créer, récupérer ou abandonner des modifications de brouillon, et compiler des brouillons de procédure dans un workflow d'agent. La création d'une procédure accepte `name`, `content`, `type` et `trigger`. Un `trigger` vide crée une sous-procédure, tandis qu'un déclencheur omis ou défini sur `null` est déduit du contenu de la procédure.
- **Tâches de crawl de la base de connaissances** : ajout d'API pour créer, lister, inspecter et annuler des tâches de crawl. Les requêtes de création nécessitent `url` (chaîne) et prennent en charge la profondeur de crawl, les limites de pages, les modèles d'URL, les URL de sitemap, le placement dans des dossiers, la synchronisation automatique et la suppression des documents indisponibles.
- **Gestion groupée de la base de connaissances** : ajout de [vérifications groupées des dépendances](/docs/fr/api-reference/knowledge-base/dependent-agents-multiple) et de [suppression groupée](/docs/fr/api-reference/knowledge-base/bulk-delete) pour 1 à 20 ID uniques de documents ou de dossiers. Les vérifications de dépendances prennent en charge la pagination et `dependent_type` ; la suppression renvoie une réussite ou un échec indépendant pour chaque ID. Définir `force: true` supprime également les dépendances et efface récursivement les dossiers non vides.
- **Export des résultats d'appels par lot** : ajout d'[Exporter les résultats d'appels par lot](/docs/fr/api-reference/batch-calling/export) pour télécharger au format CSV les destinataires et les résultats de conversation d'un lot terminé.
- **Filtres de conversation et données d'analyse** : [Lister les conversations](/docs/fr/api-reference/conversations/list) et [Rechercher du texte dans les messages de conversation](/docs/fr/api-reference/conversations/messages/text-search) ajoutent les filtres de tableau facultatifs `visited_agent_ids` et `visited_agent_branch_ids`, limités chacun à 50 valeurs. Les requêtes de liste acceptent également `data_collection_ids` et `evaluation_criteria_ids` pour inclure les résultats correspondants dans chaque résumé de conversation. Les résumés ajoutent `data_collection_results`, `evaluation_criteria_results` et `tag_ids` facultatifs.
- **Configuration d'analyse référencée** : les paramètres de plateforme d'agent ajoutent le champ facultatif et nullable `analysis_items`, typé comme `AgentAnalysisItems`, pour associer par référence des éléments d'évaluation et de collecte de données. Une valeur `null` indique que l'agent utilise encore les champs intégrés hérités ; une valeur vide indique un agent migré sans éléments associés.
- **Métadonnées de dépendance des procédures** : les références de procédure ajoutent `trigger` (chaîne) et des tableaux pour `referenced_tool_ids`, `referenced_kb_ids`, `referenced_procedure_ids` et `referenced_dynamic_variables`.
- **Réponse de jeton WebRTC** : les réponses de [Obtenir un jeton WebRTC](/docs/fr/api-reference/conversations/get-webrtc-token) nécessitent désormais `conversation_id` (chaîne) en plus de `token`. Il s'agit d'une modification de schéma incompatible pour les clients qui valident ou désérialisent la structure de réponse.
- **Résultats RAG de la base de connaissances** : `KnowledgeBaseRagToolResultModel` ajoute `chunks` (`KnowledgeBaseRagChunkModel[]`) pour le mode résultat RAG dans le résultat d'outil.

### Studio

- **Statut de projet brouillon** : `ProjectCreationMetaResponseModel.status` ajoute `draft`. Le type de création de projet utilise désormais l'énumération partagée `ProjectCreationMetaType` avec les mêmes valeurs existantes.

### Voix

- **Accents de voix** : ajout de `GET /v1/voices/accents` pour lister les accents disponibles dans la bibliothèque de voix partagées. Les résultats peuvent être filtrés par `language` et `model_id`, et chaque accent renvoie son `accent`, sa `language`, son `code` et son `name` lisible par l'humain. La valeur `accent` peut être transmise au paramètre de requête `accent` de [Obtenir les voix partagées](/docs/fr/api-reference/voices/voice-library/get-shared) pour filtrer les voix partagées.

### Workspaces

- **Rapports d'utilisation des webhooks** : `WebhookUsageType` ajoute `Flows`.

### Versions des SDK

#### SDK JavaScript

- [v2.60.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.60.0) - Ajout de `voices.accents.get` pour lister les accents de voix dans la bibliothèque de voix partagées, ainsi que des API de procédures ElevenAgents, de tâches de crawl de la base de connaissances, de gestion groupée et de configuration d'analyse référencée du dernier schéma.

#### SDK Python

- [v2.60.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.60.0) - Ajout des API d'accents de voix, de procédures ElevenAgents, de tâches de crawl de la base de connaissances et de gestion groupée du dernier schéma. Correction également du démarrage de `AsyncConversation`, qui ne bloque plus, et des champs multipart de listes de primitives, désormais envoyés comme champs de formulaire répétés.

#### Packages

- [@elevenlabs/client@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.2) - Correction de `onAudioAlignment` sur les transports WebRTC en transmettant les métadonnées d'alignement des messages audio tout en conservant la lecture audio sur la piste LiveKit.
- [@elevenlabs/react@1.10.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.2), [@elevenlabs/react-native@1.2.16](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.16), [@elevenlabs/convai-widget-core@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.12) et [@elevenlabs/convai-widget-embed@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.12) - Mise à jour des dépendances pour inclure la correction d'alignement WebRTC de `@elevenlabs/client@1.15.2`.

### API

<Accordion title="Afficher les modifications de l'API">

## Nouveaux endpoints

### ElevenAgents

- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
  - Crée une procédure et renvoie son `procedure_id` (chaîne)
  - Accepte `name` facultatif (chaîne, 200 caractères maximum), `content` (chaîne), `type` (`ProcedureType`, `free_form` par défaut) et `trigger` (chaîne nullable)
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
  - Liste les procédures de la branche avec `procedure_id`, `version_id`, `name`, `type`, `trigger` et `has_draft`
  - Exclut le contenu des procédures ; récupérez une procédure individuelle pour lire son contenu
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
  - Accepte `version_id` facultatif (chaîne) ; sinon, renvoie la version à la tête de la branche
  - Renvoie `name`, `content`, `type` et `trigger`
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
  - Supprime la procédure de l'ensemble de travail brouillon de la branche
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - Renvoie le brouillon actuel de la procédure
- `PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - Crée ou met à jour un brouillon
  - Nécessite `name` (chaîne, 200 caractères maximum), `content` (chaîne, 50 000 caractères maximum) et `type` (`ProcedureType`) ; accepte `trigger` facultatif (chaîne nullable)
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - Abandonne les modifications du brouillon et réinitialise la procédure à sa version validée
- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile`
  - Compile les brouillons de procédure dans un `AgentWorkflowResponseModel`
- [Créer une tâche de crawl](/docs/fr/api-reference/knowledge-base/create-crawl-job) - `POST /v1/convai/knowledge-base/crawl`
  - Nécessite `url` (chaîne)
  - Accepte `max_depth` facultatif (entier, 1 à 5, `3` par défaut), `max_pages` (entier, 1 à 10 000, `1000` par défaut), `pattern` (chaîne), `sitemap_urls` (tableau de chaînes), `parent_folder_id` (chaîne), `enable_auto_sync` (booléen, `false` par défaut) et `auto_remove` (booléen, `false` par défaut)
- [Lister les tâches de crawl](/docs/fr/api-reference/knowledge-base/list-crawl-jobs) - `GET /v1/convai/knowledge-base/crawl`
  - Accepte `include_job_ids` facultatif (tableau de chaînes), `page_size` (entier, 1 à 100, `30` par défaut) et `cursor` (chaîne)
- [Obtenir une tâche de crawl](/docs/fr/api-reference/knowledge-base/get-crawl-job) - `GET /v1/convai/knowledge-base/crawl/{crawl_job_id}`
- [Annuler une tâche de crawl](/docs/fr/api-reference/knowledge-base/cancel-crawl-job) - `POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel`
- [Obtenir les agents dépendants pour plusieurs documents](/docs/fr/api-reference/knowledge-base/dependent-agents-multiple) - `POST /v1/convai/knowledge-base/dependent-agents`
  - Nécessite `document_ids` (tableau de 1 à 20 chaînes uniques)
  - Accepte `dependent_type` facultatif (`KnowledgeBaseDependentType`, `all` par défaut), `page_size` (entier, 1 à 100, `30` par défaut) et `cursor` (chaîne)
- [Supprimer en masse des documents de la base de connaissances](/docs/fr/api-reference/knowledge-base/bulk-delete) - `POST /v1/convai/knowledge-base/bulk-delete`
  - Nécessite `document_ids` (tableau de 1 à 20 chaînes uniques)
  - Accepte `force` facultatif (booléen, `false` par défaut)
  - Renvoie un résultat de réussite ou d'échec pour chaque ID de document
- [Exporter les résultats d'appels par lot](/docs/fr/api-reference/batch-calling/export) - `GET /v1/convai/batch-calling/{batch_id}/export`
  - Renvoie les destinataires et les résultats de conversation d'un lot terminé au format CSV

### Voix

- `GET /v1/voices/accents`
  - Liste les accents disponibles dans la bibliothèque de voix partagées
  - Accepte les paramètres de requête facultatifs `language` (chaîne) et `model_id` (chaîne)
  - Chaque accent renvoie `accent`, `language`, `code` et `name`

## Endpoints mis à jour

### ElevenAgents

- [Lister les conversations](/docs/fr/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - Ajout des filtres facultatifs de tableaux de chaînes `visited_agent_ids` et `visited_agent_branch_ids`, limités chacun à 50 valeurs
  - Ajout des tableaux de chaînes facultatifs `data_collection_ids` et `evaluation_criteria_ids` pour sélectionner les résultats d'analyse de chaque résumé
  - Les résumés de réponse ajoutent les champs d'objet facultatifs `data_collection_results` et `evaluation_criteria_results`, ainsi que le tableau de chaînes `tag_ids`
- [Rechercher du texte dans les messages de conversation](/docs/fr/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - Ajout des filtres facultatifs de tableaux de chaînes `visited_agent_ids` et `visited_agent_branch_ids`, limités chacun à 50 valeurs
- [Obtenir un jeton WebRTC](/docs/fr/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
  - Les réponses nécessitent désormais `conversation_id` (chaîne)
  - Incompatible : les validateurs et désérialiseurs de réponse stricts doivent accepter le nouveau champ requis

## Modifications de schéma

### ElevenAgents

- Les paramètres de requête et de réponse de la plateforme d'agent ajoutent le champ facultatif et nullable `analysis_items`, typé comme `AgentAnalysisItems`, pour une configuration d'évaluation et de collecte de données référencée
- Les références de procédure ajoutent `trigger` (chaîne), `referenced_tool_ids` (tableau de chaînes), `referenced_kb_ids` (tableau de chaînes), `referenced_procedure_ids` (tableau de chaînes) et `referenced_dynamic_variables` (tableau de chaînes)
- `KnowledgeBaseRagToolResultModel` ajoute `chunks` (`KnowledgeBaseRagChunkModel[]`)

### Studio

- `ProjectCreationMetaResponseModel.status` ajoute `draft`
- `ProjectCreationMetaResponseModel.type` référence désormais l'énumération partagée `ProjectCreationMetaType`

### Workspaces

- `WebhookUsageType` ajoute `Flows`

</Accordion>