> 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.

# Nutshell

Tu recepcionista puede identificar a quienes llaman y ya están en Nutshell, y añadir a nuevas personas que llaman como contactos con un lead para que tu equipo pueda hacer seguimiento. La búsqueda de quien llama utiliza una [herramienta de webhook](/docs/es/reception-ai/integrations/webhooks). La incorporación de personas y leads se realiza mediante [Zapier](/docs/es/reception-ai/integrations/zapier), porque la API de Nutshell necesita listas y valores anidados para crear registros, algo que las herramientas de webhook no pueden enviar.

## Busca a quien llama

### Crea una clave de API

En Nutshell, selecciona **Settings** en la esquina inferior izquierda y, después, **API keys** en **Connections**. Selecciona **Add API key** y elige **API + user impersonation**, que también necesita Zapier. Copia la clave.

### Crea la cabecera de autorización

La API de Nutshell usa tu dirección de correo electrónico de Nutshell como nombre de usuario y la clave de API como contraseña. Codifícalos en un terminal, sustituyendo ambos valores y manteniendo los dos puntos entre ellos:

```bash
printf 'YOUR_EMAIL:YOUR_API_KEY' | base64
```

El valor de la cabecera es `Basic ` seguido del resultado.

> **Warning**
>
> No pegues tu clave de API en un codificador en línea. Cualquiera que tenga la clave o la cabecera codificada puede
> leer y modificar tus datos de Nutshell.

### Crea la herramienta de webhook

Ve a **Integrations**, selecciona **Add integration** y elige **Webhook Tool**.

| Campo                      | Valor                                                                                                                                                     |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nombre**                 | `find_nutshell_person`                                                                                                                                    |
| **Descripción**            | "Busca a quien llama en nuestro CRM por número de teléfono, nombre o correo electrónico. Úsala al inicio de una llamada para comprobar si ya es cliente." |
| **Método**                 | GET                                                                                                                                                       |
| **URL**                    | `https://app.nutshell.com/rest/contacts`                                                                                                                  |
| **Cabeceras de solicitud** | `Authorization`: `Basic ` seguido del valor codificado                                                                                                    |
| **Parámetros de consulta** | `q` (cadena, obligatorio): "El número de teléfono, nombre completo o dirección de correo electrónico de quien llama."                                     |
| **Asignar a agentes**      | **Recepcionista**                                                                                                                                         |

Selecciona **Enable**.

## Añade personas y leads

### Conecta Zapier

Si aún no lo has hecho, conecta [Zapier](/docs/es/reception-ai/integrations/zapier) en Reception.ai.

### Añade las acciones de Nutshell

En tu servidor MCP de Zapier en [mcp.zapier.com](https://mcp.zapier.com), conecta tu cuenta de Nutshell con la clave de API y añade estas acciones:

* **Create Person**: deja que la IA complete el nombre, número de teléfono y dirección de correo electrónico de quien llama.
* **Create Lead**: establece el origen, el canal y la persona asignada como valores fijos, y deja que la IA complete una descripción de lo que quiere quien llama y para quién es.

> **Tip**
>
> Para registrar la llamada en la cronología de la persona, añade también **Log Activity** y deja que la IA complete un
> breve resumen.

### Asigna las herramientas

En Reception.ai, abre la pestaña **Tools** de la integración de Zapier, selecciona **Refresh tools** y asigna las acciones de Nutshell al **Client** (recepcionista).

### Pruébalo

[Prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) con una llamada desde un número guardado en una persona de Nutshell y, después, como una nueva persona que llama y quiere un presupuesto. La nueva persona y su lead aparecerán en Nutshell.

## Limitaciones

* La aplicación de Nutshell de Zapier no tiene una acción para crear una tarea de seguimiento. La persona asignada al lead verá los nuevos leads en Nutshell.
* La aplicación de Nutshell de Zapier no puede comprobar la disponibilidad de nadie, por lo que tu recepcionista no puede reservar reuniones en Nutshell. Usa la reserva propia de Reception con [Google Calendar](/docs/es/reception-ai/integrations/google-calendar).
* Cada acción de Zapier que ejecute tu recepcionista consume tareas de tu plan de Zapier. Actualmente, Zapier cuenta dos tareas por cada llamada realizada correctamente; las llamadas fallidas no se cuentan. Cuando se agote el plan, las acciones se detendrán hasta que se restablezca.

## Resolución de problemas

| Problema                                          | Qué comprobar                                                                                                                   |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| 401 de Nutshell                                   | Codifica tu dirección de correo electrónico de Nutshell, dos puntos y la clave, y empieza el valor de la cabecera con `Basic `. |
| No se encuentra a quienes ya han llamado          | Prueba una llamada desde un número guardado en una persona de Nutshell o pide a quien llama su nombre.                          |
| La recepcionista crea personas duplicadas         | Indícale en la descripción de la herramienta de búsqueda que añada una persona solo si no se ha encontrado a quien llama.       |
| Una acción de Nutshell no aparece en Reception.ai | Selecciona **Refresh tools** en la integración de Zapier después de añadir acciones en Zapier.                                  |
| Zapier no puede conectarse a Nutshell             | Usa una clave de API con **API + user impersonation**.                                                                          |