Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.trellistech.com/llms.txt

Use this file to discover all available pages before exploring further.

Pare de fazer as mesmas coisas repetidamente

Todo administrador de propriedades tem tarefas que repete dezenas de vezes por semana: enviar instruções de check-in, criar tarefas de limpeza após o checkout, notificar a equipe sobre um problema. As automações cuidam disso para você - de forma confiável, todas as vezes.

O que você pode automatizar?

Mensagens para hóspedes

Envie instruções de check-in, lembretes de checkout, solicitações de avaliação e acompanhamentos - programados automaticamente para cada reserva.

Criação de tarefas

Crie tarefas específicas por departamento quando eventos específicos acontecerem - como um checkout de hóspede ou uma nova reserva.

Alertas de escalação

Notifique gerentes imediatamente quando algo precisar de atenção humana - uma reclamação, uma solicitação de reembolso ou uma conversa que a IA não consegue lidar.

Resumos operacionais

Envie resumos programados de reservas, escalações e tarefas que precisam da atenção da equipe.

Notificações da equipe

Alerte sua equipe quando tarefas forem atribuídas, conversas forem escaladas ou problemas urgentes chegarem.

Atualização de dados

Atualize automaticamente registros, mude status ou marque conversas com base em condições que você definir.

Como as automações funcionam

Cada automação tem três partes: um gatilho (o que a inicia), condições opcionais (quando deve executar) e ações (o que faz).

Gatilhos - o que inicia a automação

A automação executa quando algo acontece no Trellis:
  • Uma nova reserva é criada
  • Um hóspede faz check-in ou checkout
  • Uma conversa é escalada
  • Uma tarefa é concluída
  • Uma nova mensagem chega
Este é o tipo mais comum. Por exemplo: “Quando um hóspede fizer checkout, criar uma tarefa de limpeza.”

Condições - quando deve executar

Adicione condições para tornar suas automações mais inteligentes. Por exemplo:
  • Só criar uma tarefa de limpeza se o checkout for em uma propriedade específica
  • Só enviar uma mensagem de check-in se a reserva estiver confirmada (não cancelada)
  • Só escalar se o hóspede mencionou uma palavra-chave específica
Condições permitem construir uma automação que lida com múltiplos cenários de forma inteligente.

Ações - o que faz

Ações são os passos que sua automação executa. Você pode encadear múltiplas ações:
AçãoO que faz
Enviar uma mensagemEnviar uma mensagem com template para um hóspede, proprietário ou fornecedor por qualquer canal
Criar uma tarefaCriar uma tarefa específica por departamento com todos os detalhes pré-preenchidos
Atualizar um registroMudar o status, responsável ou qualquer campo em uma propriedade, reserva, tarefa ou conversa
Notificar sua equipeEnviar uma notificação para membros específicos da equipe ou funções
EsperarPausar a automação por um tempo determinado, até uma data específica ou até algo acontecer
Pedir aprovaçãoPausar e pedir a um gerente para revisar antes de continuar - perfeito para ações de alto impacto
Executar o agente de IAFazer o agente de IA analisar uma situação, redigir uma resposta ou tomar uma decisão
Quando você adiciona um passo de agente de IA com saída estruturada, o Trellis valida sua configuração antes de salvar. Ele verifica se os valores de timeout são longos o suficiente, se qualquer contexto referenciado está disponível e se variáveis de loop só são usadas dentro de loops. Corrija quaisquer avisos para evitar falhas inesperadas em tempo de execução.

Aprovação humana no fluxo

Algumas automações não devem executar completamente no piloto automático. O passo de aprovação pausa o fluxo de trabalho e pede a um membro da equipe para revisar antes de continuar.
1

A automação chega ao passo de aprovação

O fluxo de trabalho pausa e cria uma solicitação de aprovação visível na sua caixa de entrada.
2

O revisor é notificado

O revisor atribuído recebe uma notificação com todo o contexto necessário para tomar uma decisão.
3

Aprovar ou rejeitar

O revisor aprova a ação (e a automação continua) ou rejeita (e a automação para ou toma um caminho alternativo).
Quando usar aprovações:
  • Antes de enviar mensagens sobre temas sensíveis (reembolsos, mudanças de política)
  • Antes de criar tarefas de manutenção caras
  • Antes de enviar mensagens que incluam dados financeiros sensíveis
  • Quando quiser um ponto de verificação humano em um fluxo que de outra forma seria automático

Começando com templates

Você não precisa construir automações do zero. O Trellis vem com templates pré-construídos para os fluxos de trabalho mais comuns de administração de propriedades:
Gatilho: 24 horas antes do check-in Ação: Enviar ao hóspede suas instruções de check-in, incluindo endereço da propriedade, código da porta, senha do Wi-Fi, informações de estacionamento e regras da casa. Os detalhes da propriedade são inseridos automaticamente.
Gatilho: Hóspede faz checkout Ação: Criar uma tarefa de limpeza para a propriedade, atribuí-la ao membro padrão da equipe de limpeza, anexar o checklist padrão de rotação e definir a data de vencimento para o mesmo dia.
Gatilho: Conversa é escalada (pela IA ou manualmente) Ação: Enviar uma notificação imediata ao gerente de plantão com o resumo da conversa, detalhes do hóspede e um link para a conversa.
Gatilho: Todas as manhãs Ação: Enviar à sua equipe um resumo de reservas, escalações abertas e tarefas que precisam de atenção naquele dia.
Gatilho: 1 dia após o checkout Ação: Enviar ao hóspede uma mensagem amigável agradecendo pela estadia e pedindo que deixe uma avaliação. Só envia se nenhum problema foi escalado durante a estadia.
Gatilho: A IA detecta um problema de manutenção em uma mensagem do hóspede Ação: Criar uma tarefa de manutenção, atribuí-la à pessoa de manutenção de plantão e notificar o administrador da propriedade.

Construindo sua própria automação

O construtor de automações usa um canvas visual onde você pode ver todo o seu fluxo de trabalho de relance. Uma barra lateral retrátil à esquerda permite alternar entre sua lista de fluxos de trabalho e o canvas, dando mais espaço para trabalhar quando necessário.
1

Ir para Automações

Navegue até Automações na barra lateral esquerda e clique em Nova automação.
2

Escolher um gatilho

Selecione o que inicia sua automação - um evento (como um checkout), um cronograma (como toda segunda-feira) ou ativação manual. Clique no nó do gatilho no canvas para configurá-lo no painel de detalhes.
3

Adicionar condições (opcional)

Restrinja quando a automação deve executar. Por exemplo, apenas para propriedades específicas, fontes de reserva ou tipos de hóspedes.
4

Adicionar ações

Defina o que a automação deve fazer. Adicione quantos passos precisar - enviar uma mensagem, criar uma tarefa, esperar, notificar e mais. Clique em qualquer passo no canvas para abrir seu painel de detalhes e configurá-lo. Os passos executam em ordem.
5

Executar agora ou ativar

Quando estiver pronto, clique em Executar agora para executar a automação imediatamente, ou ative-a para execução automática. Use as abas Construtor, Execuções e Versões no topo para alternar entre projetar, monitorar e revisar versões anteriores da sua automação.
O Trellis valida seu fluxo de trabalho quando você salva. Se um passo de condição ou transformação referencia uma entrada que não foi declarada, ou se uma automação agendada usa valores de data e hora sem um fuso horário configurado, você verá um erro imediatamente - para que possa corrigir o problema antes do fluxo de trabalho executar.
Sempre teste uma nova automação com uma única propriedade ou reserva antes de implementá-la em todo o seu portfólio. Isso ajuda a detectar problemas antes que afetem os hóspedes.

Monitoramento de execuções de automação

Depois que uma automação executa, você pode revisar exatamente o que aconteceu na aba de Execuções. Cada execução mostra seu status, os passos que completou e quaisquer erros que ocorreram.

Visualizações de lista e calendário

A aba de execuções oferece duas formas de visualizar seu histórico de automações:
  • Visualização em lista - a tabela padrão mostrando cada execução como uma linha com status, progresso dos passos, tipo de gatilho e timestamps. A lista mostra por padrão as execuções dos últimos 7 dias para que você veja a atividade recente primeiro. Ajuste o intervalo de datas a qualquer momento usando o calendário inline. Ideal para examinar atividade recente e filtrar por status.
  • Visualização em calendário - um calendário mensal que plota as execuções por data. Mude para esta visualização usando o botão no topo da lista de execuções. Use as setas esquerda e direita para navegar entre meses, e clique em qualquer dia para ver as execuções daquela data.
A visualização em calendário é especialmente útil para automações agendadas. De relance você pode confirmar que seus fluxos de trabalho diários ou semanais estão executando nos dias esperados - e identificar lacunas onde uma execução foi perdida.

Filtragem de execuções

Use as opções de filtro no topo da lista de execuções para encontrar execuções específicas rapidamente. Os filtros se aplicam tanto à visualização em lista quanto à de calendário:
  • Status - filtre por execuções na fila, em execução, concluídas, com falha ou canceladas usando as abas de status
  • Intervalo de datas - escolha uma data de início e fim usando o calendário inline. Por padrão, são mostradas as execuções dos últimos 7 dias.
  • Tipo de gatilho - mostre apenas execuções iniciadas por um gatilho específico (evento, agendamento ou manual)
  • Execução de teste - mostre ou oculte execuções de teste (marcadas com um ícone de frasco) para que você possa focar em execuções reais ou revisar resultados de teste separadamente

Detalhes da execução

Clique em qualquer execução para ver um detalhamento passo a passo no canvas. Cada etapa mostra se foi bem-sucedida, falhou ou foi ignorada, junto com seu resultado. Uma coluna de Progresso das etapas na lista de execuções dá um resumo visual rápido de quão longe cada execução chegou antes de ser concluída ou encontrar um erro. Um painel lateral de detalhes abre ao lado do canvas para que você possa inspecionar cada etapa sem perder a visão do fluxo de trabalho completo.

Resumos das etapas

Clique em uma etapa no canvas para abrir seu resumo no painel lateral. Cada tipo de etapa exibe informações adaptadas ao que faz:
  • Etapas de gatilho - exibem o tipo de gatilho (manual, baseado em evento, iniciado por IA ou agendado) e o evento que iniciou a execução
  • Etapas de condição - mostram se a condição foi avaliada como verdadeira ou falsa com um emblema claro
  • Etapas de ação - listam as entidades que a etapa afetou, como reservas, tarefas, propriedades ou contatos
  • Etapas de loop - mostram as entidades sendo iteradas e quantos itens foram processados

Entidades relacionadas

Quando uma etapa envolve reservas, tarefas, propriedades ou contatos, o painel lateral mostra linhas de entidades clicáveis com detalhes-chave de relance - por exemplo, uma linha de reserva exibe o nome do hóspede e as datas de check-in/check-out. Clique em qualquer linha de entidade para ir diretamente a esse registro no Trellis.

Aba de detalhes

Mude para a aba Detalhes no painel lateral para ver informações de execução mais profundas para qualquer etapa. Para etapas que usam o agente de IA, esta aba inclui tempos de resposta e uma linha do tempo em linguagem clara do que o agente fez. Um log de execução no nível da execução na parte inferior mostra cada etapa em ordem cronológica, facilitando revisar a sequência completa de eventos.

Painel lateral de detalhes da execução

Quando você visualiza uma execução, um painel lateral de detalhes abre ao lado do canvas. Ele dá uma imagem completa do que aconteceu sem sair da página. Aba Resumo A aba Resumo mostra de relance o que a automação tocou:
  • Linhas de entidades - reservas, tarefas, propriedades e contatos envolvidos na execução são listados como linhas clicáveis. Cada linha mostra detalhes-chave (como nome do hóspede, datas de check-in e check-out para uma reserva, ou título e status da tarefa) para que você possa identificar rapidamente os registros afetados e clicar para ver mais.
  • Resumo do gatilho - veja o que iniciou a execução: um gatilho manual, uma execução agendada, um gatilho baseado em evento ou uma ação iniciada por IA.
  • Resultados passo a passo - cada etapa exibe seu emblema de tipo, nome, duração e resultado. Etapas de condição mostram se foram avaliadas como verdadeiras ou falsas. Etapas de loop listam as entidades sobre as quais iteraram.
Aba Detalhes A aba Detalhes fornece informações de revisão mais profundas para cada etapa:
  • Log de execução - uma lista cronológica de cada etapa na execução, com carimbos de tempo e durações, para que você possa ver a ordem exata de execução.
  • Tempo da etapa - para etapas com IA, o painel lateral mostra tempos de resposta e detalhes de status. Isso ajuda a entender onde o tempo está sendo gasto e se uma etapa precisa de ajuste.
Os detalhes da etapa são carregados sob demanda - são obtidos apenas quando você expande uma etapa na aba Detalhes, mantendo o painel lateral rápido mesmo para execuções com muitas etapas.

Solução de erros em passos

Quando um passo falha, o Trellis mostra os detalhes do erro diretamente no canvas. Duas ações estão disponíveis em cada passo com falha para ajudar a resolver o problema rapidamente:
  • Pedir à IA para corrigir - o Trellis analisa o erro, explica o que deu errado em linguagem simples e sugere uma correção. Em muitos casos pode aplicar a correção automaticamente, para que você possa reexecutar a automação sem precisar investigar os detalhes.
  • Reportar problema - Se o erro parece ser um bug ou algo que você não consegue resolver sozinho, clique para abrir um diálogo de feedback que já vem pré-preenchido como relatório de bug com os detalhes do erro anexados. Envie diretamente para a equipe de suporte do Trellis - sem necessidade de copiar mensagens de erro ou descrever o que deu errado manualmente.
Tente Pedir à IA para corrigir primeiro - resolve a maioria dos problemas de configuração instantaneamente, como uma referência de campo faltante ou uma condição incorreta. Use Reportar problema quando o erro estiver fora do seu controle ou continuar ocorrendo após uma correção.

Notificações de falha de execução

Quando uma execução de automação falha, o Trellis notifica automaticamente todos os membros do espaço de trabalho para que sua equipe possa responder rapidamente. Notificações de falha aparecem no sino de notificações na barra de navegação superior. Clique em uma notificação de falha para ir diretamente para a visualização de detalhes da execução com falha, onde você pode ver exatamente qual passo falhou e usar as ferramentas de solução de problemas descritas acima.
Notificações de falha são enviadas para todos os membros do espaço de trabalho. Você não precisa configurar nada - elas são habilitadas automaticamente para cada automação.

Cancelamento de uma automação em execução

Se uma automação está atualmente em execução e você precisa pará-la - por exemplo, se foi acionada por engano ou as condições mudaram - você pode cancelá-la diretamente da visualização de detalhes da execução. Clique no botão Cancelar no cabeçalho da execução. Um diálogo de confirmação aparece para garantir que você realmente quis parar a execução. Uma vez cancelada, a execução é marcada com status de cancelada e nenhum passo adicional é executado.

Gestão em massa de automações

Selecione múltiplas automações da lista para habilitá-las, desabilitá-las ou excluí-las em um único passo. Isso é útil quando você precisa pausar todas as automações para uma temporada, limpar fluxos de trabalho antigos ou ativar rapidamente um conjunto de automações para um novo grupo de propriedades.

Dicas para ótimas automações

Comece com os templates

Os templates são testados e cobrem os fluxos de trabalho mais comuns. Personalize-os para corresponder à sua operação em vez de construir do zero.

Use passos de aprovação para ações de alto impacto

Mensagens sobre reembolsos, mudanças de política ou dados financeiros devem sempre ter um passo de revisão humana.

Sobreponha condições para precisão

Quanto mais específicas suas condições, mais inteligentes serão suas automações. Uma automação de limpeza de checkout que só dispara para estadias confirmadas evita tarefas desnecessárias para cancelamentos.

Revise os logs de automação regularmente

Verifique o histórico de execuções para garantir que suas automações estão funcionando como esperado. Procure execuções puladas ou erros que precisam de atenção.

Use execuções de teste para testar com segurança

Execute sua automação em modo de teste antes de ativá-la. Execuções de teste são claramente marcadas com um ícone de frasco para que você possa distingui-las das execuções reais.

Filtre execuções para encontrar problemas rápido

Use os filtros de status, data e tipo de gatilho na aba de Execuções para restringir rapidamente às execuções com falha ou inesperadas.