> 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

Twoja recepcjonistka może rozpoznawać rozmówców, którzy są już w Nutshell, oraz dodawać nowych rozmówców jako osoby z leadem do kontaktu przez twój zespół. Wyszukiwanie rozmówców korzysta z [narzędzia webhook](/docs/pl/reception-ai/integrations/webhooks). Dodawanie osób i leadów odbywa się przez [Zapier](/docs/pl/reception-ai/integrations/zapier), ponieważ API Nutshell wymaga list i zagnieżdżonych wartości do tworzenia rekordów, których narzędzia webhook nie mogą wysyłać.

## Wyszukaj rozmówców

### Utwórz klucz API

W Nutshell wybierz **Settings** w lewym dolnym rogu, a następnie **API keys** w sekcji **Connections**. Wybierz **Add API key** i opcję **API + user impersonation**, której potrzebuje też Zapier. Skopiuj klucz.

### Utwórz nagłówek autoryzacji

API Nutshell używa adresu e-mail Nutshell jako nazwy użytkownika, a klucza API jako hasła. Zakoduj je w terminalu, zastępując obie wartości i zachowując dwukropek między nimi:

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

Wartość nagłówka to `Basic `, po którym następuje wynik.

> **Warning**
>
> Nie wklejaj klucza API do internetowego kodera. Każdy, kto ma klucz lub zakodowany nagłówek, może
> odczytywać i zmieniać dane Nutshell.

### Utwórz narzędzie webhook

Przejdź do **Integrations**, wybierz **Add integration**, a potem **Webhook Tool**.

| Pole                    | Wartość                                                                                                                                            |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nazwa**               | `find_nutshell_person`                                                                                                                             |
| **Opis**                | "Znajdź rozmówcę w naszym CRM po numerze telefonu, imieniu i nazwisku lub e-mailu. Użyj na początku rozmowy, aby sprawdzić, czy to obecny klient." |
| **Metoda**              | GET                                                                                                                                                |
| **URL**                 | `https://app.nutshell.com/rest/contacts`                                                                                                           |
| **Nagłówki żądania**    | `Authorization`: `Basic `, po którym następuje zakodowana wartość                                                                                  |
| **Parametry zapytania** | `q` (ciąg znaków, wymagane): "Numer telefonu, imię i nazwisko lub adres e-mail rozmówcy."                                                          |
| **Przypisz do agentów** | **Receptionist**                                                                                                                                   |

Wybierz **Enable**.

## Dodaj osoby i leady

### Połącz Zapier

Jeśli jeszcze tego nie zrobiłeś, połącz [Zapier](/docs/pl/reception-ai/integrations/zapier) w Reception.ai.

### Dodaj działania Nutshell

Na serwerze Zapier MCP pod adresem [mcp.zapier.com](https://mcp.zapier.com) połącz konto Nutshell za pomocą klucza API i dodaj te działania:

* **Create Person**: pozwól AI uzupełnić imię i nazwisko, numer telefonu oraz adres e-mail rozmówcy.
* **Create Lead**: ustaw źródło, pipeline i osobę przypisaną jako stałe wartości, a AI niech uzupełni opis potrzeb rozmówcy oraz osoby, której dotyczą.

> **Tip**
>
> Aby zapisać rozmowę na osi czasu osoby, dodaj też **Log Activity** i pozwól AI uzupełnić
> krótkie podsumowanie.

### Przypisz narzędzia

W Reception.ai otwórz kartę **Tools** integracji Zapier, wybierz **Refresh tools** i przypisz działania Nutshell do **Client** (recepcjonistki).

### Przetestuj

[Przetestuj recepcjonistkę](/docs/pl/reception-ai/receptionist/testing) rozmową z numeru zapisanego przy osobie w Nutshell, a potem jako nowy rozmówca, który chce wycenę. Nowa osoba i jej lead pojawią się w Nutshell.

## Ograniczenia

* Aplikacja Nutshell w Zapier nie ma działania do tworzenia zadań follow-up. Osoba przypisana do leada zobaczy nowe leady w Nutshell.
* Aplikacja Nutshell w Zapier nie może sprawdzać niczyjej dostępności, więc recepcjonistka nie może rezerwować spotkań w Nutshell. Skorzystaj z własnej rezerwacji Reception przez [Kalendarz Google](/docs/pl/reception-ai/integrations/google-calendar).
* Każde działanie Zapier uruchomione przez recepcjonistkę wykorzystuje zadania z twojego planu Zapier. Zapier obecnie nalicza dwa zadania za każdą udaną rozmowę; nieudane rozmowy nie są liczone. Gdy plan się wyczerpie, działania zatrzymają się do jego odnowienia.

## Rozwiązywanie problemów

| Problem                                           | Co sprawdzić                                                                                               |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| 401 z Nutshell                                    | Zakoduj adres e-mail Nutshell, dwukropek i klucz, a wartość nagłówka zacznij od `Basic `.                  |
| Nie znaleziono znanych rozmówców                  | Spróbuj rozmowy testowej z numeru zapisanego przy osobie w Nutshell lub poproś rozmówcę o imię i nazwisko. |
| Recepcjonistka tworzy zduplikowane osoby          | W opisie narzędzia wyszukiwania poleć jej dodawać osobę tylko wtedy, gdy rozmówcy nie znaleziono.          |
| Działanie Nutshell nie pojawia się w Reception.ai | Po dodaniu działań w Zapier wybierz **Refresh tools** w integracji Zapier.                                 |
| Zapier nie może połączyć się z Nutshell           | Użyj klucza API z **API + user impersonation**.                                                            |