Copper | ElevenLabs Documentation

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. Leads en notities toevoegen gebeurt via 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

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
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
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
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 in Reception.ai.

Voeg de Copper-acties toe

Verbind in je Zapier MCP-server op 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 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.

Voeg een procedure 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.