> 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. # Copper Twój recepcjonista może rozpoznawać dzwoniących, którzy są już w Copper, dodawać nowych dzwoniących jako leady, zapisywać, czego potrzebował każdy z nich, oraz tworzyć zadania do wykonania dla twojego zespołu. Wyszukiwanie dzwoniących i tworzenie zadań korzysta z [narzędzi webhook](/docs/pl/reception-ai/integrations/webhooks). Dodawanie leadów i notatek odbywa się przez [Zapier](/docs/pl/reception-ai/integrations/zapier), ponieważ Copper przechowuje numery telefonów i linki do notatek jako zagnieżdżone dane, których narzędzia webhook nie mogą wysyłać. ## Zanim zaczniesz W Copper otwórz **System settings** → **API Keys** i wybierz **Generate API key**. Nadaj kluczowi nazwę, na przykład `Reception.ai`. Klucz działa w twoim imieniu, więc może widzieć i zmieniać to, co ty. Każde poniższe narzędzie webhook wysyła te nagłówki żądania: | Nagłówek | Wartość | | ------------------ | ---------------------------------------------- | | `X-PW-AccessToken` | twój klucz API | | `X-PW-Application` | `developer_api` | | `X-PW-UserEmail` | adres e-mail użytkownika, który utworzył klucz | > **Warning** > > Każdy, kto ma klucz API i twój adres e-mail, może odczytywać i zmieniać dane Copper. Nie umieszczaj klucza > we wspólnych dokumentach i usuń go w Copper, jeśli wycieknie. ## Utwórz narzędzia webhook Dla każdego narzędzia przejdź do **Integrations**, wybierz **Add integration**, wybierz **Webhook Tool** i ustaw **Assign to agents** na **Receptionist**. Endpointy wyszukiwania Copper używają metody POST z wyszukiwaniem w treści żądania. ### Znajdź kontakt | Pole | Wartość | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | **Nazwa** | `find_copper_person` | | **Opis** | "Znajdź dzwoniącego wśród naszych kontaktów po numerze telefonu. Użyj na początku rozmowy, aby sprawdzić, czy jest klientem." | | **Metoda** | POST | | **URL** | `https://api.copper.com/developer_api/v1/people/search` | | **Nagłówki żądania** | Nagłówki z sekcji [Zanim zaczniesz](#before-you-start) | | **Parametry treści** | `phone_number` (ciąg znaków, wymagane): "Numer telefonu dzwoniącego." | ### Znajdź lead | Pole | Wartość | | -------------------- | ------------------------------------------------------------------------------------------------------ | | **Nazwa** | `find_copper_lead` | | **Opis** | "Znajdź dzwoniącego wśród naszych leadów po numerze telefonu. Użyj, gdy dzwoniący nie jest kontaktem." | | **Metoda** | POST | | **URL** | `https://api.copper.com/developer_api/v1/leads/search` | | **Nagłówki żądania** | Nagłówki z sekcji [Zanim zaczniesz](#before-you-start) | | **Parametry treści** | `phone_number` (ciąg znaków, wymagane): "Numer telefonu dzwoniącego." | ### Utwórz zadanie do wykonania | Pole | Wartość | | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nazwa** | `create_copper_task` | | **Opis** | "Utwórz zadanie dla zespołu, gdy obiecasz dzwoniącemu oddzwonienie." | | **Metoda** | POST | | **URL** | `https://api.copper.com/developer_api/v1/tasks` | | **Nagłówki żądania** | Nagłówki z sekcji [Zanim zaczniesz](#before-you-start) | | **Parametry treści** | `name` (ciąg znaków, wymagane): "Na przykład: Oddzwoń do Jane Doe w sprawie wyceny kuchni." `details` (ciąg znaków, wymagane): "Imię i nazwisko dzwoniącego, numer telefonu oraz to, czego potrzebuje." | Wybierz **Enable** przy każdym narzędziu. ## Dodaj leady i notatki ### Połącz Zapier Jeśli jeszcze tego nie zrobiono, połącz [Zapier](/docs/pl/reception-ai/integrations/zapier) w Reception.ai. ### Dodaj akcje Copper Na serwerze Zapier MCP pod adresem [mcp.zapier.com](https://mcp.zapier.com) połącz konto Copper i dodaj te akcje: * **Create Lead**: ustaw właściciela i źródło leada jako stałe wartości, a AI niech wypełni imię i nazwisko dzwoniącego, numer telefonu, adres e-mail oraz to, czego potrzebuje. * **Create Activity**: ustaw typ aktywności na notatkę, a AI niech wypełni osobę lub lead znaleziony przez narzędzia wyszukiwania oraz to, czego potrzebował dzwoniący. ### Przypisz narzędzia W Reception.ai otwórz kartę **Tools** integracji Zapier, wybierz **Refresh tools** i przypisz obie akcje Copper do **Client** (recepcjonisty). ### Przetestuj [Przetestuj recepcjonistę](/docs/pl/reception-ai/receptionist/testing), dzwoniąc z numeru zapisanego przy kontakcie Copper, a potem z nowego numeru z prośbą o oddzwonienie. Nowy dzwoniący pojawi się jako lead, a zadanie pojawi się w Copper. > **Tip** > > Dodaj [procedurę](/docs/pl/reception-ai/receptionist/rules-and-procedures), aby twój recepcjonista > najpierw wyszukiwał kontakty i leady, a lead tworzył tylko wtedy, gdy żadne wyszukiwanie nie znajdzie dzwoniącego. ## Ograniczenia * Narzędzia webhook wysyłają płaskie wartości, a Copper łączy zadanie z osobą lub leadem za pomocą zagnieżdżonej wartości. Dlatego zadania z `create_copper_task` nie są połączone z rekordem dzwoniącego; w szczegółach zadania pozostają za to jego imię i nazwisko oraz numer. * Copper przyjmuje terminy jako znaczniki czasu Unix, których AI nie potrafi niezawodnie wyliczyć, więc `create_copper_task` pozostawia termin pusty. * Aby połączyć zadania z dzwoniącym lub ustawić termin, użyj akcji **Create Task** Copper przez Zapier zamiast narzędzia webhook. * Każda akcja Zapier uruchomiona przez recepcjonistę zużywa zadania z twojego planu Zapier. Gdy plan się wyczerpie, akcje zatrzymają się do jego odnowienia. ## Rozwiązywanie problemów | Problem | Co sprawdzić | | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | 401 lub 403 z Copper | Sprawdź wszystkie trzy nagłówki. `X-PW-UserEmail` musi być adresem e-mail użytkownika, który wygenerował klucz. | | Nie znaleziono znanych dzwoniących | Copper dopasowuje numery telefonów tak, jak są zapisane. Zapisuj numery w jednym formacie i sprawdź, czy dzwoniący jest osobą lub leadem, a nie firmą. | | Recepcjonista tworzy zduplikowane leady | W opisach narzędzi wyszukiwania powiedz mu, aby tworzył lead tylko wtedy, gdy nie znaleziono dzwoniącego. | | Akcja Copper się nie pojawia | Po dodaniu akcji w Zapier wybierz **Refresh tools** w integracji Zapier. | | Akcja ma status **Changed** i nie jest używana | Edytowano ją w Zapier. Wybierz **Update** na karcie **Tools**. |