> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Twenty

Twój recepcjonista może rozpoznawać dzwoniących, którzy są już w Twenty, i dodawać nowych jako osoby wraz z imieniem, nazwiskiem, numerem telefonu i powodem telefonu, aby zespół sprzedaży mógł się z nimi skontaktować. Reception łączy się z wbudowanym [serwerem MCP](/docs/pl/reception-ai/integrations/mcp-server) Twenty, który działa w Twenty Cloud i samodzielnie hostowanym Twenty. Możesz też utworzyć [narzędzia webhook](/docs/pl/reception-ai/integrations/webhooks) dla REST API Twenty, ale serwer MCP wymaga mniej konfiguracji: daje recepcjoniście gotowe narzędzia do wyszukiwania i dodawania osób, już dopasowane do pól w twoim obszarze roboczym, w tym pola powodu telefonu opisanego poniżej.

## Konfiguracja

### Dodaj pole powodu telefonu

Osoby w Twenty nie mają własnego pola notatek. Aby zachować na ich karcie powód telefonu, przejdź do **Ustawienia** → **Model danych**, otwórz **Osoby** i dodaj pole **Tekst** o nazwie `Call reason`. Model danych mogą zmieniać tylko administratorzy obszaru roboczego.

### Utwórz rolę dla Reception.ai

Przejdź do **Ustawienia** → **Członkowie** → **Role** i utwórz rolę, która może tylko odczytywać i tworzyć Osoby. W następnym kroku przypiszesz do niej klucz API.

### Utwórz klucz API

Przejdź do **Ustawienia** → **Deweloperzy** → **API** i wybierz **+ Utwórz klucz**. Nadaj mu nazwę, na przykład `Reception.ai`, i od razu go skopiuj: Twenty pokazuje go tylko raz. Następnie otwórz utworzoną rolę, przejdź na kartę **Przypisanie** i przypisz do niej klucz.

> **Warning**
>
> Klucz API może odczytywać i zmieniać wszystko, na co pozwala jego rola. Nie umieszczaj go we wspólnych dokumentach
> i usuń go w Twenty, jeśli wycieknie.

### Dodaj serwer MCP

W Reception.ai przejdź do **Integracje**, wybierz **Dodaj integrację**, a następnie **Serwer MCP**.

| Pole                  | Wartość                                                       |
| --------------------- | ------------------------------------------------------------- |
| **Nazwa**             | Twenty                                                        |
| **Typ serwera**       | Streamable HTTP                                               |
| **Adres URL serwera** | Adres twojego obszaru roboczego z dodanym `/mcp`, jak poniżej |
| **Tajny token**       | Twój klucz API                                                |

| Gdzie działa Twenty | Adres URL serwera                                                                   |
| ------------------- | ----------------------------------------------------------------------------------- |
| Twenty Cloud        | Adres URL twojego obszaru roboczego, na przykład `https://mycompany.twenty.com/mcp` |
| Własny hosting      | Publiczny adres URL twojej instancji, na przykład `https://crm.example.com/mcp`     |

Dokładny adres możesz skopiować w Twenty z **Ustawienia** → **AI** → **MCP**. Nie dodawaj `?mode=meta` do adresu URL: ten tryb daje recepcjoniście jedno narzędzie, które może uruchomić dowolną akcję.

Wybierz **Włącz**. Reception.ai wysyła klucz jako token bearer i wyświetla narzędzia Twenty.

### Przypisz narzędzia

Twenty wyświetla narzędzie dla każdej akcji na każdym obiekcie. Otwórz kartę **Narzędzia** i przypisz do **Klienta** (recepcjonisty) tylko te narzędzia:

* `find_many_people`: wyszukuje dzwoniącego po numerze telefonu.
* `create_one_person`: dodaje nowego dzwoniącego wraz z imieniem, nazwiskiem, numerem telefonu i powodem telefonu.

Nie przypisuj narzędzi do aktualizacji i usuwania ani narzędzi dla innych obiektów.

### Dodaj procedurę

Dodaj [procedurę](/docs/pl/reception-ai/receptionist/rules-and-procedures) dla nowych leadów: najpierw wyszukaj dzwoniącego po numerze telefonu, utwórz osobę tylko wtedy, gdy nie znajdziesz dopasowania, i zawsze uzupełniaj imię, nazwisko, numer telefonu oraz powód telefonu. Dodaj zasadę, że recepcjonista nigdy nie odczytuje dzwoniącym danych z CRM.

### Przetestuj

[Przetestuj recepcjonistę](/docs/pl/reception-ai/receptionist/testing), dzwoniąc z numeru zapisanego przy osobie w Twenty, a następnie jako nowy dzwoniący, który chce wycenę. Nowa osoba pojawi się w **Osobach** z uzupełnionym powodem telefonu.

## Ograniczenia

* Twenty przechowuje krajowy kod telefoniczny oddzielnie od reszty numeru. Dzwoniący zapisani bez kodu kraju lub w innym formacie mogą nie zostać znalezieni, więc powracający dzwoniący może zostać dodany dwa razy.
* W tej konfiguracji recepcjonista nie tworzy notatek, zadań ani szans sprzedażowych. Twój zespół obsługuje nowe osoby z listy **Osoby**, na przykład w widoku filtrowanym według **Powodu telefonu**.
* Instancje hostowane samodzielnie wymagają wersji Twenty z serwerem MCP, a publiczny adres URL musi być dostępny z internetu przez HTTPS.
* API Twenty pozwala na 100 żądań na minutę. Zajęte obszary robocze z innymi integracjami mogą osiągnąć ten limit.

## Rozwiązywanie problemów

| Problem                           | Co sprawdzić                                                                                                                                                                   |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Nie ma żadnych narzędzi           | Użyj typu serwera **Streamable HTTP** i sprawdź, czy adres URL kończy się na `/mcp`. W przypadku własnego hostingu ustawienie `SERVER_URL` musi wskazywać publiczny adres URL. |
| Narzędzie zwraca błąd uprawnień   | Rola klucza nie może odczytywać ani tworzyć Osób. Edytuj rolę w **Ustawienia** → **Członkowie** → **Role**.                                                                    |
| Znani dzwoniący nie są znajdowani | Zapisuj numery telefonów z kodem kraju i w jednym formacie.                                                                                                                    |
| Powód telefonu jest pusty         | Po dodaniu pola `Call reason` wybierz **Odśwież narzędzia**, a potem **Aktualizuj** przy zmienionym narzędziu.                                                                 |
| Zmieniono klucz                   | Edytuj integrację i użyj **Obróć tajny token (opcjonalnie)**. Zapisany klucz nigdy więcej nie jest wyświetlany.                                                                |