Integração com Acuity Scheduling
O HiLucy integra-se com o Acuity Scheduling para permitir que você ofereça serviços e experiências baseados em horários que os hóspedes podem reservar diretamente. Seja tratamentos de spa, passeios guiados, reservas de restaurante ou excursões privadas, o Acuity cuida do agendamento enquanto o HiLucy cuida da experiência do hóspede.
Como Funciona
A integração sincroniza os dados da sua conta Acuity no banco de dados do HiLucy, tornando seus serviços disponíveis através do Portal do Hóspede e do LucyAI:
- Você configura tipos de agendamento, calendários e produtos no Acuity Scheduling
- O HiLucy sincroniza esses dados em tabelas locais do banco de dados para recuperação rápida
- Os hóspedes descobrem atividades através da aba Explorar ou perguntando ao LucyAI
- O LucyAI pode buscar e reservar atividades em nome dos hóspedes durante a conversa
Configurando a Integração
1. Obtenha suas Credenciais do Acuity
Na sua conta do Acuity Scheduling, navegue até Integrações > API e anote:
- User ID -- seu identificador de conta do Acuity
- API Key -- a chave secreta para autenticação da API
Cada propriedade (listagem) no HiLucy pode ter suas próprias credenciais do Acuity, permitindo que diferentes propriedades ofereçam diferentes catálogos de atividades.
2. Configure no HiLucy
No administrador do WordPress, edite sua listagem e localize o metabox Acuity Integration:
- Ativar Acuity -- ative a integração para esta listagem
- User ID -- insira seu User ID do Acuity
- API Key -- insira sua API Key do Acuity
Salve a listagem para armazenar as credenciais.
3. Sincronize seus Dados
Clique no botão Sync Now no metabox do Acuity Integration. O HiLucy buscará dados da API do Acuity e preencherá três tabelas locais:
- Appointment Types -- seus serviços (ex.: "Massagem de 60 Minutos", "Passeio ao Pôr do Sol")
- Calendars -- seus calendários de disponibilidade (ex.: "Calendário Spa", "Calendário Passeios")
- Products -- pacotes adicionais e extras vinculados aos tipos de agendamento
A sincronização normalmente é concluída em poucos segundos. Você pode ressincronizar a qualquer momento para obter as alterações feitas no Acuity.
4. Configuração de Webhooks
O HiLucy fornece um endpoint de webhook em /hilucy/v1/acuity-webhook para atualizações em tempo real. Configure esta URL na sua conta do Acuity em Integrações > Webhooks para receber notificações instantâneas quando agendamentos forem feitos, reagendados ou cancelados.
Fluxo de Reserva do Hóspede
Uma vez sincronizadas, as atividades aparecem na aba Explorar do Portal do Hóspede. O processo de reserva funciona assim:
- O hóspede navega pelas atividades disponíveis ou pergunta ao LucyAI "O que posso fazer hoje?"
- Lucy pesquisa seus tipos de agendamento sincronizados e apresenta opções correspondentes com disponibilidade
- O hóspede seleciona um horário e confirma a reserva
- O Acuity cria o agendamento e envia confirmação tanto para o hóspede quanto para o provedor
O LucyAI usa três ferramentas dedicadas para lidar com este fluxo: buscar atividades disponíveis, obter informações detalhadas sobre uma atividade específica e concluir a reserva -- tudo através de conversa natural.
Configuração por Listagem
Como cada listagem armazena suas próprias credenciais do Acuity, você pode:
- Oferecer diferentes atividades por propriedade -- uma vila à beira-mar mostra esportes aquáticos enquanto uma cabana na montanha mostra trilhas
- Usar diferentes contas do Acuity -- se você trabalha com múltiplos provedores de atividades, cada listagem pode se conectar a uma conta diferente
- Ativar seletivamente -- apenas ative o Acuity para listagens onde você tem atividades para oferecer
Gerenciamento de Dados Sincronizados
Todos os dados sincronizados são armazenados localmente para acesso rápido:
| Tabela | Conteúdo | |--------|----------| | Appointment Types | Nome do serviço, duração, preço, descrição, categoria | | Calendars | Nome do calendário, fuso horário, tipos de agendamento associados | | Products | Pacotes adicionais, preços, tipos de agendamento vinculados |
Alterações feitas no Acuity (novos serviços, preços atualizados, calendários removidos) são refletidas no HiLucy após a próxima sincronização. Use o botão Sync Now ou aguarde o webhook acionar uma atualização automática.