> 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. # Nutshell Votre réceptionniste peut reconnaître les appelants déjà présents dans Nutshell et ajouter les nouveaux appelants comme personnes avec un prospect afin que votre équipe puisse assurer le suivi. La recherche d'appelants utilise un [outil webhook](/docs/fr/reception-ai/integrations/webhooks). L'ajout de personnes et de prospects passe par [Zapier](/docs/fr/reception-ai/integrations/zapier), car l'API de Nutshell nécessite des listes et des valeurs imbriquées pour créer des enregistrements, ce que les outils webhook ne peuvent pas envoyer. ## Rechercher des appelants ### Créer une clé API Dans Nutshell, sélectionnez **Settings** dans l'angle inférieur gauche, puis **API keys** sous **Connections**. Sélectionnez **Add API key** et choisissez **API + user impersonation**, dont Zapier a également besoin. Copiez la clé. ### Créer l'en-tête d'autorisation L'API de Nutshell utilise votre adresse email Nutshell comme nom d'utilisateur et la clé API comme mot de passe. Encodez-les dans un terminal, en remplaçant les deux valeurs et en conservant les deux-points entre elles : ```bash printf 'YOUR_EMAIL:YOUR_API_KEY' | base64 ``` La valeur de l'en-tête est `Basic ` suivi du résultat. > **Warning** > > Ne collez pas votre clé API dans un encodeur en ligne. Toute personne disposant de la clé ou de l'en-tête encodé peut > lire et modifier vos données Nutshell. ### Créer l'outil webhook Accédez à **Integrations**, sélectionnez **Add integration**, puis choisissez **Webhook Tool**. | Champ | Valeur | | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nom** | `find_nutshell_person` | | **Description** | "Recherchez l'appelant dans notre CRM à l'aide de son numéro de téléphone, de son nom ou de son email. Utilisez cet outil au début d'un appel pour vérifier s'il s'agit d'un client existant." | | **Méthode** | GET | | **URL** | `https://app.nutshell.com/rest/contacts` | | **En-têtes de requête** | `Authorization`: `Basic ` suivi de la valeur encodée | | **Paramètres de requête** | `q` (chaîne, obligatoire) : "Le numéro de téléphone, le nom complet ou l'adresse email de l'appelant." | | **Attribuer aux agents** | **Receptionist** | Sélectionnez **Enable**. ## Ajouter des personnes et des prospects ### Connecter Zapier Si ce n'est pas encore fait, connectez [Zapier](/docs/fr/reception-ai/integrations/zapier) dans Reception.ai. ### Ajouter les actions Nutshell Dans votre serveur MCP Zapier sur [mcp.zapier.com](https://mcp.zapier.com), connectez votre compte Nutshell avec la clé API et ajoutez ces actions : * **Create Person** : laissez l'IA renseigner le nom, le numéro de téléphone et l'adresse email de l'appelant. * **Create Lead** : définissez la source, le pipeline et la personne assignée comme valeurs fixes, puis laissez l'IA renseigner une description des besoins de l'appelant et de la personne concernée. > **Tip** > > Pour enregistrer l'appel dans la chronologie de la personne, ajoutez également **Log Activity** et laissez l'IA renseigner un > bref résumé. ### Attribuer les outils Dans Reception.ai, ouvrez l'onglet **Tools** de l'intégration Zapier, sélectionnez **Refresh tools**, puis attribuez les actions Nutshell 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 une personne dans Nutshell, puis en vous faisant passer pour un nouvel appelant souhaitant un devis. La nouvelle personne et son prospect apparaissent dans Nutshell. ## Limites * L'application Nutshell de Zapier ne propose aucune action pour créer une tâche de suivi. La personne assignée au prospect voit à la place les nouveaux prospects dans Nutshell. * L'application Nutshell de Zapier ne peut vérifier la disponibilité de personne, votre réceptionniste ne peut donc pas planifier de réunions dans Nutshell. Utilisez la prise de rendez-vous propre à Reception avec [Google Calendar](/docs/fr/reception-ai/integrations/google-calendar). * Chaque action Zapier exécutée par votre réceptionniste consomme des tâches de votre forfait Zapier. Zapier compte actuellement deux tâches par appel réussi, les appels échoués ne sont pas comptabilisés. Lorsque le forfait est épuisé, les actions s'arrêtent jusqu'à sa réinitialisation. ## Résolution des problèmes | Problème | Vérification à effectuer | | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | 401 de Nutshell | Encodez votre adresse email Nutshell, deux-points et la clé, puis commencez la valeur de l'en-tête par `Basic `. | | Les appelants connus ne sont pas trouvés | Essayez un appel de test depuis un numéro enregistré pour une personne dans Nutshell, ou demandez plutôt son nom à l'appelant. | | La réceptionniste crée des personnes en double | Indiquez dans la description de l'outil de recherche qu'elle ne doit ajouter une personne que si l'appelant n'a pas été trouvé. | | Une action Nutshell n'apparaît pas dans Reception.ai | Sélectionnez **Refresh tools** sur l'intégration Zapier après avoir ajouté les actions dans Zapier. | | Zapier ne peut pas se connecter à Nutshell | Utilisez une clé API avec **API + user impersonation**. |