Vai alla navigazione

Copper

Trova chiamanti, aggiungi lead e registra note e attività di follow-up in Copper durante le chiamate.

La tua receptionist può riconoscere i chiamanti già presenti in Copper, aggiungere nuovi chiamanti come lead, annotare ciò di cui ogni chiamante ha bisogno e creare un’attività di follow-up per il tuo team. Per cercare i chiamanti e creare attività vengono usati strumenti webhook. L’aggiunta di lead e note avviene tramite Zapier, perché Copper memorizza i numeri di telefono e i collegamenti alle note come dati annidati che gli strumenti webhook non possono inviare.

Prima di iniziare

In Copper, apri Impostazioni di sistema → Chiavi API e seleziona Genera chiave API. Assegnale un’etichetta, ad esempio Reception.ai. La chiave agisce per tuo conto, quindi può visualizzare e modificare tutto ciò che puoi visualizzare e modificare tu.

Ogni strumento webhook seguente invia questi header della richiesta:

HeaderValore
X-PW-AccessTokenla tua chiave API
X-PW-Applicationdeveloper_api
X-PW-UserEmaill’indirizzo email dell’utente che ha creato la chiave

Chiunque disponga della chiave API e del tuo indirizzo email può leggere e modificare i tuoi dati Copper. Non inserire la chiave in documenti condivisi e cancellala da Copper se viene divulgata.

Crea gli strumenti webhook

Per ogni strumento, vai su Integrazioni, seleziona Aggiungi integrazione, scegli Strumento webhook e imposta Assegna agli agenti su Receptionist. Gli endpoint di ricerca di Copper usano POST con la ricerca nel body.

Trova un contatto

CampoValore
Nomefind_copper_person
Descrizione”Trova il chiamante tra i nostri contatti in base al numero di telefono. Usalo all’inizio di una chiamata per verificare se è un cliente.”
MetodoPOST
URLhttps://api.copper.com/developer_api/v1/people/search
Header della richiestaGli header di Prima di iniziare
Parametri del bodyphone_number (stringa, obbligatorio): “Il numero di telefono del chiamante.”

Trova un lead

CampoValore
Nomefind_copper_lead
Descrizione”Trova il chiamante tra i nostri lead in base al numero di telefono. Usalo quando il chiamante non è un contatto.”
MetodoPOST
URLhttps://api.copper.com/developer_api/v1/leads/search
Header della richiestaGli header di Prima di iniziare
Parametri del bodyphone_number (stringa, obbligatorio): “Il numero di telefono del chiamante.”

Crea un’attività di follow-up

CampoValore
Nomecreate_copper_task
Descrizione”Crea un’attività per il team ogni volta che prometti al chiamante di richiamarlo.”
MetodoPOST
URLhttps://api.copper.com/developer_api/v1/tasks
Header della richiestaGli header di Prima di iniziare
Parametri del bodyname (stringa, obbligatorio): “Ad esempio: Richiama Jane Doe per un preventivo della cucina.”
details (stringa, obbligatorio): “Il nome, il numero di telefono e ciò di cui ha bisogno il chiamante.”

Seleziona Abilita per ogni strumento.

Aggiungi lead e note

1

Collega Zapier

Se non l’hai già fatto, collega Zapier in Reception.ai.

2

Aggiungi le azioni Copper

Nel tuo server MCP Zapier su mcp.zapier.com, collega il tuo account Copper e aggiungi queste azioni:

  • Crea lead: imposta il proprietario e la fonte del lead come valori fissi e lascia che l’IA compili il nome, il numero di telefono, l’indirizzo email e la richiesta del chiamante.
  • Crea attività: imposta il tipo di attività su nota e lascia che l’IA compili la persona o il lead trovato dagli strumenti di ricerca e ciò di cui il chiamante ha bisogno.
3

Assegna gli strumenti

In Reception.ai, apri la scheda Strumenti dell’integrazione Zapier, seleziona Aggiorna strumenti e assegna entrambe le azioni Copper al Client (receptionist).

4

Provala

Prova la tua receptionist con una chiamata da un numero salvato in un contatto Copper, poi da un nuovo numero che richiede di essere richiamato. Il nuovo chiamante viene visualizzato come lead e l’attività viene visualizzata in Copper.

Aggiungi una procedura affinché la tua receptionist cerchi prima contatti e lead e crei un lead solo quando nessuna delle due ricerche trova il chiamante.

Limitazioni

  • Gli strumenti webhook inviano valori non annidati, mentre Copper collega un’attività a una persona o a un lead con un valore annidato. Di conseguenza, le attività create da create_copper_task non sono collegate al record del chiamante; nei dettagli dell’attività vengono invece mantenuti il nome e il numero del chiamante.
  • Copper accetta le date di scadenza come timestamp Unix, che l’IA non può calcolare in modo affidabile, quindi create_copper_task lascia vuota la data di scadenza.
  • Per collegare le attività al chiamante o impostare una data di scadenza, usa l’azione Crea attività di Copper tramite Zapier anziché lo strumento webhook.
  • Ogni azione Zapier eseguita dalla tua receptionist usa attività del tuo piano Zapier. Quando il piano si esaurisce, le azioni si interrompono fino al ripristino.

Risoluzione dei problemi

ProblemaCosa verificare
401 o 403 da CopperVerifica tutti e tre gli header. X-PW-UserEmail deve essere l’email dell’utente che ha generato la chiave.
I chiamanti conosciuti non vengono trovatiCopper confronta i numeri di telefono nel formato in cui sono memorizzati. Salva i numeri in un unico formato e verifica che il chiamante sia una persona o un lead, non un’azienda.
La receptionist crea lead duplicatiIndica nelle descrizioni degli strumenti di ricerca di creare un lead solo quando il chiamante non viene trovato.
Un’azione Copper non viene visualizzataDopo aver aggiunto le azioni in Zapier, seleziona Aggiorna strumenti nell’integrazione Zapier.
Un’azione mostra Modificata e non viene usataL’hai modificata in Zapier. Seleziona Aggiorna nella scheda Strumenti.