
# Trafft

> **¿Para quién es esto?** Esta integración es para empresas de citas que ya gestionan su agenda en Trafft: salones, barberías, clínicas, estudios, consultores, talleres de reparación. Si no usas Trafft, puedes omitir esta página.
>
> ¿Usas un sistema de programación diferente? Cualquier herramienta con una API puede conectarse: consulta [Conectar una herramienta que no listamos](connecting-other-tools.md), donde se cubren las funciones personalizadas, la API y los webhooks.

Trafft es una plataforma de programación para empresas que venden tiempo: configuras tus servicios, tu personal y tus ubicaciones, y los clientes reservan un espacio. Conectar Trafft a <span data-t="appName">Your AI Connector</span> permite que tu agente de IA gestione toda la reserva dentro del chat (verificando qué está realmente libre, reservándolo y confirmando la hora) en lugar de enviar a alguien a un enlace de reserva esperando que termine el proceso.

---

## Qué hace Trafft

Trafft ofrece a una empresa de citas:

- Servicios con su propia duración y precio
- Personal (empleados) con sus propios horarios de trabajo
- Una o más ubicaciones
- Un sitio web de reservas y calendario para tu equipo

Al conectar Trafft a <span data-t="appName">Your AI Connector</span>, esa misma agenda se convierte en algo con lo que tu IA puede trabajar en WhatsApp, SMS, Instagram o el chat de tu sitio web. La IA lee tus servicios y personal, comprueba la disponibilidad real en Trafft y escribe la reserva directamente en Trafft, por lo que lo que tu equipo ve en Trafft es siempre la realidad.

---

## Conectar Trafft

> **Antes de empezar:** necesitas acceso a la API en Trafft, que forma parte del plan Business de Trafft. Abre tu panel de administración de Trafft y busca **Features & Integrations → API & Connectors**. Si esa página no aparece, tu plan de Trafft aún no lo incluye y no se puede realizar la conexión.

1. En la barra lateral izquierda, haz clic en **Settings** (icono de engranaje).
2. En la barra lateral de Settings, bajo el grupo **Integrations**, haz clic en **Booking & Calendar**.
3. Busca la tarjeta de **Trafft** y haz clic en **Connect**.


4. Rellene la **Dirección de la empresa**. Es la parte que precede a `.admin.trafft.com` en la dirección con la que inicia sesión; si inicia sesión en `acme.admin.trafft.com`, escriba `acme`. También puede pegar la dirección completa; nosotros extraeremos la parte correcta. **¿Cuenta de Trafft de marca blanca?** Si su dirección de Trafft termina en `.admin.wlbookings.com` (la dirección que Trafft asigna a las cuentas creadas bajo el plan de marca blanca de una agencia), pegue la dirección completa, p. ej., `acme.admin.wlbookings.com`; eso nos indica dónde reside su Trafft. Escribir solo `acme` buscaría su cuenta en la dirección estándar de Trafft, que es una cuenta diferente.
5. Rellene su **ID de cliente** y **Secreto de cliente**. Ambos se encuentran en su panel de administración de Trafft en **Funciones e integraciones → API y conectores**.
6. Opcionalmente, añada una **Etiqueta**: un nombre para su propia lista, útil si gestiona varios negocios.
7. Haga clic en **Conectar**.


### Verificación de credenciales

No se guarda nada hasta que Trafft lo confirma. Cuando haces clic en **Connect**, iniciamos sesión en Trafft con lo que escribiste y leemos tu configuración. Una dirección de empresa incorrecta, un Client ID o Secret erróneo, o un plan de Trafft sin acceso a la API se rechazan al instante, mostrando el motivo en pantalla; así nunca terminarás con una conexión que parece correcta pero falla la primera vez que un cliente solicita una cita.

Cuando funciona, la fila conectada muestra la dirección de su empresa junto con cuántos **servicios** y cuántos **miembros del personal** hemos encontrado en Trafft. Ese recuento es la prueba de que la cuenta correcta está conectada: si dice dos servicios y usted ofrece veinte, ha conectado la incorrecta.

Su Client Secret se almacena cifrado y nunca se vuelve a mostrar, ni a usted ni a su equipo. ¿Lo ha perdido? Genere uno nuevo en Trafft y conéctese de nuevo.

### Pausar o desconectar

La fila de Trafft conectada tiene sus propios botones en la página de Reservas y Calendario:


- **Actualizar** vuelve a leer los recuentos de sus servicios y personal desde Trafft (consulte [Agregar o cambiar servicios más adelante](#adding-or-changing-services-later)).
- **Pausar** detiene la reserva de su IA en Trafft mientras mantiene la conexión configurada. **Activar** la vuelve a encender. Úselo mientras reorganiza sus servicios o durante un período de cierre.
- **Desconectar** elimina la conexión por completo. Las citas que ya están en Trafft se dejan exactamente como están; desconectar nunca cancela ni elimina nada en su calendario de Trafft. Puede volver a conectarse más tarde con los mismos detalles.

---

## Indicar a su agente de IA que reserve con Trafft

Conectar Trafft aún no cambia lo que hace su IA. Apunte un agente hacia ella:

1. Haga clic en **Agentes de IA** en la barra lateral y abra el agente.
2. Vaya al paso **Habilidades de IA** y busque la tarjeta **Reservas**.
3. Active **Permitir que este agente reserve citas**.
4. Haga clic en el selector de proveedor y elija **Trafft** (las opciones de proveedor aparecen justo debajo del interruptor).
5. Haga clic en **Guardar cambios**.


---

## Lo que puede hacer la IA

Con Trafft seleccionado como proveedor, su agente puede hacer todo esto dentro de una conversación normal:

- **Decir a las personas lo que ofrece.** Enumera sus servicios de Trafft con cuánto tiempo lleva cada uno y cuánto cuesta, y puede nombrar a su personal.
- **Comprobar qué está realmente libre.** Solicita a Trafft los horarios abiertos para el servicio que alguien desea, y puede limitarlos a un miembro del personal o una ubicación en particular si el cliente lo solicita. Analiza hasta una semana a la vez, por lo que preguntará a qué día o semana se refiere en lugar de leer todo su calendario.
- **Reservar.** La cita se crea en Trafft en ese mismo momento, como una reserva aprobada, y la IA le dice al cliente la hora confirmada. El cliente se agrega a su lista de clientes de Trafft o se vincula al registro que ya tienen allí mediante su dirección de correo electrónico.
- **Buscar lo que reservaron.** La IA puede decirle a un cliente sus propias citas próximas en Trafft.
- **Cancelar.** Un mensaje ("surgió algo, ¿puedes cancelar el jueves?") y desaparece de su calendario de Trafft.
- **Mover una cita.** La IA reserva la nueva hora primero y solo entonces elimina la anterior, por lo que si la nueva hora resulta estar ocupada, el cliente aún conserva su espacio original.

Cada reserva realizada de esta manera también aparece en su página de **Citas** con Trafft como proveedor, por lo que cuenta como cualquier otra reserva: su [webhook](webhooks.md) de **Cita reservada** se activa y las automatizaciones que comienzan desde una nueva cita se ejecutan como de costumbre. Cualquier recordatorio o correo electrónico de confirmación que envíe Trafft seguirá proviniendo de Trafft, exactamente igual que para una reserva realizada en su sitio web de Trafft.

---

## Agregar o cambiar servicios más tarde

Agregue un servicio en Trafft, cambie un precio, retire uno o incorpore a un nuevo miembro del personal, y no hay nada que activar aquí. Su IA lee su catálogo de Trafft **en tiempo real, en cada conversación de reserva**, por lo que trabaja con lo que Trafft indica en ese momento en lugar de una copia tomada cuando se conectó. Un servicio que agregó esta mañana puede reservarse esta tarde.

Vale la pena conocer dos cosas:

- **Los recuentos en la fila conectada son de cuando se realizó la conexión.** Los números de servicios y personal que se muestran en la fila de Trafft en la página **Reservas y Calendario** son los que encontramos al verificar sus credenciales, por lo que no cambian por sí solos a medida que crece su menú de Trafft. Haga clic en **Actualizar** en esa fila para leerlos de nuevo. Solo actualiza esos números; la IA estaba leyendo su catálogo en tiempo real de todos modos.
- **Si su asistente dice alguna vez que un servicio no existe, pídale que enumere sus servicios.** Eso hace que vuelva a buscar el catálogo y responda a partir de la lista actualizada. Si el servicio aún no aparece, realmente no está en la cuenta de Trafft que conectó; verifique que conectó la correcta (los recuentos en la fila son el indicador más rápido).

---

## Información útil

- **Una cancelación elimina la cita en Trafft.** La API de Trafft la elimina en lugar de marcarla como cancelada, por lo que una reserva cancelada desde un chat no deja ninguna fila de "cancelada" en su calendario de Trafft. Si desea mantener un registro de las cancelaciones, anótelas en otro lugar.
- **La IA se mantiene en su propio ámbito.** Solo ve y cambia las citas que se reservaron en esa conversación, o que pertenecen al contacto con el que está hablando. No puede leer ni mover las reservas de nadie más.
- **Una reserva necesita una dirección de correo electrónico y un nombre.** Trafft identifica a los clientes por correo electrónico, por lo que la IA solicita lo que aún falte antes de realizar la reserva.
- **Las reservas grupales aún no son compatibles.** Una persona por cita: los invitados adicionales o los tamaños de grupo no se pueden enviar a Trafft en este momento.
- **Los pagos permanecen en Trafft.** La IA indica el precio pero nunca realiza un cobro, y no puede enviar un enlace de pago: la API de Trafft no expone facturas ni enlaces de pago, por lo que no hay nada que pueda obtener. Si un servicio debe pagarse por adelantado o requiere un depósito, active un método de pago en línea en Trafft y agregue el marcador de posición del enlace de pago de Trafft (configuración de notificaciones por correo electrónico/SMS → el menú desplegable **Cita**) a la notificación de **Cita aprobada**. La confirmación que Trafft envía después de cada reserva que realiza la IA incluirá entonces el enlace para pagar el monto total o el depósito. La reserva en sí se crea sin un paso de pago, por lo que se aprueba independientemente de si se ha pagado o no. ¿Desea el enlace en el chat mismo? Agregue su propio enlace de pago (Stripe, PayPal, cualquier página de pago) a la base de conocimientos o instrucciones del Agente con una nota sobre cuándo enviarlo, y la IA lo compartirá cuando un cliente necesite pagar.
- **Una cuenta de Trafft por cuenta de <span data-t="appName">Your AI Connector</span>.** Si administra varios negocios en cuentas de Trafft separadas, conecte aquella en la que su Agente deba realizar las reservas.
- **Las cuentas de Trafft de marca blanca funcionan de la misma manera.** Una cuenta cuya dirección termina en `.admin.wlbookings.com` (el plan de marca blanca de Trafft) se conecta exactamente igual que una estándar: pegue la dirección completa como la dirección de la empresa. El ID de cliente y el Secreto de cliente siguen proviniendo de la propia página de **Funciones e integraciones → API y conectores** de esa cuenta, por lo que aún necesita acceso a la API en su plan de Trafft.

---

## Próximos pasos

- [Agentes de IA](../ai-agents/ai-agents.md): configure el agente que tomará las reservas.
- [Sistema de reservas](../appointments/booking-system.md): cómo funcionan las citas en toda la aplicación y dónde aparecen.
- [Base de conocimientos](../ai-automation/faq-management.md): agregue sus precios, políticas, estacionamiento y reglas de cancelación para que la IA también pueda responder sobre la reserva.
