> 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 Tu recepcionista puede reconocer a quienes llaman y ya están en Copper, añadir a quienes llaman por primera vez como clientes potenciales, anotar lo que quería cada persona y crear una tarea de seguimiento para tu equipo. Para buscar a quienes llaman y crear tareas se usan [herramientas webhook](/docs/es/reception-ai/integrations/webhooks). Para añadir clientes potenciales y notas se usa [Zapier](/docs/es/reception-ai/integrations/zapier), porque Copper almacena los números de teléfono y los enlaces de notas como datos anidados que las herramientas webhook no pueden enviar. ## Antes de empezar En Copper, abre **System settings** → **API Keys** y selecciona **Generate API key**. Ponle una etiqueta, por ejemplo, `Reception.ai`. La clave actúa en tu nombre, por lo que puede ver y modificar lo mismo que tú. Todas las herramientas webhook siguientes envían estos encabezados de solicitud: | Encabezado | Valor | | ------------------ | ---------------------------------------------------------------- | | `X-PW-AccessToken` | tu clave de API | | `X-PW-Application` | `developer_api` | | `X-PW-UserEmail` | la dirección de correo electrónico del usuario que creó la clave | > **Warning** > > Cualquiera que tenga la clave de API y tu dirección de correo electrónico puede leer y modificar tus datos de Copper. No incluyas la clave > en documentos compartidos y elimínala en Copper si se filtra. ## Crear las herramientas webhook Para cada herramienta, ve a **Integrations**, selecciona **Add integration**, elige **Webhook Tool** y establece **Assign to agents** en **Receptionist**. Las rutas de API de búsqueda de Copper usan POST con la búsqueda en el cuerpo. ### Buscar un contacto | Campo | Valor | | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | **Nombre** | `find_copper_person` | | **Descripción** | "Busca a quien llama entre nuestros contactos por número de teléfono. Úsala al inicio de una llamada para comprobar si es cliente." | | **Método** | POST | | **URL** | `https://api.copper.com/developer_api/v1/people/search` | | **Encabezados de solicitud** | Los encabezados de [Antes de empezar](#before-you-start) | | **Parámetros del cuerpo** | `phone_number` (cadena, obligatorio): "El número de teléfono de quien llama." | ### Buscar un cliente potencial | Campo | Valor | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | **Nombre** | `find_copper_lead` | | **Descripción** | "Busca a quien llama entre nuestros clientes potenciales por número de teléfono. Úsala cuando quien llama no sea un contacto." | | **Método** | POST | | **URL** | `https://api.copper.com/developer_api/v1/leads/search` | | **Encabezados de solicitud** | Los encabezados de [Antes de empezar](#before-you-start) | | **Parámetros del cuerpo** | `phone_number` (cadena, obligatorio): "El número de teléfono de quien llama." | ### Crear una tarea de seguimiento | Campo | Valor | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nombre** | `create_copper_task` | | **Descripción** | "Crea una tarea para el equipo cada vez que prometas devolver la llamada a quien llama." | | **Método** | POST | | **URL** | `https://api.copper.com/developer_api/v1/tasks` | | **Encabezados de solicitud** | Los encabezados de [Antes de empezar](#before-you-start) | | **Parámetros del cuerpo** | `name` (cadena, obligatorio): "Por ejemplo: Llamar a Jane Doe para hablar de un presupuesto de cocina." `details` (cadena, obligatorio): "El nombre, número de teléfono y necesidades de quien llama." | Selecciona **Enable** en cada herramienta. ## Añadir clientes potenciales y notas ### Conectar Zapier Si aún no lo has hecho, conecta [Zapier](/docs/es/reception-ai/integrations/zapier) en Reception.ai. ### Añadir las acciones de Copper En tu servidor MCP de Zapier en [mcp.zapier.com](https://mcp.zapier.com), conecta tu cuenta de Copper y añade estas acciones: * **Create Lead**: establece el propietario y el origen del cliente potencial como valores fijos, y deja que la IA complete el nombre, número de teléfono, dirección de correo electrónico y lo que busca quien llama. * **Create Activity**: establece el tipo de actividad como nota y deja que la IA complete la persona o cliente potencial encontrado por las herramientas de búsqueda y lo que necesitaba quien llama. ### Asignar las herramientas En Reception.ai, abre la pestaña **Tools** de la integración de Zapier, selecciona **Refresh tools** y asigna ambas acciones de Copper a **Client** (recepcionista). ### Probarlo [Prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) con una llamada desde un número guardado en un contacto de Copper y después desde un número nuevo que pide que le devuelvan la llamada. La nueva persona aparecerá como cliente potencial y la tarea aparecerá en Copper. > **Tip** > > Añade un [procedimiento](/docs/es/reception-ai/receptionist/rules-and-procedures) para que tu recepcionista > busque primero en contactos y clientes potenciales, y cree un cliente potencial solo si ninguna búsqueda encuentra a quien llama. ## Limitaciones * Las herramientas webhook envían valores planos y Copper vincula una tarea a una persona o cliente potencial mediante un valor anidado. Por tanto, las tareas de `create_copper_task` no se vinculan al registro de quien llama; los detalles de la tarea conservan en su lugar el nombre y número de quien llama. * Copper recibe las fechas límite como marcas de tiempo Unix, que la IA no puede calcular de forma fiable, por lo que `create_copper_task` deja vacía la fecha límite. * Para vincular tareas a quien llama o establecer una fecha límite, usa la acción **Create Task** de Copper a través de Zapier en lugar de la herramienta webhook. * Cada acción de Zapier que ejecuta tu recepcionista usa tareas de tu plan de Zapier. Cuando se agota el plan, las acciones se detienen hasta que se renueva. ## Solución de problemas | Problema | Qué comprobar | | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Error 401 o 403 de Copper | Comprueba los tres encabezados. `X-PW-UserEmail` debe ser el correo electrónico del usuario que generó la clave. | | No se encuentra a personas conocidas | Copper busca coincidencias con los números de teléfono tal como están guardados. Guarda los números en un único formato y comprueba que quien llama sea una persona o cliente potencial, no una empresa. | | La recepcionista crea clientes potenciales duplicados | Indícale en las descripciones de las herramientas de búsqueda que cree un cliente potencial solo si no encontró a quien llama. | | No aparece una acción de Copper | Selecciona **Refresh tools** en la integración de Zapier después de añadir acciones en Zapier. | | Una acción muestra **Changed** y no se usa | La editaste en Zapier. Selecciona **Update** en la pestaña **Tools**. |