Copper | ElevenLabs Documentation

Ihre Rezeption kann Anrufer erkennen, die bereits in Copper vorhanden sind, neue Anrufer als Leads hinzufügen, festhalten, was jeder Anrufer wollte, und eine Follow-up-Aufgabe für Ihr Team erstellen. Zum Nachschlagen von Anrufern und Erstellen von Aufgaben werden Webhook-Tools verwendet. Leads und Notizen werden über Zapier hinzugefügt, da Copper Telefonnummern und Notizverknüpfungen als verschachtelte Daten speichert, die Webhook-Tools nicht senden können.

Bevor Sie beginnen

Öffnen Sie in Copper System settings → API Keys und wählen Sie Generate API key. Vergeben Sie beispielsweise die Bezeichnung Reception.ai. Der Schlüssel agiert in Ihrem Namen und kann daher alles sehen und ändern, was Sie sehen und ändern können.

Jedes der folgenden Webhook-Tools sendet diese Request-Header:

Header	Wert
`X-PW-AccessToken`	Ihr API-Schlüssel
`X-PW-Application`	`developer_api`
`X-PW-UserEmail`	die E-Mail-Adresse des Nutzers, der den Schlüssel erstellt hat

Jeder, der den API-Schlüssel und Ihre E-Mail-Adresse besitzt, kann Ihre Copper-Daten lesen und ändern. Speichern Sie den Schlüssel nicht in gemeinsam genutzten Dokumenten und löschen Sie ihn in Copper, falls er offengelegt wird.

Webhook-Tools erstellen

Gehen Sie für jedes Tool zu Integrations, wählen Sie Add integration, dann Webhook Tool, und setzen Sie Assign to agents auf Receptionist. Die Suchendpunkte von Copper verwenden POST mit der Suche im Body.

Kontakt finden

Feld	Wert
Name	`find_copper_person`
Beschreibung	”Finde den Anrufer anhand seiner Telefonnummer unter unseren Kontakten. Nutze dies zu Beginn eines Anrufs, um zu prüfen, ob die Person Kunde ist.”
Methode	POST
URL	`https://api.copper.com/developer_api/v1/people/search`
Request-Header	Die Header aus Bevor Sie beginnen
Body-Parameter	`phone_number` (string, erforderlich): “Die Telefonnummer des Anrufers.”

Lead finden

Feld	Wert
Name	`find_copper_lead`
Beschreibung	”Finde den Anrufer anhand seiner Telefonnummer unter unseren Leads. Nutze dies, wenn der Anrufer kein Kontakt ist.”
Methode	POST
URL	`https://api.copper.com/developer_api/v1/leads/search`
Request-Header	Die Header aus Bevor Sie beginnen
Body-Parameter	`phone_number` (string, erforderlich): “Die Telefonnummer des Anrufers.”

Follow-up-Aufgabe erstellen

Feld	Wert
Name	`create_copper_task`
Beschreibung	”Erstelle für das Team eine Aufgabe, wenn du dem Anrufer einen Rückruf zusagst.”
Methode	POST
URL	`https://api.copper.com/developer_api/v1/tasks`
Request-Header	Die Header aus Bevor Sie beginnen
Body-Parameter	`name` (string, erforderlich): “Zum Beispiel: Jane Doe wegen eines Angebots für eine Küche zurückrufen.” `details` (string, erforderlich): “Name, Telefonnummer und Anliegen des Anrufers.”

Wählen Sie bei jedem Tool Enable.

Leads und Notizen hinzufügen

Zapier verbinden

Falls noch nicht geschehen, verbinden Sie Zapier in Reception.ai.

Copper-Aktionen hinzufügen

Verbinden Sie auf Ihrem Zapier-MCP-Server unter mcp.zapier.com Ihr Copper-Konto und fügen Sie diese Aktionen hinzu:

Create Lead: Legen Sie Inhaber und Lead-Quelle als feste Werte fest und lassen Sie die KI den Namen, die Telefonnummer, die E-Mail-Adresse und das Anliegen des Anrufers ausfüllen.
Create Activity: Legen Sie den Aktivitätstyp als Notiz fest und lassen Sie die KI die von den Such-Tools gefundene Person oder den gefundenen Lead sowie das Anliegen des Anrufers ausfüllen.

Tools zuweisen

Öffnen Sie in Reception.ai den Tab Tools der Zapier-Integration, wählen Sie Refresh tools und weisen Sie beide Copper-Aktionen dem Client (der Rezeption) zu.

Testen

Testen Sie Ihre Rezeption mit einem Anruf von einer Nummer, die bei einem Copper-Kontakt gespeichert ist, und danach von einer neuen Nummer, die um einen Rückruf bittet. Der neue Anrufer erscheint als Lead und die Aufgabe erscheint in Copper.

Fügen Sie eine Prozedur hinzu, damit Ihre Rezeption zuerst Kontakte und Leads durchsucht und nur dann einen Lead erstellt, wenn der Anrufer in keiner der Suchen gefunden wird.

Einschränkungen

Webhook-Tools senden flache Werte, Copper verknüpft eine Aufgabe jedoch über einen verschachtelten Wert mit einer Person oder einem Lead. Aufgaben aus create_copper_task sind daher nicht mit dem Datensatz des Anrufers verknüpft; in den Aufgabendetails stehen stattdessen Name und Nummer des Anrufers.
Copper akzeptiert Fälligkeitsdaten als Unix-Zeitstempel, die die KI nicht zuverlässig berechnen kann. Daher lässt create_copper_task das Fälligkeitsdatum leer.
Um Aufgaben mit dem Anrufer zu verknüpfen oder ein Fälligkeitsdatum festzulegen, verwenden Sie statt des Webhook-Tools die Copper-Aktion Create Task über Zapier.
Jede Zapier-Aktion, die Ihre Rezeption ausführt, verbraucht Tasks aus Ihrem Zapier-Tarif. Wenn der Tarif aufgebraucht ist, werden die Aktionen bis zur Zurücksetzung angehalten.

Fehlerbehebung

Problem	Prüfen Sie
401 oder 403 von Copper	Prüfen Sie alle drei Header. `X-PW-UserEmail` muss die E-Mail-Adresse des Nutzers sein, der den Schlüssel erstellt hat.
Bekannte Anrufer werden nicht gefunden	Copper gleicht Telefonnummern in der gespeicherten Form ab. Speichern Sie Nummern in einem einheitlichen Format und prüfen Sie, ob der Anrufer eine Person oder ein Lead und kein Unternehmen ist.
Die Rezeption erstellt doppelte Leads	Geben Sie in den Beschreibungen der Such-Tools an, dass ein Lead nur erstellt werden soll, wenn der Anrufer nicht gefunden wurde.
Eine Copper-Aktion erscheint nicht	Wählen Sie nach dem Hinzufügen von Aktionen in Zapier bei der Zapier-Integration Refresh tools.
Eine Aktion zeigt Changed und wird nicht verwendet	Sie haben sie in Zapier bearbeitet. Wählen Sie im Tab Tools Update.