Acionadores
Escolha quando uma automação começa, também numa data como a chegada, filtre os casos e limite-a a uma vez por registo
Última atualização em
O acionador é o momento de arranque de uma automação: o "quando". Está no topo de cada fluxo, sob o nome Quando isto acontece. Um exemplo: começar quando uma ocupação termina. Determina também que dados os passos seguintes podem usar. Um fluxo pode ter vários acionadores. Cada acionador inicia uma execução própria, com o seu próprio filtro. Adiciona um a partir da lista à esquerda. O último acionador não pode ser eliminado.
Em que é que a automação começa
Em Começa por escolhe um de sete momentos de arranque.
| Escolha | Começa quando |
|---|---|
| Quando algo acontece | Ocorre um evento no Tillor, como uma ocupação que termina ou uma fatura que é paga |
| Fatura vencida | Uma fatura lançada continua em aberto depois da data de vencimento |
| Webhook recebido | Outro sistema envia uma mensagem para o endereço próprio da automação |
| É escolhida uma ação de tarefa | Alguém escolhe, numa tarefa, um botão de escolha ligado a esta automação |
| Uma data é atingida | É atingida uma data de um registo, eventualmente algum tempo antes ou depois. Por exemplo, um dia antes da chegada de uma reserva |
| Todos os dias a uma hora | Chega, todos os dias, a hora escolhida |
| Segundo uma expressão cron | Chega a vez do calendário que indicar |
Escolhe, portanto, primeiro o tipo de momento de arranque e depois os detalhes. Se escolher outro momento de arranque, os filtros em Apenas quando são esvaziados. Foram escritos para a escolha anterior e já não servem.
Quando algo acontece
Em Evento escolha o que deve iniciar a automação. Clique no campo e escreva para pesquisar, por exemplo occupation ou invoice. Os eventos aparecem na notação do Tillor, como occupation:ended: primeiro aquilo de que se trata, depois o que aconteceu.
Estes são os eventos de que precisa com mais frequência:
| Evento | Começa quando |
|---|---|
occupation:ended | Uma ocupação termina |
reservation:created | É criada uma reserva |
reservation:updated | Uma reserva é alterada |
customer:created | É criado um cliente |
customer:updated | Um cliente é alterado |
invoice:created | É criada uma fatura |
invoice:updated | Uma fatura é alterada |
invoice:paid | Uma fatura é paga |
payment:created | Entra um pagamento |
task:created | É criada uma tarefa |
task:status-changed | O estado de uma tarefa muda |
task:assigned | Uma tarefa é atribuída a alguém |
task:action-chosen | Alguém escolhe um botão de escolha numa tarefa |
integration-alarm:created | Um contador emite um alarme |
comment:created | É publicado um comentário |
document:created | É adicionado um documento |
signatureRequest:updated | Um pedido de assinatura é atualizado |
signatureRequest:completed | Todos os signatários de um pedido de assinatura assinaram |
mandate-agreement:signed | Um cliente assinou um mandato SEPA |
mandate-agreement:activated | Um mandato SEPA ficou ativo |
mandate-agreement:expired | Um pedido de mandato SEPA expirou sem assinatura |
mandate-agreement:failed | A ativação de um mandato SEPA foi recusada ou falhou |
productPriceChange:applied | Entra em vigor um preço de produto agendado |
Esta é a mesma lista dos webhooks. Pode, por isso, usar qualquer evento para o qual o Tillor possa enviar um webhook. Alguns eventos extremamente frequentes, como o estado físico das cancelas, a escrita na caixa de entrada, os registos dos controladores e a presença de veículos, não estão na lista.
Falta um evento?
Sob o campo Evento está a ligação Falta um evento? Peça-o. Veja Pedir um passo ou evento.
Que dados recebe
À maioria dos eventos corresponde um registo, como uma ocupação, uma fatura ou uma tarefa. Esse registo, mais os registos para que remete, ficam depois disponíveis como variáveis nos passos. Em occupation:ended pode usar, por exemplo:
{occupation.terrain.name}para o nome do terreno{occupation.customer.firstName}para o nome próprio do cliente{occupation.reservation.displayId}para o número da reserva. Nem toda a ocupação tem uma reserva: nesse caso fica vazio
Além disso, existem sempre {triggeredBy.name} e {triggeredBy.id}: o colega que causou o evento. Se o evento foi causado pelo sistema, por exemplo por uma sincronização bancária, estes campos ficam vazios.
Sob as definições do acionador está Dados que este evento fornece. Aí vê exatamente que variáveis pode usar. Num evento cujos dados não estão descritos, o Tillor diz que não há nada para escolher. As variáveis que escrever você mesmo continuam a funcionar. Veja Variáveis e modelos.
É escolhida uma ação de tarefa
Algumas tarefas têm botões de escolha em vez de uma marca de verificação, por exemplo a partir de Pedir uma decisão. Um botão pode estar ligado a uma automação. Com este acionador, essa automação começa assim que alguém escolhe esse botão. Veja também Tarefas com botões de escolha.
Ligar um botão a uma automação não se faz no editor de fluxos. Se precisar disto, peça ao administrador do Tillor ou ao suporte.
Os passos recebem os dados da tarefa, por exemplo {task.name} e {task.id}, mais {action.label} (o nome do botão escolhido) e {note} (a nota que o colega preencheu, se o botão a pedia). Em Dados que este evento fornece vê a lista completa.
Fatura vencida
Este acionador começa para cada fatura que:
- está lançada (rascunhos e faturas anuladas não contam)
- não é uma nota de crédito
- ainda tem um montante em aberto
- tem uma data de vencimento anterior a hoje
Para cada uma dessas faturas começa uma execução própria. Os dados da fatura e do cliente estão disponíveis como {invoice.…}, por exemplo {invoice.displayId}, {invoice.amountOutstanding} e {invoice.customer.firstName}.
Se desativar Executar uma vez por registo, a automação começa para a mesma fatura no máximo uma vez por dia enquanto estiver vencida. Se o deixar ativo, começa exatamente uma vez para cada fatura. É normalmente o que quer para um lembrete.
Em A lembrar escolhe há quanto tempo a fatura tem de estar em aberto, a mesma regra da lista de faturas. Ative Ignorar clientes excluídos de avisos automáticos para saltar os clientes que o têm indicado nas suas definições de faturação. Uma fatura que foi ela própria retirada dos lembretes automáticos também não inicia o fluxo.
Webhook recebido
Um webhook é uma mensagem que outro sistema envia para um endereço. Com este acionador, esse sistema inicia a automação, por exemplo o seu site, um formulário ou uma plataforma de reservas. Cada automação recebe um endereço próprio e secreto.
- Em Começa por escolha Webhook recebido
- Guarde a automação. Em Endereço aparece o URL
- Clique em Copiar e configure o endereço no outro sistema
- Ative a automação
O outro sistema envia um POST com JSON para esse endereço. O conteúdo fica depois disponível como {body.…}, por exemplo {body.email} ou {body.reservering.nummer}, e os parâmetros no URL como {query.…}. Com Apenas quando também pode filtrar por esses campos.
Como funciona, em mais pormenor:
- O endereço é o segredo. Quem o conhecer pode iniciar a automação. Partilhe-o, por isso, apenas com o sistema que dele precisa
- Se o endereço vazar, clique em Novo endereço e guarde. O endereço antigo deixa de funcionar a partir daí
- Uma automação desativada ou um endereço errado dá um erro
404 - O conteúdo pode ter no máximo 100 KB
- Cada chamada inicia uma execução por acionador de webhook no fluxo. O endereço pertence ao primeiro acionador de webhook. Novo endereço nesse acionador substitui-o
- Não há nenhum registo associado, pelo que Executar uma vez por registo não tem efeito
Ignorar repetições
Se o outro sistema enviar por vezes a mesma chamada duas vezes, com Ignorar repetições evita que o fluxo comece duas vezes. O Tillor memoriza uma chave da chamada. Se a mesma chave chegar de novo, não começa nada.
| Escolha | O que é a chave |
|---|---|
| Cada chamada inicia o fluxo | Não há chave. Predefinição |
| De um cabeçalho | O valor de um cabeçalho que escolhe em Nome do cabeçalho, por exemplo Idempotency-Key |
| Do corpo JSON | O valor de um campo do JSON, que escolhe em Campo, como id ou data.eventId |
| O mesmo corpo JSON | Todo o conteúdo. Uma chamada com exatamente o mesmo conteúdo conta como repetição |
Em Memorizar a chave durante escolhe durante quanto tempo a chave vale, em horas, dias ou semanas. Passado esse tempo, a mesma chave inicia o fluxo de novo. Com 0, a chave vale até eliminar a automação. Uma chamada sem o cabeçalho escolhido ou sem o campo escolhido é recusada.
Uma data é atingida
Este acionador começa numa data de um registo. Em Data escolhe qualquer campo de data de um registo que o Tillor também envia nos eventos, escrito como registo e campo. Alguns exemplos:
| Data | Registo |
|---|---|
reservation.checkIn | A data de chegada de uma reserva |
reservation.checkOut | A data de partida de uma reserva |
invoice.dueDate | A data de vencimento de uma fatura |
task.dueDate | O prazo de uma tarefa |
occupation.paidUntil | Até quando uma ocupação está paga |
accessMethod.periodTo | O fim da validade de um código QR, matrícula ou outro método de acesso |
nfcTag.activatedUntil | Até quando uma etiqueta NFC está ativada |
mandateAgreement.expiresAt | Quando expira um pedido para assinar um mandato SEPA |
customer.birthday | A data de nascimento de um cliente |
contact.birthday | A data de nascimento de uma pessoa de contacto |
Por predefinição o acionador começa uma vez, na própria data. Ative Repetir todos os anos para que contem apenas o dia e o mês: o fluxo começa então todos os anos de novo, como no aniversário em contact.birthday. Um 29 de fevereiro cai, nos outros anos, a 28 de fevereiro.
Também pode escolher dados guardados num registo como campos adicionais. document.userMetadata.insuranceExpiryDate é a data de validade de um documento, como um comprovativo de pagamento do seguro. Uma data dessas, sem hora, conta como meia-noite (UTC, a hora padrão internacional). Com Apenas quando limita então o acionador a um tipo, por exemplo document.userMetadata.documentType é INSURANCE_PAYMENT_PROOF, e a documentos ativos com document.status é ACTIVE.
Com Quanto tempo e Antes ou depois desloca o momento. 1 dia e Antes em reservation.checkIn inicia o fluxo um dia antes da chegada. Com 0 começa na própria data. Uma data sem hora conta como meia-noite.
Com Hora escolhe a que horas desse dia o fluxo começa. A hora da data usa o momento que está no campo, como a hora de chegada de uma reserva. Hora fixa do dia começa no dia da data à hora e ao minuto que escolher, no fuso horário da sua organização. Assim, contact.birthday com Repetir todos os anos começa todos os anos às 09:00 no dia do aniversário. Quanto tempo conta então a partir dessa hora: 1 dia e Antes começa na véspera às 09:00, mesmo que o relógio mude nessa noite.
Para cada registo começa uma execução própria, com os dados desse registo como variáveis, por exemplo {reservation.displayId} e {reservation.customer.firstName}. Com Apenas quando restringe-o, por exemplo apenas a reservas com o estado lançada.
Como funciona, em mais pormenor:
- Por registo e por momento, o fluxo começa uma vez. Se a data se deslocar para mais tarde, por exemplo porque um hóspede chega mais tarde, começa de novo no novo momento
- Se o momento já tinha passado quando guardou ou ativou a automação, esta já não começa para ele
- Os momentos perdidos, por exemplo durante uma manutenção, o Tillor recupera-os até uma hora depois
Todos os dias a uma hora
Em Hora escolha uma hora (0 a 23) e em Minuto um minuto de 0 a 59. A hora é a do fuso horário da sua organização.
Os passos recebem {now}: o momento em que a execução começou.
Segundo uma expressão cron
Escolha um ritmo, como todos os dias, todas as segundas-feiras às 08:00, ou as segundas-feiras ímpares (a 1.ª, a 3.ª e a 5.ª). Em Personalizado define o intervalo, os dias da semana e a hora, ao minuto. Em Expressão cron escreve você mesmo o calendário.
Uma expressão cron é uma notação curta para uma hora repetida. Tem cinco partes, separadas por um espaço: minuto, hora, dia do mês, mês e dia da semana.
| Expressão | Significado |
|---|---|
0 8 * * 1 | Todas as segundas-feiras às 08:00 |
7 8 * * 1 | Todas as segundas-feiras às 08:07 |
30 7 * * 1-5 | Todos os dias úteis às 07:30 |
0 9 1 * * | No dia 1 de cada mês às 09:00 |
0 8 * * 1#1,1#3,1#5 | Todas as segundas-feiras ímpares (1.ª, 3.ª e 5.ª do mês) às 08:00 |
0 8 * * 1L | A última segunda-feira do mês às 08:00 |
0 8 * * 1 W2:2026-10-05 | De duas em duas semanas, à segunda-feira, às 08:00, a partir da semana de 5 de outubro de 2026 |
*/15 * * * * | A cada quarto de hora |
* * * * * | A cada minuto |
Em cada parte pode usar um número, uma lista com vírgulas (8,17), um intervalo (1-5), um passo (*/15) ou um asterisco (*, qualquer valor). O dia da semana 0 e 7 são ambos domingo. 1#2 é a segunda segunda-feira, 1L a última. Um sexto campo W2:2026-10-05 repete de duas em duas semanas, contadas a partir dessa semana. Nomes como MON ou JAN não funcionam. Se preencher tanto um dia do mês como um dia da semana, a automação começa num dos dois.
Se a expressão for inválida, o Tillor indica-o no acionador. As horas valem no fuso horário da sua organização.
A que horas começa exatamente um calendário
Um calendário começa no minuto em que chega a sua vez
O Tillor verifica a cada minuto que calendários chegaram à sua vez. Uma automação que deve começar às 08:07 começa nesse minuto. Isto vale para Fatura vencida, Uma data é atingida, Todos os dias a uma hora e Segundo uma expressão cron.
Por minuto, um calendário começa no máximo uma vez. Uma verificação que só corre no minuto seguinte não recupera o minuto anterior.
Os eventos começam de imediato, sem este atraso.
Apenas quando
Com Apenas quando só deixa a automação começar se os dados corresponderem. Assim começa, por exemplo, apenas para caravanas fixas, ou apenas para faturas acima de um montante. Deixe vazio para começar em cada evento deste tipo.
- Clique em Adicionar condição
- Escolha o campo com o botão Variável (ou escreva o caminho, por exemplo
invoice.status) - Escolha como comparar
- Preencha o valor. Em campos com uma escolha fixa, como um estado, um tipo de terreno ou um colega, escolhe numa lista
Pode usar as seguintes comparações:
| Escolha | Verifica-se quando |
|---|---|
| é | O campo é igual ao valor |
| não é | O campo não é igual ao valor |
| contém | O valor aparece algures no campo |
| é maior que | O campo é maior do que o valor (em números e datas) |
| é menor que | O campo é menor do que o valor (em números e datas) |
| é um de | O campo é igual a um dos valores escolhidos |
| está vazio | O campo está vazio |
| não está vazio | O campo não está vazio |
As maiúsculas não importam. Os números são comparados como números, pelo que 10 é maior que 9.
Se tiver mais do que uma condição, escolhe como colaboram: Todas têm de corresponder ou Basta uma corresponder.
Os eventos retidos pelo filtro não iniciam nenhuma execução e, por isso, também não deixam rasto no separador Execuções. Se quiser ver se o seu filtro está certo, use Testar: aí vê, por condição, se se verificou.
Executar uma vez por registo
Com Executar uma vez por registo a automação começa no máximo uma vez por fatura, reserva ou outro registo, por muitas vezes que o evento ocorra para ele.
É especialmente útil em eventos que se repetem muito, como invoice:updated: uma fatura é alterada dezenas de vezes, mas só quer enviar um lembrete. O Tillor memoriza, por registo, que a automação já começou. Essa memória desaparece se eliminar a automação.
Só funciona em eventos a que corresponde um registo, e em Fatura vencida e Uma data é atingida. Em Uma data é atingida significa: mesmo que a data se desloque mais tarde, o fluxo não volta a começar. Num calendário como Todos os dias a uma hora não tem efeito.
O que acontece a seguir?
- Sempre que o momento de arranque ocorre e o filtro se verifica, começa uma execução com os dados desse momento como variáveis.
- Um evento começa de imediato. Uma data, hora ou calendário começa no minuto em que chega a sua vez.
- Se o filtro não corresponder, não começa nada e não fica rasto no separador Execuções.