Visão geral
Tudo o que uma automação pode fazer, com todos os campos por ação
Última atualização em
As ações são os passos que realmente fazem algo. Encontra-as na lista de passos, nos grupos Tarefas, Documentos, Hóspedes e mensagens, Faturas e pagamentos, Acesso e dispositivos e Integrações. Os passos do grupo Lógica controlam o próprio fluxo. Esses estão em Condições, desvios e atrasos. Todas as ações são executadas pelo utilizador Fluxo de trabalho da sua organização.
| Grupo | Ação | O que faz |
|---|---|---|
| Tarefas | Criar tarefa | Cria uma tarefa, eventualmente com subtarefas, num quadro e associada a cliente, terreno ou fatura |
| Tarefas | Definir estado | Altera o estado de uma tarefa existente |
| Tarefas | Procurar tarefa | Procura uma tarefa pelo título e continua por Encontrada ou Não encontrada |
| Tarefas | Definir prioridade da tarefa | Aumenta, diminui ou escolhe a prioridade de uma tarefa existente |
| Tarefas | Atualizar tarefa | Muda o nome de uma tarefa, adiciona pessoas ou etiquetas ou adia o prazo |
| Tarefas | Eliminar tarefa | Elimina uma tarefa, por exemplo a tarefa que este fluxo criou |
| Documentos | Encontrar documento | Procura o documento mais recente de um cliente e continua por Encontrada ou Não encontrada |
| Documentos | Atualizar documento | Altera o tipo de um documento, ou arquiva-o ou restaura-o |
| Hóspedes e mensagens | Enviar mensagem a um hóspede | Envia um texto próprio a um cliente por e-mail, SMS ou WhatsApp |
| Hóspedes e mensagens | Notificar colegas | Envia aos colegas uma notificação push ou um e-mail |
| Hóspedes e mensagens | Adicionar um comentário | Coloca um comentário nos registos do evento ou numa tarefa |
| Hóspedes e mensagens | Responder na caixa de entrada | Envia uma resposta numa conversa da caixa de entrada |
| Hóspedes e mensagens | Etiquetar ou arquivar conversa | Adiciona etiquetas a uma conversa da caixa de entrada ou arquiva-a |
| Hóspedes e mensagens | Atualizar cliente | Altera o estado de um cliente ou adiciona uma nota |
| Hóspedes e mensagens | Check-in, check-out ou cancelar | Põe uma reserva no seu estado seguinte |
| Faturas e pagamentos | Enviar lembrete de pagamento | Envia ao cliente o lembrete de pagamento de uma fatura |
| Faturas e pagamentos | Sincronizar transações bancárias | Obtém novas transações bancárias antes de o fluxo continuar |
| Faturas e pagamentos | Desativar lembretes automáticos para o cliente | Ignora todas as faturas de um cliente nos lembretes automáticos |
| Faturas e pagamentos | Desativar lembretes automáticos para a fatura | Retira uma fatura dos fluxos de lembrete automático |
| Faturas e pagamentos | Enviar fatura | Envia uma fatura ao cliente |
| Faturas e pagamentos | Lançar fatura | Lança uma fatura rascunho |
| Faturas e pagamentos | Imprimir fatura | Imprime uma fatura ou mostra-a num tablet |
| Faturas e pagamentos | Criar link de pagamento | Cria um link de pagamento online para o que ainda está em aberto |
| Faturas e pagamentos | Pedir mandato SEPA | Pede a um cliente que assine um mandato, ou envia um lembrete |
| Faturas e pagamentos | Cobrar por débito direto | Cobra o que está em aberto com o mandato ativo do cliente |
| Faturas e pagamentos | Faturar consumo | Fatura o consumo de contador em aberto de um cliente |
| Faturas e pagamentos | Rascunho de fatura de prolongamento | Cria um rascunho de fatura que prolonga uma ocupação |
| Acesso e dispositivos | Criar método de acesso | Dá acesso a um cliente por código QR, matrícula, PIN ou NFC |
| Acesso e dispositivos | Atualizar acesso | Bloqueia, desbloqueia ou prolonga meios de acesso |
| Acesso e dispositivos | Enviar ou imprimir código QR | Envia um código de acesso QR ao cliente ou imprime-o |
| Acesso e dispositivos | Abrir ou fechar cancela | Abre ou fecha uma cancela ou portão |
| Acesso e dispositivos | Ligar ou desligar energia | Liga ou desliga a eletricidade de um contador inteligente |
| Acesso e dispositivos | Atualizar etiquetas NFC | Bloqueia, desbloqueia ou recarrega etiquetas NFC de um cliente |
| Acesso e dispositivos | Controlar tablet ou quiosque | Acorda um tablet ou quiosque, põe-no em modo de suspensão ou recarrega-o |
| Acesso e dispositivos | Definir apresentação | Coloca fotografias em tablets e quiosques, a partir de uma lista ou de um pedido anterior |
| Integrações | Enviar webhook | Entrega uma mensagem própria a um dos seus endpoints de webhook |
| Integrações | Pedido à API | Chama a Tillor API ou outro site |
Em todos os campos de texto pode usar variáveis, como {invoice.displayId}. No canto superior direito de cada campo há um botão Variável para inserir uma. Os campos onde é pedido um cliente, fatura ou outro registo esperam o id interno desse registo, como {invoice.id}. Um número de fatura ou um nome não funciona.
Saídas de uma ação
Por baixo de um passo há uma ou mais saídas. Liga cada saída a um passo seguinte. Se deixar uma saída por ligar, a execução termina aí.
| Saída | Em que ações | Quando |
|---|---|---|
| Seguinte | A maioria das ações | O passo teve êxito |
| Concluído e Ignorado | Ações que por vezes não têm nada a fazer | Concluído se o passo fez o seu trabalho. Ignorado se não havia nada a fazer, por exemplo porque a fatura já estava lançada. Isso não é um erro |
| Encontrada e Não encontrada | Procurar tarefa | Se a tarefa existe |
| Encontrada e Não encontrada | Encontrar documento | Se o cliente tem um documento desses |
| Sucesso e Falhou | Enviar webhook e Pedido à API | Se o outro lado aceitou a mensagem |
Concluído e Ignorado existem em Enviar mensagem a um hóspede, Check-in, check-out ou cancelar, Lançar fatura, Criar link de pagamento, Pedir mandato SEPA, Cobrar por débito direto e Faturar consumo. Em cada uma delas, por baixo da ação indica-se quando um passo é ignorado.
Continuar quando este passo falha
Se uma ação correr mal, a execução pára normalmente com o estado Falhou. Se quiser decidir você o que acontece nesse caso, ligue no fim das definições do passo Continuar quando este passo falha. Isso é possível em qualquer ação exceto Enviar webhook e Pedido à API, que já têm uma saída própria Falhou.
O passo passa então a ter uma saída extra Erro. Se a ação falhar, o fluxo continua por Erro em vez de parar. Os passos seguintes podem usar estas variáveis:
| Variável | Conteúdo |
|---|---|
{error.message} | A mensagem de erro. Pode estar em inglês |
{error.step} | O nome do passo que falhou, tal como o preencheu em Nome do passo |
Algumas coisas a saber:
- Se a ação teve êxito ou foi ignorada, nada muda e Erro não é usado
- Se deixar Erro por ligar, a execução termina aí sem mais passos. A execução fica então com o estado Concluída, mas o próprio passo aparece no separador Execuções com a sua mensagem de erro
- Um segundo passo falhado no mesmo fluxo substitui
{error.message}e{error.step}do primeiro
Um exemplo: deixe Enviar mensagem a um hóspede continuar se falhar e crie por Erro uma tarefa com {error.message} na descrição. Assim, um colega trata ele próprio da conversa com o hóspede.
Quando um passo falha
Há três formas de uma falha decorrer.
- Uma saída Falhou. Acontece em Enviar webhook e Pedido à API quando o outro lado devolve um erro. O fluxo continua pela saída Falhou. Ligue-a a um seguimento, como uma tarefa para um colega. Se deixar a saída por ligar, a execução simplesmente termina aí
- Uma saída Erro. Se ligar Continuar quando este passo falha noutra ação, o passo passa a ter uma saída Erro e pode usar
{error.message}para saber o motivo. Veja Continuar quando este passo falha - O passo pára a execução. Se faltar um valor depois de as variáveis serem preenchidas, se uma fatura não puder ser enviada, se um endpoint já não existir ou se o JSON for inválido, a execução fica com o estado Falhou. Os passos seguintes não são executados e o Tillor não repete o passo. Isto só acontece se não tiver ligado Continuar quando este passo falha
A mensagem de erro aparece no passo, no separador Execuções. Essas mensagens podem estar em inglês.
Não perder falhas
Quer que uma falha nunca passe despercebida? Ligue a saída Falhou de um Pedido à API ou Enviar webhook, ou a saída Erro de outra ação, a um passo Criar tarefa. Assim, um colega pode tratar do assunto.