> 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 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](/docs/de/reception-ai/integrations/webhooks) verwendet. Leads und Notizen werden über [Zapier](/docs/de/reception-ai/integrations/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 | > **Warning** > > 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](#before-you-start) | | **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](#before-you-start) | | **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](#before-you-start) | | **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](/docs/de/reception-ai/integrations/zapier) in Reception.ai. ### Copper-Aktionen hinzufügen Verbinden Sie auf Ihrem Zapier-MCP-Server unter [mcp.zapier.com](https://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](/docs/de/reception-ai/receptionist/testing) 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. > **Tip** > > Fügen Sie eine [Prozedur](/docs/de/reception-ai/receptionist/rules-and-procedures) 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**. |