> 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 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](/docs/pt/reception-ai/integrations/webhooks). A adição de leads e notas é feita pelo [Zapier](/docs/pt/reception-ai/integrations/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çalho | Valor | | ------------------ | ------------------------------------------------- | | `X-PW-AccessToken` | sua chave de API | | `X-PW-Application` | `developer_api` | | `X-PW-UserEmail` | o endereço de e-mail do usuário que criou a chave | > **Warning** > > 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 | Campo | Valor | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `find_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étodo** | POST | | **URL** | `https://api.copper.com/developer_api/v1/people/search` | | **Cabeçalhos da solicitação** | Os cabeçalhos de [Antes de começar](#before-you-start) | | **Parâmetros do corpo** | `phone_number` (string, obrigatório): "O número de telefone de quem está ligando." | ### Encontrar um lead | Campo | Valor | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `find_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étodo** | POST | | **URL** | `https://api.copper.com/developer_api/v1/leads/search` | | **Cabeçalhos da solicitação** | Os cabeçalhos de [Antes de começar](#before-you-start) | | **Parâmetros do corpo** | `phone_number` (string, obrigatório): "O número de telefone de quem está ligando." | ### Criar uma tarefa de acompanhamento | Campo | Valor | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `create_copper_task` | | **Descrição** | "Crie uma tarefa para a equipe sempre que prometer um retorno de chamada a quem está ligando." | | **Método** | POST | | **URL** | `https://api.copper.com/developer_api/v1/tasks` | | **Cabeçalhos da solicitação** | Os cabeçalhos de [Antes de começar](#before-you-start) | | **Parâmetros do corpo** | `name` (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 ### Conectar o Zapier Se ainda não fez isso, conecte o [Zapier](/docs/pt/reception-ai/integrations/zapier) no Reception.ai. ### Adicionar as ações do Copper No seu servidor MCP do Zapier em [mcp.zapier.com](https://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. ### 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). ### Testar [Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) 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. > **Tip** > > Adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) 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 | Problema | O que verificar | | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 401 ou 403 do Copper | Verifique 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 encontradas | O 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 duplicados | Informe 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 aparece | Selecione **Refresh tools** na integração do Zapier depois de adicionar ações no Zapier. | | Uma ação mostra **Changed** e não é usada | Você a editou no Zapier. Selecione **Update** na aba **Tools**. |