> 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 Je receptionist kan bellers herkennen die al in Copper staan, nieuwe bellers als leads toevoegen, noteren wat elke beller wilde en een opvolgtaak voor je team maken. Bellers opzoeken en taken maken gebeurt met [webhook tools](/docs/nl/reception-ai/integrations/webhooks). Leads en notities toevoegen gebeurt via [Zapier](/docs/nl/reception-ai/integrations/zapier), omdat Copper telefoonnummers en koppelingen naar notities opslaat als geneste gegevens die webhook tools niet kunnen versturen. ## Voordat je begint Open in Copper **System settings** → **API Keys** en selecteer **Generate API key**. Geef deze bijvoorbeeld het label `Reception.ai`. De sleutel handelt namens jou, dus deze kan zien en wijzigen wat jij kunt. Elke onderstaande webhook tool stuurt deze requestheaders mee: | Header | Waarde | | ------------------ | ------------------------------------------------------------- | | `X-PW-AccessToken` | je API-sleutel | | `X-PW-Application` | `developer_api` | | `X-PW-UserEmail` | het e-mailadres van de gebruiker die de sleutel heeft gemaakt | > **Warning** > > Iedereen met de API-sleutel en je e-mailadres kan je Copper-gegevens lezen en wijzigen. Bewaar de sleutel > niet in gedeelde documenten en verwijder deze in Copper als hij uitlekt. ## Maak de webhook tools Ga voor elke tool naar **Integrations**, selecteer **Add integration**, kies **Webhook Tool** en stel **Assign to agents** in op **Receptionist**. De zoekendpoints van Copper gebruiken POST met de zoekopdracht in de body. ### Zoek een contact | Veld | Waarde | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | | **Naam** | `find_copper_person` | | **Beschrijving** | "Zoek de beller onder onze contacten op telefoonnummer. Gebruik dit aan het begin van een gesprek om te controleren of het een klant is." | | **Methode** | POST | | **URL** | `https://api.copper.com/developer_api/v1/people/search` | | **Requestheaders** | De headers uit [Voordat je begint](#before-you-start) | | **Bodyparameters** | `phone_number` (string, vereist): "Het telefoonnummer van de beller." | ### Zoek een lead | Veld | Waarde | | ------------------ | --------------------------------------------------------------------------------------------------- | | **Naam** | `find_copper_lead` | | **Beschrijving** | "Zoek de beller onder onze leads op telefoonnummer. Gebruik dit wanneer de beller geen contact is." | | **Methode** | POST | | **URL** | `https://api.copper.com/developer_api/v1/leads/search` | | **Requestheaders** | De headers uit [Voordat je begint](#before-you-start) | | **Bodyparameters** | `phone_number` (string, vereist): "Het telefoonnummer van de beller." | ### Maak een opvolgtaak | Veld | Waarde | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Naam** | `create_copper_task` | | **Beschrijving** | "Maak een taak voor het team wanneer je de beller belooft terug te bellen." | | **Methode** | POST | | **URL** | `https://api.copper.com/developer_api/v1/tasks` | | **Requestheaders** | De headers uit [Voordat je begint](#before-you-start) | | **Bodyparameters** | `name` (string, vereist): "Bijvoorbeeld: Bel Jane Doe terug over een offerte voor een keuken." `details` (string, vereist): "De naam, het telefoonnummer en de vraag van de beller." | Selecteer **Enable** voor elke tool. ## Leads en notities toevoegen ### Verbind Zapier Als je dat nog niet hebt gedaan, verbind je [Zapier](/docs/nl/reception-ai/integrations/zapier) in Reception.ai. ### Voeg de Copper-acties toe Verbind in je Zapier MCP-server op [mcp.zapier.com](https://mcp.zapier.com) je Copper-account en voeg deze acties toe: * **Create Lead**: stel de eigenaar en de bron van de lead in als vaste waarden en laat de AI de naam, het telefoonnummer, het e-mailadres en de vraag van de beller invullen. * **Create Activity**: stel het activiteitstype in op een notitie en laat de AI de persoon of lead invullen die is gevonden met de zoektools, plus wat de beller nodig had. ### Wijs de tools toe Open in Reception.ai het tabblad **Tools** van de Zapier-integratie, selecteer **Refresh tools** en wijs beide Copper-acties toe aan de **Client** (receptionist). ### Test het [Test je receptionist](/docs/nl/reception-ai/receptionist/testing) met een gesprek vanaf een nummer dat is opgeslagen bij een Copper-contact, en daarna vanaf een nieuw nummer dat om een terugbelverzoek vraagt. De nieuwe beller verschijnt als lead en de taak verschijnt in Copper. > **Tip** > > Voeg een [procedure](/docs/nl/reception-ai/receptionist/rules-and-procedures) toe zodat je receptionist > eerst naar contacten en leads zoekt en alleen een lead maakt wanneer beide zoekopdrachten de beller niet vinden. ## Beperkingen * Webhook tools versturen platte waarden en Copper koppelt een taak aan een persoon of lead met een geneste waarde. Taken van `create_copper_task` zijn dus niet gekoppeld aan het record van de beller; de taakdetails bevatten in plaats daarvan de naam en het nummer van de beller. * Copper verwacht vervaldata als Unix-timestamps, die de AI niet betrouwbaar kan berekenen. Daarom laat `create_copper_task` de vervaldatum leeg. * Gebruik de actie **Create Task** van Copper via Zapier in plaats van de webhook tool om taken aan de beller te koppelen of een vervaldatum in te stellen. * Elke Zapier-actie die je receptionist uitvoert, gebruikt taken uit je Zapier-abonnement. Wanneer het abonnement is opgebruikt, stoppen de acties totdat het wordt gereset. ## Problemen oplossen | Probleem | Controleren | | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 of 403 van Copper | Controleer alle drie de headers. `X-PW-UserEmail` moet het e-mailadres zijn van de gebruiker die de sleutel heeft gegenereerd. | | Bekende bellers worden niet gevonden | Copper vergelijkt telefoonnummers zoals ze zijn opgeslagen. Sla nummers in één indeling op en controleer of de beller een persoon of lead is, geen bedrijf. | | De receptionist maakt dubbele leads | Geef in de beschrijvingen van de zoektools aan dat deze alleen een lead moeten maken wanneer de beller niet is gevonden. | | Een Copper-actie verschijnt niet | Selecteer **Refresh tools** in de Zapier-integratie nadat je acties hebt toegevoegd in Zapier. | | Een actie toont **Changed** en wordt niet gebruikt | Je hebt deze bewerkt in Zapier. Selecteer **Update** op het tabblad **Tools**. |