Ir para a navegação

Copper

Encontre pessoas que ligam, adicione leads e registre notas e tarefas de acompanhamento no Copper durante as chamadas.

Sua recepcionista pode reconhecer pessoas que ligam e já estão no Copper, adicionar novas pessoas como leads, registrar o que cada pessoa queria e criar uma tarefa de acompanhamento para sua equipe. A busca por quem liga e a criação de tarefas usam ferramentas de webhook. A adição de leads e notas é feita pelo Zapier, pois o Copper armazena números de telefone e links de notas como dados aninhados que as ferramentas de webhook não conseguem enviar.

Antes de começar

No Copper, abra System settings → API Keys e selecione Generate API key. Dê um rótulo a ela, por exemplo, Reception.ai. A chave age como você, então pode ver e alterar tudo o que você pode.

Todas as ferramentas de webhook abaixo enviam estes cabeçalhos de solicitação:

CabeçalhoValor
X-PW-AccessTokensua chave de API
X-PW-Applicationdeveloper_api
X-PW-UserEmailo endereço de e-mail do usuário que criou a chave

Qualquer pessoa com a chave de API e seu endereço de e-mail pode ler e alterar seus dados do Copper. Não inclua a chave em documentos compartilhados e exclua-a no Copper se ela vazar.

Criar as ferramentas de webhook

Para cada ferramenta, vá para Integrations, selecione Add integration, escolha Webhook Tool e defina Assign to agents como Receptionist. Os endpoints de busca do Copper usam POST com a busca no corpo da solicitação.

Encontrar um contato

CampoValor
Nomefind_copper_person
Descrição”Encontre quem está ligando entre nossos contatos pelo número de telefone. Use esta ferramenta no início da chamada para verificar se já é cliente.”
MétodoPOST
URLhttps://api.copper.com/developer_api/v1/people/search
Cabeçalhos da solicitaçãoOs cabeçalhos de Antes de começar
Parâmetros do corpophone_number (string, obrigatório): “O número de telefone de quem está ligando.”

Encontrar um lead

CampoValor
Nomefind_copper_lead
Descrição”Encontre quem está ligando entre nossos leads pelo número de telefone. Use esta ferramenta quando a pessoa não for um contato.”
MétodoPOST
URLhttps://api.copper.com/developer_api/v1/leads/search
Cabeçalhos da solicitaçãoOs cabeçalhos de Antes de começar
Parâmetros do corpophone_number (string, obrigatório): “O número de telefone de quem está ligando.”

Criar uma tarefa de acompanhamento

CampoValor
Nomecreate_copper_task
Descrição”Crie uma tarefa para a equipe sempre que prometer um retorno de chamada a quem está ligando.”
MétodoPOST
URLhttps://api.copper.com/developer_api/v1/tasks
Cabeçalhos da solicitaçãoOs cabeçalhos de Antes de começar
Parâmetros do corponame (string, obrigatório): “Por exemplo: Retornar a ligação de Jane Doe sobre um orçamento de cozinha.”
details (string, obrigatório): “O nome, número de telefone e o que a pessoa precisa.”

Selecione Enable em cada ferramenta.

Adicionar leads e notas

1

Conectar o Zapier

Se ainda não fez isso, conecte o Zapier no Reception.ai.

2

Adicionar as ações do Copper

No seu servidor MCP do Zapier em mcp.zapier.com, conecte sua conta do Copper e adicione estas ações:

  • Create Lead: defina o responsável e a origem do lead como valores fixos e deixe a IA preencher o nome, número de telefone, endereço de e-mail e o que a pessoa quer.
  • Create Activity: defina o tipo de atividade como uma nota e deixe a IA preencher a pessoa ou o lead encontrado pelas ferramentas de busca e o que a pessoa precisava.
3

Atribuir as ferramentas

No Reception.ai, abra a aba Tools da integração do Zapier, selecione Refresh tools e atribua ambas as ações do Copper ao Client (recepcionista).

4

Testar

Teste sua recepcionista com uma chamada de um número salvo em um contato do Copper e, depois, de um novo número que pede um retorno. A nova pessoa aparecerá como lead e a tarefa aparecerá no Copper.

Adicione um procedimento para que sua recepcionista primeiro busque contatos e leads e só crie um lead quando nenhuma das buscas encontrar quem está ligando.

Limitações

  • As ferramentas de webhook enviam valores simples, e o Copper vincula uma tarefa a uma pessoa ou lead com um valor aninhado. Portanto, as tarefas de create_copper_task não são vinculadas ao registro de quem está ligando; os detalhes da tarefa mantêm o nome e o número da pessoa.
  • O Copper aceita datas de vencimento como timestamps Unix, que a IA não consegue calcular de forma confiável. Por isso, create_copper_task deixa a data de vencimento vazia.
  • Para vincular tarefas a quem está ligando ou definir uma data de vencimento, use a ação Create Task do Copper pelo Zapier em vez da ferramenta de webhook.
  • Cada ação do Zapier executada pela sua recepcionista consome tarefas do seu plano do Zapier. Quando o plano acaba, as ações param até que ele seja renovado.

Solução de problemas

ProblemaO que verificar
401 ou 403 do CopperVerifique os três cabeçalhos. X-PW-UserEmail deve ser o e-mail do usuário que gerou a chave.
Pessoas conhecidas que ligam não são encontradasO Copper corresponde aos números de telefone conforme armazenados. Salve os números em um único formato e verifique se a pessoa é um contato ou lead, e não uma empresa.
A recepcionista cria leads duplicadosInforme nas descrições das ferramentas de busca que ela deve criar um lead somente quando não encontrar quem está ligando.
Uma ação do Copper não apareceSelecione Refresh tools na integração do Zapier depois de adicionar ações no Zapier.
Uma ação mostra Changed e não é usadaVocê a editou no Zapier. Selecione Update na aba Tools.