> 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

Je receptionist kan bellers herkennen die al in Nutshell staan en nieuwe bellers toevoegen als personen met een lead, zodat je team kan opvolgen. Voor het opzoeken van bellers wordt een [webhooktool](/docs/nl/reception-ai/integrations/webhooks) gebruikt. Personen en leads toevoegen gaat via [Zapier](/docs/nl/reception-ai/integrations/zapier), omdat de API van Nutshell lijsten en geneste waarden nodig heeft om records te maken, die webhooktools niet kunnen versturen.

## Bellers opzoeken

### Een API-sleutel maken

Selecteer in Nutshell linksonder **Settings** en vervolgens **API keys** onder **Connections**. Selecteer **Add API key** en kies **API + user impersonation**, dat Zapier ook nodig heeft. Kopieer de sleutel.

### De autorisatieheader maken

De API van Nutshell gebruikt je e-mailadres van Nutshell als gebruikersnaam en de API-sleutel als wachtwoord. Codeer ze in een terminal, vervang beide waarden en behoud de dubbele punt ertussen:

```bash
printf 'YOUR_EMAIL:YOUR_API_KEY' | base64
```

De headerwaarde is `Basic ` gevolgd door de uitvoer.

> **Warning**
>
> Plak je API-sleutel niet in een online encoder. Iedereen met de sleutel of de gecodeerde header kan
> je Nutshell-gegevens lezen en wijzigen.

### De webhooktool maken

Ga naar **Integrations**, selecteer **Add integration** en kies **Webhook Tool**.

| Veld                     | Waarde                                                                                                                                                   |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Naam**                 | `find_nutshell_person`                                                                                                                                   |
| **Beschrijving**         | "Zoek de beller in onze CRM op telefoonnummer, naam of e-mailadres. Gebruik dit aan het begin van een gesprek om te controleren of diegene al klant is." |
| **Methode**              | GET                                                                                                                                                      |
| **URL**                  | `https://app.nutshell.com/rest/contacts`                                                                                                                 |
| **Requestheaders**       | `Authorization`: `Basic ` gevolgd door de gecodeerde waarde                                                                                              |
| **Queryparameters**      | `q` (string, verplicht): "Het telefoonnummer, de volledige naam of het e-mailadres van de beller."                                                       |
| **Toewijzen aan agents** | **Receptionist**                                                                                                                                         |

Selecteer **Enable**.

## Personen en leads toevoegen

### Zapier koppelen

Koppel [Zapier](/docs/nl/reception-ai/integrations/zapier) in Reception.ai als je dat nog niet hebt gedaan.

### De Nutshell-acties toevoegen

Koppel in je Zapier MCP-server op [mcp.zapier.com](https://mcp.zapier.com) je Nutshell-account met de API-sleutel en voeg deze acties toe:

* **Create Person**: laat de AI de naam, het telefoonnummer en het e-mailadres van de beller invullen.
* **Create Lead**: stel de bron, pipeline en toegewezene in als vaste waarden en laat de AI een beschrijving invullen van wat de beller wil en voor welke persoon dit is.

> **Tip**
>
> Voeg ook **Log Activity** toe en laat de AI een korte samenvatting invullen om het gesprek op de tijdlijn van de persoon vast te leggen.

### De tools toewijzen

Open in Reception.ai het tabblad **Tools** van de Zapier-integratie, selecteer **Refresh tools** en wijs de Nutshell-acties toe aan de **Client** (receptionist).

### Testen

[Test je receptionist](/docs/nl/reception-ai/receptionist/testing) met een gesprek vanaf een nummer dat is opgeslagen bij een persoon in Nutshell, en vervolgens als een nieuwe beller die een offerte wil. De nieuwe persoon en bijbehorende lead verschijnen in Nutshell.

## Beperkingen

* De Nutshell-app van Zapier heeft geen actie om een opvolgtaak te maken. De toegewezene van de lead ziet in plaats daarvan nieuwe leads in Nutshell.
* De Nutshell-app van Zapier kan niemands beschikbaarheid controleren, dus je receptionist kan geen afspraken in Nutshell plannen. Gebruik de eigen boekingsfunctie van Reception met [Google Calendar](/docs/nl/reception-ai/integrations/google-calendar).
* Elke Zapier-actie die je receptionist uitvoert, gebruikt taken uit je Zapier-abonnement. Zapier telt momenteel twee taken per geslaagd gesprek; mislukte gesprekken tellen niet mee. Wanneer het abonnement op is, stoppen de acties totdat het wordt vernieuwd.

## Problemen oplossen

| Probleem                                           | Wat je moet controleren                                                                                                                    |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| 401 van Nutshell                                   | Codeer je e-mailadres van Nutshell, een dubbele punt en de sleutel, en begin de headerwaarde met `Basic `.                                 |
| Bekende bellers worden niet gevonden               | Probeer een testgesprek vanaf een nummer dat is opgeslagen bij een persoon in Nutshell, of vraag de beller in plaats daarvan naar de naam. |
| De receptionist maakt dubbele personen             | Vertel in de beschrijving van de opzoektool dat er alleen een persoon mag worden toegevoegd wanneer de beller niet is gevonden.            |
| Een Nutshell-actie verschijnt niet in Reception.ai | Selecteer **Refresh tools** in de Zapier-integratie nadat je acties in Zapier hebt toegevoegd.                                             |
| Zapier kan geen verbinding maken met Nutshell      | Gebruik een API-sleutel met **API + user impersonation**.                                                                                  |