Przejdź do nawigacji

Twenty

Rozpoznawaj dzwoniących i dodawaj nowe leady do Twenty CRM przez jego serwer MCP.

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 Twenty, który działa w Twenty Cloud i samodzielnie hostowanym Twenty. Możesz też utworzyć narzędzia webhook 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

1

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.

2

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.

3

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.

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.

4

Dodaj serwer MCP

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

PoleWartość
NazwaTwenty
Typ serweraStreamable HTTP
Adres URL serweraAdres twojego obszaru roboczego z dodanym /mcp, jak poniżej
Tajny tokenTwój klucz API
Gdzie działa TwentyAdres URL serwera
Twenty CloudAdres URL twojego obszaru roboczego, na przykład https://mycompany.twenty.com/mcp
Własny hostingPubliczny 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.

5

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.

6

Dodaj procedurę

Dodaj procedurę 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.

7

Przetestuj

Przetestuj recepcjonistę, 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

ProblemCo sprawdzić
Nie ma żadnych narzędziUż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ą znajdowaniZapisuj numery telefonów z kodem kraju i w jednym formacie.
Powód telefonu jest pustyPo dodaniu pola Call reason wybierz Odśwież narzędzia, a potem Aktualizuj przy zmienionym narzędziu.
Zmieniono kluczEdytuj integrację i użyj Obróć tajny token (opcjonalnie). Zapisany klucz nigdy więcej nie jest wyświetlany.