Shopmonkey | ElevenLabs Documentation

Con una herramienta de webhook, tu recepcionista puede añadir una cita a tu calendario de Shopmonkey cuando alguien llame para llevar su vehículo al taller.

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