Integração Monday.com
O HiLucy integra-se com o Monday.com para trazer rastreamento de tarefas operacionais, automação de workflows com IA e sincronização de status em tempo real ao seu fluxo de trabalho de hospitalidade. Solicitações de serviço dos hóspedes, tarefas de manutenção e operações internas fluem para quadros Monday.com para visibilidade total da equipe.
O Que é Sincronizado
| Dado | Direção | Descrição | |------|---------|-----------| | Solicitações de serviço | HiLucy -> Monday | Solicitações de hóspedes capturadas pelo LucyAI se tornam itens Monday | | Status de tarefas | Bidirecional | Mudanças de status sincronizam entre HiLucy e quadros Monday | | Atualizações de itens | Monday -> HiLucy | Notas da equipe e transições de status fluem via webhooks | | Gatilhos de workflow | HiLucy -> Monday | Agentes de IA criam tarefas e rastreiam progresso nos quadros |
Passos de Configuração
1. Conectar via OAuth
No seu administrador WordPress:
- Vá em Settings -> Bug Reporter (a página de configurações do Monday.com)
- Insira seu Client ID e Client Secret do Monday.com
- Clique em Connect to Monday.com
- Autorize o HiLucy no fluxo OAuth do Monday.com
Uma vez conectado, seu token de acesso é armazenado com segurança e renovado automaticamente.
2. Configure seu Quadro
O HiLucy trabalha com um quadro designado do Monday.com para gestão de tarefas. O quadro padrão é pré-configurado, mas você pode apontar para qualquer quadro atualizando o board ID nas configurações. Seu quadro deve incluir colunas para:
- Status -- Status da tarefa (Backlog, In Progress, Done, etc.)
- Priority -- Urgência da tarefa
- Category -- Tipo de solicitação (limpeza, manutenção, concierge, etc.)
- Assignee -- Membro da equipe responsável
3. Configurar Webhooks (Opcional)
Para sincronização bidirecional, configure um webhook do Monday.com que notifique o HiLucy quando os status dos itens mudam. Isso habilita o padrão de "portão humano" onde aprovações da equipe no Monday acionam ações downstream no HiLucy.
Como Funciona
Fluxo de Solicitação de Serviço
- Um hóspede envia uma mensagem ao LucyAI com uma solicitação (ex.: "Preciso de toalhas extras no quarto 204")
- LucyAI captura os detalhes e cria uma solicitação de serviço no HiLucy
- A solicitação é enviada ao seu quadro Monday.com como um novo item
- A equipe vê no quadro Kanban, atribui e atualiza o status
- Mudanças de status sincronizam de volta ao HiLucy para notificar o hóspede
Monday Bridge
O Monday Bridge é um conjunto de endpoints REST API que permitem ao sistema de agentes do HiLucy interagir com quadros Monday.com programaticamente. Suporta:
- Criar tarefas -- Agentes enviam novos itens aos quadros com metadados completos
- Sincronizar status -- Enviar atualizações de status do HiLucy para Monday
- Ler itens -- Consultar detalhes e atualizações recentes
- Listar itens -- Filtrar itens por status para visualizações do dashboard
- Fluxos de aprovação -- Criar e resolver portões de aprovação para processos humano-no-loop
Solução de Problemas
Tarefas não aparecem no quadro?
- Verifique se a conexão OAuth está ativa nas Configurações
- Confirme que o board ID corresponde ao seu quadro alvo
- Verifique o log de debug do WordPress para erros GraphQL do Monday.com
Status não sincroniza de volta?
Certifique-se de que o webhook do Monday.com está configurado e apontando para o endpoint REST API do seu site. A URL do webhook deve ser: https://seu-site.com/wp-json/hilucy/v1/monday-bridge/status-webhook
Token OAuth expirado?
Se você vê erros "no_token", reconecte via Settings -> Bug Reporter -> Connect to Monday.com. O fluxo OAuth emitirá um token novo.