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

# Shopmonkey

Con una [herramienta de webhook](/docs/es/reception-ai/integrations/webhooks), tu recepcionista puede añadir una cita a tu calendario de Shopmonkey cuando alguien llame para llevar su vehículo al taller.

> **Warning**
>
> Shopmonkey no comprueba los conflictos cuando se crea una cita de esta forma, por lo que tu
> recepcionista puede reservar dos veces el mismo hueco. Indica a quienes llamen que la hora es una solicitud que tu taller
> confirmará, o proporciona a tu recepcionista el horario de apertura y los límites de plazas en sus instrucciones.

## Configuración

### Crea una clave de API

En Shopmonkey, un administrador debe abrir **Settings** → **Integration** → **API Keys** y seleccionar **Get Started** o **Add New Key**. Selecciona **Create API Key** y copia la clave de inmediato: Shopmonkey solo la muestra una vez. La clave tiene los mismos permisos que el usuario que la crea.

### Crea la herramienta de webhook

En Reception.ai, ve a **Integrations**, selecciona **Add integration** y elige **Webhook Tool**.

| Campo                        | Valor                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nombre**                   | `create_shopmonkey_appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Descripción**              | "Añade una cita al calendario del taller cuando quien llama haya elegido un día y una hora. Confirma primero la hora con esa persona."                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Método**                   | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **URL**                      | `https://api.shopmonkey.cloud/v3/appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Encabezados de solicitud** | `Authorization`: `Bearer ` seguido de tu clave de API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Parámetros del cuerpo**    | `name` (cadena, obligatorio): "El servicio y el nombre de quien llama; por ejemplo: Cambio de aceite - Jane Doe."  `startDate` (cadena, obligatorio): "La hora de inicio en UTC, en formato ISO 8601; por ejemplo, 2026-11-04T15:00:00.000Z."  `endDate` (cadena, obligatorio): "La hora de finalización en el mismo formato. Usa una hora después del inicio, salvo que el servicio solicitado dure más."  `color` (cadena, obligatorio): "Siempre el valor exacto `blue`."  `note` (cadena, obligatorio): "El nombre y número de teléfono de quien llama, el año, la marca y el modelo del vehículo, y lo que necesita." |
| **Asignar a agentes**        | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

Selecciona **Enable**.

### Pruébalo

[Prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) reservando un cambio de aceite. Comprueba que la cita aparezca en tu calendario de Shopmonkey a la hora local correcta.

`color` debe ser uno de estos valores: `aqua`, `black`, `blue`, `brown`, `gray`, `green`, `orange`, `purple`, `red` o `yellow`. Usa un color que tu equipo no emplee para otras citas, para que las reservas por teléfono destaquen.

## Limitaciones

* La búsqueda de clientes de Shopmonkey recibe una lista de números de teléfono, que las herramientas de webhook no pueden enviar. Por tanto, tu recepcionista no puede buscar a quienes llamen ni vincular la cita a un registro de cliente o vehículo. La nota incluye los datos de quien llama en su lugar.
* La herramienta no puede reprogramar ni cancelar citas. Para ello se necesita el ID de la cita en la URL.

## Solución de problemas

| Problema                                 | Qué comprobar                                                                                                                                       |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| 401 de Shopmonkey                        | El encabezado debe ser `Bearer ` seguido de una clave vigente, con un espacio después de `Bearer`.                                                  |
| Las citas aparecen a una hora incorrecta | Las horas deben estar en UTC. Añade la zona horaria de tu taller a las instrucciones de la recepcionista para que haga la conversión correctamente. |
| Error 400 relacionado con `color`        | Usa uno de los nombres de color de Shopmonkey, en minúsculas.                                                                                       |
| La cita no tiene datos del cliente       | Haz que la descripción indique a la recepcionista que primero recopile el nombre, número y vehículo de quien llama.                                 |