> 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. # Copper Votre réceptionniste peut reconnaître les appelants déjà présents dans Copper, ajouter les nouveaux appelants comme prospects, noter les demandes de chaque appelant et créer une tâche de suivi pour votre équipe. La recherche d'appelants et la création de tâches utilisent des [outils webhook](/docs/fr/reception-ai/integrations/webhooks). L'ajout de prospects et de notes passe par [Zapier](/docs/fr/reception-ai/integrations/zapier), car Copper stocke les numéros de téléphone et les liens vers les notes sous forme de données imbriquées que les outils webhook ne peuvent pas envoyer. ## Avant de commencer Dans Copper, ouvrez **Paramètres système** → **Clés API**, puis sélectionnez **Générer une clé API**. Attribuez-lui un libellé, par exemple `Reception.ai`. La clé agit en votre nom, elle peut donc voir et modifier tout ce que vous pouvez voir et modifier. Chaque outil webhook ci-dessous envoie ces en-têtes de requête : | En-tête | Valeur | | ------------------ | -------------------------------------------------- | | `X-PW-AccessToken` | votre clé API | | `X-PW-Application` | `developer_api` | | `X-PW-UserEmail` | l'adresse email de l'utilisateur qui a créé la clé | > **Warning** > > Toute personne disposant de la clé API et de votre adresse email peut lire et modifier vos données Copper. Ne conservez pas la clé > dans des documents partagés et supprimez-la dans Copper si elle est compromise. ## Créer les outils webhook Pour chaque outil, accédez à **Intégrations**, sélectionnez **Ajouter une intégration**, choisissez **Outil webhook**, puis définissez **Attribuer aux agents** sur **Réceptionniste**. Les points de terminaison de recherche de Copper utilisent POST, avec la recherche dans le corps de la requête. ### Rechercher un contact | Champ | Valeur | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nom** | `find_copper_person` | | **Description** | "Recherchez l'appelant parmi nos contacts à partir de son numéro de téléphone. Utilisez cet outil au début d'un appel pour vérifier s'il s'agit d'un client." | | **Méthode** | POST | | **URL** | `https://api.copper.com/developer_api/v1/people/search` | | **En-têtes de requête** | Les en-têtes de [Avant de commencer](#before-you-start) | | **Paramètres du corps** | `phone_number` (chaîne, obligatoire) : "Le numéro de téléphone de l'appelant." | ### Rechercher un prospect | Champ | Valeur | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | **Nom** | `find_copper_lead` | | **Description** | "Recherchez l'appelant parmi nos prospects à partir de son numéro de téléphone. Utilisez cet outil lorsque l'appelant n'est pas un contact." | | **Méthode** | POST | | **URL** | `https://api.copper.com/developer_api/v1/leads/search` | | **En-têtes de requête** | Les en-têtes de [Avant de commencer](#before-you-start) | | **Paramètres du corps** | `phone_number` (chaîne, obligatoire) : "Le numéro de téléphone de l'appelant." | ### Créer une tâche de suivi | Champ | Valeur | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nom** | `create_copper_task` | | **Description** | "Créez une tâche pour l'équipe chaque fois que vous promettez à l'appelant de le rappeler." | | **Méthode** | POST | | **URL** | `https://api.copper.com/developer_api/v1/tasks` | | **En-têtes de requête** | Les en-têtes de [Avant de commencer](#before-you-start) | | **Paramètres du corps** | `name` (chaîne, obligatoire) : "Par exemple : Rappeler Jane Doe au sujet d'un devis pour une cuisine." `details` (chaîne, obligatoire) : "Le nom, le numéro de téléphone et les besoins de l'appelant." | Sélectionnez **Activer** pour chaque outil. ## Ajouter des prospects et des notes ### Connecter Zapier Si ce n'est pas encore fait, connectez [Zapier](/docs/fr/reception-ai/integrations/zapier) dans Reception.ai. ### Ajouter les actions Copper Dans votre serveur MCP Zapier sur [mcp.zapier.com](https://mcp.zapier.com), connectez votre compte Copper et ajoutez les actions suivantes : * **Créer un prospect** : définissez le propriétaire et la source du prospect comme valeurs fixes, puis laissez l'IA renseigner le nom, le numéro de téléphone, l'adresse email et la demande de l'appelant. * **Créer une activité** : définissez le type d'activité sur note, puis laissez l'IA renseigner la personne ou le prospect trouvé par les outils de recherche ainsi que la demande de l'appelant. ### Attribuer les outils Dans Reception.ai, ouvrez l'onglet **Outils** de l'intégration Zapier, sélectionnez **Actualiser les outils**, puis attribuez les deux actions Copper au **Client** (réceptionniste). ### Tester [Testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) avec un appel provenant d'un numéro enregistré pour un contact Copper, puis d'un nouveau numéro demandant à être rappelé. Le nouvel appelant apparaît comme prospect et la tâche apparaît dans Copper. > **Tip** > > Ajoutez une [procédure](/docs/fr/reception-ai/receptionist/rules-and-procedures) afin que votre réceptionniste > recherche d'abord les contacts et les prospects, et ne crée un prospect lorsqu'aucune des deux recherches ne trouve l'appelant. ## Limites * Les outils webhook envoient des valeurs simples, tandis que Copper lie une tâche à une personne ou à un prospect avec une valeur imbriquée. Les tâches créées avec `create_copper_task` ne sont donc pas liées au dossier de l'appelant ; les détails de la tâche conservent à la place le nom et le numéro de l'appelant. * Copper utilise des horodatages Unix pour les dates d'échéance, que l'IA ne peut pas déterminer de manière fiable. `create_copper_task` laisse donc la date d'échéance vide. * Pour lier des tâches à l'appelant ou définir une date d'échéance, utilisez plutôt l'action **Créer une tâche** de Copper via Zapier que l'outil webhook. * Chaque action Zapier exécutée par votre réceptionniste consomme des tâches de votre forfait Zapier. Lorsque le forfait est épuisé, les actions s'arrêtent jusqu'à sa réinitialisation. ## Résolution des problèmes | Problème | À vérifier | | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Erreur 401 ou 403 de Copper | Vérifiez les trois en-têtes. `X-PW-UserEmail` doit correspondre à l'email de l'utilisateur qui a généré la clé. | | Les appelants connus ne sont pas trouvés | Copper associe les numéros de téléphone tels qu'ils sont enregistrés. Enregistrez les numéros dans un format unique et vérifiez que l'appelant est une personne ou un prospect, et non une entreprise. | | Le réceptionniste crée des prospects en double | Indiquez dans la description des outils de recherche de créer un prospect uniquement lorsque l'appelant n'a pas été trouvé. | | Une action Copper n'apparaît pas | Sélectionnez **Actualiser les outils** dans l'intégration Zapier après avoir ajouté des actions dans Zapier. | | Une action affiche **Modifiée** et n'est pas utilisée | Vous l'avez modifiée dans Zapier. Sélectionnez **Mettre à jour** dans l'onglet **Outils**. |