> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Odoo Twoja recepcjonistka może sprawdzić, czy rozmówca jest już wśród kontaktów Odoo, i dodawać nowych rozmówców do CRM Odoo jako leady wraz z informacją, czego potrzebują, aby zespół sprzedaży mógł się z nimi skontaktować. Są dwa sposoby połączenia: * **[Narzędzia webhook](#option-1-webhook-tools-recommended)** wywołują bezpośrednio API JSON-2 Odoo, bez konta Zapier i bez zużywania zadań Zapier. Wymagają Odoo 19 lub nowszego, w wersji Community albo Enterprise, hostowanego na odoo.com, Odoo.sh lub własnym serwerze. * **[Zapier](#option-2-zapier)** działa też ze starszymi wersjami Odoo, ale każda akcja zużywa zadania z planu Zapier i nie może przeszukiwać bazy hostowanej na własnym serwerze. Użyj narzędzi webhook, jeśli twoja baza działa na Odoo 19 lub nowszym. Starsze API Odoo, JSON-RPC, przyjmuje argumenty każdej metody jako jedną mieszaną listę wartości, której narzędzia webhook nie potrafią utworzyć, więc w starszych wersjach użyj Zapier. > **Note** > > Odoo pozwala zewnętrznym aplikacjom na dostęp do danych tylko w planie **Custom**. Jeśli twoja baza jest > hostowana przez Odoo w planie One App Free lub Standard, sprawdź plan przed rozpoczęciem. ## Opcja 1: Narzędzia webhook (zalecane) ### Sprawdź wersję Odoo Wersję Odoo znajdziesz na dole strony **Ustawienia**. Narzędzia webhook wymagają wersji 19 lub nowszej. W przypadku bazy hostowanej na własnym serwerze serwer musi być dostępny z internetu przez HTTPS. ### Utwórz użytkownika dla Reception.ai W **Ustawienia** → **Użytkownicy i firmy** → **Użytkownicy** utwórz użytkownika wewnętrznego dla Reception.ai. Nadaj mu dostęp **Sprzedaż**: **Użytkownik: wszystkie dokumenty** i nie dawaj dostępu do innych aplikacji, aby klucz API mógł robić tylko to, czego potrzebują narzędzia. **Użytkownik: wszystkie dokumenty** pozwala przypisywać nowe leady wybranemu sprzedawcy. ### Utwórz klucz API Klucze API użytkowników, którzy nie są administratorami, są ważne maksymalnie trzy miesiące. Aby uzyskać klucz ważny rok: 1. Jako administrator włącz tryb deweloperski, a następnie przejdź do **Ustawienia** → **Użytkownicy i firmy** → **Grupy**. 2. Utwórz grupę o nazwie, na przykład, `Reception.ai API key`, ustaw **API Keys maximum duration days** na `365` i dodaj do niej użytkownika Reception.ai. Następnie zaloguj się jako użytkownik Reception.ai, otwórz **Preferencje** → **Bezpieczeństwo konta** i wybierz **Nowy klucz API**. Nazwij go, na przykład `Reception.ai`, wybierz najdłuższy dostępny okres ważności i od razu skopiuj klucz: Odoo wyświetla go tylko raz. Zanotuj datę wygaśnięcia i wymień klucz przed tym terminem. > **Warning** > > Klucz API może robić wszystko, co użytkownik Reception.ai. Nie umieszczaj go we współdzielonych dokumentach i > usuń go w Odoo, jeśli wycieknie. ### Znajdź identyfikatory sprzedawcy i zespołu sprzedaży Otwórz użytkownika sprzedawcy w **Ustawienia** → **Użytkownicy i firmy** → **Użytkownicy**. Liczba na końcu adresu strony to identyfikator użytkownika. Tak samo sprawdź zespół sprzedaży w **CRM** → **Konfiguracja** → **Zespoły sprzedaży**. ### Utwórz narzędzia webhook Dla każdego [narzędzia poniżej](#find-the-caller) przejdź do **Integracje**, wybierz **Dodaj integrację**, a potem **Webhook Tool**. Zastąp `YOUR_ODOO_ADDRESS` adresem swojej bazy, na przykład `mycompany.odoo.com`. Każde narzędzie wysyła te same nagłówki żądania: * `Authorization` (Secret): `Bearer `, a po nim klucz API * `X-Odoo-Database` (Value): nazwa twojej bazy danych. Potrzebne tylko, jeśli twój serwer hostuje więcej niż jedną bazę. ### Znajdź rozmówcę | Pole | Wartość | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Nazwa** | `find_odoo_contact` | | **Opis** | "Znajdź rozmówcę wśród naszych kontaktów po adresie e-mail lub pełnym imieniu i nazwisku, jeśli nie ma e-maila. Użyj tego przed dodaniem leada." | | **Metoda** | POST | | **URL** | `https://YOUR_ODOO_ADDRESS/json/2/res.partner/name_search` | | **Nagłówki żądania** | `Authorization` (Secret): `Bearer `, a po nim klucz API `X-Odoo-Database` (Value): nazwa twojej bazy danych, tylko jeśli jest potrzebna | | **Parametry treści** | `name` (string, wymagane): "Adres e-mail rozmówcy lub jego pełne imię i nazwisko, tak jak je podaje." `operator` (string, stała wartość): `=ilike` `limit` (integer, stała wartość): `5` | | **Przypisz do agentów** | **Recepcjonistka** | Operator `=ilike` dopasowuje całe imię i nazwisko lub adres e-mail bez uwzględniania wielkości liter, więc wyszukiwanie „Jane” nie wyświetli każdej Jane. Odoo zwraca tylko identyfikator i nazwę każdego dopasowania. Wyszukiwanie kontaktów Odoo nie obejmuje numerów telefonów, więc twoja recepcjonistka musi poprosić o adres e-mail lub imię i nazwisko. ### Dodaj rozmówcę jako leada | Pole | Wartość | | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | **Nazwa** | `create_odoo_lead` | | **Opis** | "Dodaj rozmówcę do naszego CRM jako leada, gdy chce wycenę lub kontakt zwrotny." | | **Metoda** | POST | | **URL** | `https://YOUR_ODOO_ADDRESS/json/2/crm.lead/create` | | **Nagłówki żądania** | `Authorization` (Secret): `Bearer `, a po nim klucz API `X-Odoo-Database` (Value): nazwa twojej bazy danych, tylko jeśli jest potrzebna | | **Parametry treści** | `vals_list` (object, wymagane), z polami poniżej | | **Przypisz do agentów** | **Recepcjonistka** | Odoo oczekuje pól nowego leada w obiekcie `vals_list`. Dla każdego z nich wybierz **Dodaj pole** w `vals_list`: * `name` (string, wymagane, z rozmowy): "Tytuł leada, na przykład: Wycena kuchni - Jane Doe." * `contact_name` (string, wymagane, z rozmowy): "Pełne imię i nazwisko rozmówcy." * `email_from` (string, z rozmowy): "Adres e-mail rozmówcy, jeśli go podał." * `phone` (string, wymagane, z rozmowy): "Numer telefonu rozmówcy w formacie międzynarodowym, na przykład +14155550123." * `description` (string, wymagane, z rozmowy): "Czego potrzebuje rozmówca, w kilku zdaniach." * `user_id` (integer, stała wartość): identyfikator użytkownika sprzedawcy * `team_id` (integer, stała wartość): identyfikator zespołu sprzedaży Sprzedawca i zespół to stałe wartości, więc każdy lead trafi do nich, nawet jeśli AI wyśle inne identyfikatory. Pomiń pola takie jak oczekiwany przychód, aby recepcjonistka nie zgadywała kwot. Wybierz **Włącz** przy każdym narzędziu, a następnie [przetestuj recepcjonistkę](/docs/pl/reception-ai/receptionist/testing) jako istniejący kontakt, który podaje adres e-mail, a potem jako nowy rozmówca proszący o wycenę. Nowy lead pojawi się w procesie CRM Odoo. ## Opcja 2: Zapier ### Połącz Zapier Jeśli jeszcze tego nie zrobiono, połącz [Zapier](/docs/pl/reception-ai/integrations/zapier) w Reception.ai. ### Dodaj akcje Odoo Na serwerze Zapier MCP pod adresem [mcp.zapier.com](https://mcp.zapier.com) dodaj [poniższe akcje](#zapier-actions) z aplikacji **Odoo CRM** i zaloguj się do Odoo, gdy Zapier o to poprosi. Dla każdego pola ustaw stałą wartość lub pozwól AI je wypełnić, zgodnie z listą. Aplikacja **Odoo CRM** działa z bazami hostowanymi na odoo.com. W przypadku bazy hostowanej na własnym serwerze zobacz [Ograniczenia](#limitations). Akcje mogą robić wszystko, co może użytkownik Odoo, na którego się logujesz. Rozważ utworzenie dedykowanego użytkownika z dostępem tylko do CRM i kontaktów. ### Przypisz narzędzia W Reception.ai otwórz kartę **Narzędzia** integracji Zapier, wybierz **Odśwież narzędzia** i przypisz każdą akcję do **Klienta** (recepcjonistki). ### Przetestuj [Przetestuj recepcjonistkę](/docs/pl/reception-ai/receptionist/testing) jako istniejący kontakt, który podaje adres e-mail, a potem jako nowy rozmówca proszący o wycenę. Nowy lead pojawi się w procesie CRM Odoo. ### Akcje Zapier #### Znajdź rozmówcę | Pole | Wartość | | ---------------------- | --------------------------------------------------------------------------- | | **Akcja Zapier** | **Find Contact** | | **Ustaw w Zapier** | Nic. | | **Pozwól AI wypełnić** | Adres e-mail rozmówcy lub jego pełne imię i nazwisko, jeśli nie ma e-maila. | | **Przypisz do** | **Klienta** | Aplikacja Zapier dla Odoo wyszukuje kontakty po imieniu i nazwisku lub adresie e-mail, a nie po numerze telefonu, więc twoja recepcjonistka musi poprosić o jedną z tych informacji. #### Dodaj rozmówcę jako leada | Pole | Wartość | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | **Akcja Zapier** | **Create Lead** | | **Ustaw w Zapier** | Sprzedawcę i zespół sprzedaży, do których trafiają nowe leady, jeśli na twoim koncie widzisz te pola. | | **Pozwól AI wypełnić** | Tytuł leada (na przykład „Wycena kuchni - Jane Doe”), imię i nazwisko, e-mail oraz numer telefonu kontaktu, a także opis potrzeb rozmówcy. | | **Przypisz do** | **Klienta** | Pozostaw puste pola takie jak oczekiwany przychód, aby recepcjonistka nie zgadywała kwot. > **Tip** > > Niezależnie od wybranej opcji dodaj [procedurę](/docs/pl/reception-ai/receptionist/rules-and-procedures), > aby recepcjonistka prosiła rozmówcę o adres e-mail i wyszukiwała go, zanim utworzy > leada. > **Warning** > > Wyszukiwanie może zwrócić kontakty, które nie są rozmówcą, a **Find Contact** w Zapier zwraca > wszystko, co zapisano przy kontakcie. Dodaj > [regułę](/docs/pl/reception-ai/receptionist/rules-and-procedures), która nakaże recepcjonistce, by nigdy > nie odczytywała rozmówcy danych kontaktu i używała ich tylko do rozpoznania rozmówcy. ## Ograniczenia * Twoja recepcjonistka nie może wyszukiwać rozmówców po numerze telefonu. Potrzebuje ich adresu e-mail lub dokładnego imienia i nazwiska. * Opis leada zawiera informację o tym, czego chciał rozmówca. Aplikacja **Odoo CRM** w Zapier nie ma akcji dodawania notatki ani rejestrowania połączenia. * W narzędziach webhook klucz API wygasa. Wymień go przed datą wygaśnięcia, inaczej narzędzia przestaną działać. * W Zapier baza Odoo hostowana na własnym serwerze wymaga zamiast tego aplikacji **Odoo ERP Self Hosted** od Zapier. Jej akcja **Create Lead/Opportunity** dodaje leady, ale nie ma akcji wyszukiwania, więc powracający rozmówca może zostać dodany dwa razy. Narzędzia webhook mogą przeszukiwać bazę hostowaną na własnym serwerze w Odoo 19 lub nowszym. * Twoja recepcjonistka nie może sprawdzać dostępności ani rezerwować spotkań w Odoo. Zamiast tego użyj własnej rezerwacji Reception z [Kalendarzem Google](/docs/pl/reception-ai/integrations/google-calendar). * W Zapier każda akcja uruchomiona przez recepcjonistkę zużywa zadania z planu Zapier. Zapier obecnie liczy dwa zadania za każde udane wywołanie; nieudane wywołania nie są liczone. Gdy limit planu się wyczerpie, akcje przestaną działać do czasu jego odnowienia. ## Rozwiązywanie problemów | Problem | Co sprawdzić | | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 z Odoo | Nagłówek musi mieć nazwę `Authorization` oraz zawierać `Bearer `, spację i klucz. Sprawdź, czy klucz nie wygasł ani nie został usunięty. | | 404 z Odoo | Sprawdź adres i upewnij się, że URL kończy się na `/json/2/res.partner/name_search` lub `/json/2/crm.lead/create`. Twoja baza musi działać na Odoo 19 lub nowszym, a CRM musi być zainstalowany. | | Odoo zwraca błąd dostępu | Użytkownik Reception.ai potrzebuje dostępu **Sprzedaż**: **Użytkownik: wszystkie dokumenty**. | | Odoo nie może znaleźć bazy | Dodaj nagłówek `X-Odoo-Database` z nazwą swojej bazy danych. | | Akcja Odoo nie pojawia się w Reception.ai | Po dodaniu akcji w Zapier wybierz **Odśwież narzędzia** w integracji Zapier. | | Akcja ma status **Changed** i nie jest używana | Została edytowana w Zapier. Wybierz **Update** na karcie **Tools**. | | Zapier nie może połączyć się z Odoo | Sprawdź, czy twój plan Odoo pozwala na zewnętrzne aplikacje oraz czy używasz właściwej aplikacji dla miejsca hostowania bazy. | | Znani rozmówcy nie są znajdowani | Sprawdź z rozmówcą pisownię adresu e-mail. Wyszukiwanie po imieniu i nazwisku wymaga nazwy zapisanej w Odoo, a kontakt należący do firmy jest zapisany jako nazwa firmy, przecinek i imię oraz nazwisko osoby. | | Leady trafiają do niewłaściwego sprzedawcy lub zespołu | Ustaw sprzedawcę i zespół sprzedaży jako stałe wartości w narzędziu webhook lub w Zapier. |