Aprovisionamiento e incorporación
Ejemplos para crear espacios de trabajo de clientes y completar la información que conoce su recepcionista.
Estos ejemplos se basan en el inicio rápido. Usan el mismo cliente, Bright Smile Dental, y todas las llamadas al espacio de trabajo incluyen su ID en xi-workspace-id.
Aprovisionar espacios de trabajo
Aprovisionar en una solicitud
Cuando todavía no tengas los datos del negocio, crea el espacio de trabajo, suscríbelo, invita al propietario y completa la incorporación en una sola llamada. La recepcionista se crea solo a partir del nombre del negocio, así que completa el perfil del negocio después. Pasa una idempotency_key para que un reintento tras un tiempo de espera no pueda crear un segundo espacio de trabajo.
La incorporación durante la creación se realiza según el mejor esfuerzo: si falla, onboarding_completed_at_unix es null y puedes reintentarlo con complete_onboarding.
Aprovisionar clientes desde tu CRM
Deriva cada idempotency_key de tu propio ID de cliente para que, al ejecutar la importación de nuevo, se devuelvan los espacios de trabajo que ya creó en vez de crear otros nuevos. La misma clave con un cuerpo diferente se rechaza con idempotency_key_reused.
Completar la incorporación de espacios de trabajo que aún están en configuración
workspaces.list muestra qué espacios de trabajo no han terminado la incorporación. Se puede reintentar complete_onboarding con seguridad, por lo que puedes ejecutarlo de forma programada.
Describir el negocio
Añade las ubicaciones, el personal, los servicios y los cierres del negocio antes de completar la incorporación para que la recepcionista se cree a partir de ellos. También puedes añadirlos o modificarlos en cualquier momento después.
Hasta que se complete la incorporación, el asistente de configuración que ve el propietario del negocio al iniciar sesión puede sustituir o eliminar estos datos. Completa la incorporación antes de que el propietario inicie sesión.
Añadir una ubicación
Cada ubicación tiene su propio horario. Los días van de 0 (lunes) a 6 (domingo), y un día sin entrada está cerrado.
Añadir un miembro del personal
Un miembro del personal en una ubicación sigue el horario de esa ubicación, a menos que le asignes su propio working_hours. customer_facing_name es lo que escuchan quienes llaman; name se mantiene como etiqueta interna.
Añadir servicios
Un servicio tiene una o más variants, cada una con su propia duración y precio; la primera es la predeterminada. Configura any_staff_member como false para limitar quién puede prestarlo.
Cuando el precio depende del trabajo, usa pricing_mode="quote" y añade intake_questions. La recepcionista las pregunta y recibe una solicitud de presupuesto en lugar de indicar un precio.
Cerrar por vacaciones
Un cierre cubre días completos, desde start_date hasta end_date. Usa time_off_type="location" para el negocio o "staff" con el ID del miembro del personal en resource_id para la ausencia de una persona.
Subir un documento
Proporciona a la recepcionista un documento del que pueda responder, como unas preguntas frecuentes o una lista de precios. Usa knowledge_sources.add_url para un sitio web, como en el inicio rápido.
Configurar la recepcionista
Estas llamadas necesitan el ID de la recepcionista: customer_facing_agent_id de complete_onboarding o agent_id de receptionists.list.
Configurar el saludo, los idiomas y qué recopilar
Solo cambian los ajustes que envíes.
Transferir llamadas y añadir reglas
Una regla de transferencia pasa la llamada a una persona cuando se cumple su condition. Las transferencias dependen del plan: primero comprueba is_transfer_allowed en la recepcionista. Una regla indica a la recepcionista cómo debe comportarse; una regla strict se sigue siempre y una suggestion sirve de orientación.
Invitar al equipo
Invita a personas en cualquier momento después de crear el espacio de trabajo. Una invitación pendiente ocupa una plaza, por lo que se rechaza una invitación cuando los miembros y las invitaciones alcanzan el tamaño de equipo del plan.