Integrações
Envie um webhook ou chame uma API a partir de uma automação.
Última atualização em
Estes passos estão no grupo Integrações. Uma entrega falhada continua por Falhou. Para as outras ações, leia Quando um passo falha.
Enviar webhook
Entrega uma mensagem própria a um dos endpoints de webhook da sua organização. É útil para avisar outro sistema, por exemplo o seu sistema de caixa ou o seu site.
| Campo | O que preencher |
|---|---|
| Endpoint | Escolha um dos seus endpoints de webhook. Reconhece-os pelo endereço. Obrigatório |
| Nome do evento | O nome que segue na mensagem para o destinatário a poder reconhecer, por exemplo automation.invoice_unpaid. Obrigatório |
| Payload | O conteúdo da mensagem, em JSON. As variáveis são preenchidas antes de a mensagem ser enviada. Obrigatório |
Os endpoints são criados e geridos no menu do perfil, em Programadores. O endpoint tem de existir e estar ativado. Se não estiver, o passo falha e a execução termina.
A mensagem é assinada com a chave própria do endpoint, exatamente como os outros webhooks que o endpoint recebe. A Tillor tenta de novo algumas vezes se o seu servidor não responder bem. O endpoint não tem de seguir o nome do seu evento: a mensagem chega de qualquer forma.
O passo tem duas saídas:
| Saída | Quando |
|---|---|
| Sucesso | O seu servidor respondeu com um estado de sucesso |
| Falhou | A entrega falhou após todas as tentativas. Depois disso, a mensagem continua a ser tentada em segundo plano, tal como um webhook normal |
O modelo Enviar reservas para outro sistema usa Falhou para criar uma tarefa, de modo a que alguém a trate.
Um payload pode ter, por exemplo, este aspeto:
{
"reservation": "{reservation.displayId}",
"checkIn": "{reservation.checkIn}",
"adults": {reservation.numberOfAdults},
"customer": {
"firstName": "{reservation.customer.firstName}",
"email": "{reservation.customer.email}"
}
}Ponha o texto entre aspas e os números sem aspas. As datas seguem em JSON como data e hora internacionais, por exemplo 2026-10-05T08:00:00.000Z. Leia Variáveis e modelos para os detalhes. A parte técnica, como a estrutura da mensagem, está em Programadores > Automações.
Pedido à API
Chama a API da Tillor da sua própria organização, ou outro endereço na internet. Com isto pode fazer quase tudo o que a Tillor faz, e procurar dados para depois os usar.
Em Enviar para escolhe entre Tillor API e URL personalizado. Em Método escolhe GET (consultar), POST (criar), PUT ou PATCH (alterar) ou DELETE (eliminar).
Tillor API
| Campo | O que preencher |
|---|---|
| Caminho | A parte do endereço a seguir à API da sua organização, por exemplo /tasks ou /tasks/{task.id}. Tem de começar por /. Obrigatório |
| Corpo | Os dados que envia, em JSON. Deixe vazio se não enviar nada |
No topo do campo está Escolha um endpoint da API. Clique aí e procure na lista, por exemplo tasks. Ao escolher um endpoint, a Tillor preenche o método e o caminho. Se o Corpo ainda estiver vazio, recebe também um exemplo do que o endpoint espera. Substitua os nomes entre chavetas no caminho por variáveis de passos anteriores. Se houver parâmetros de query, vê-os por baixo do campo.
A chamada é feita como o utilizador Fluxo de trabalho e nunca pode sair da sua própria organização. Uma automação não pode gerir automações, por isso as chamadas que afetem automações ou as suas execuções são recusadas.
URL personalizado
| Campo | O que preencher |
|---|---|
| URL | O endereço. Tem de começar por https://. Obrigatório |
| Cabeçalhos | Dados adicionais para o destinatário, por exemplo uma chave. Clique em Adicionar cabeçalho e preencha o Nome e o Valor |
| Corpo | Os dados que envia, em JSON. Deixe vazio se não enviar nada |
Aplicam-se estas regras:
- Os endereços sem
https://são recusados - Os endereços privados e internos são recusados, mesmo que um nome normal aponte para eles
- Os redirecionamentos não são seguidos. Se o servidor responder com um redirecionamento, conta como Falhou
- Os cabeçalhos são guardados de forma encriptada. Pode, por isso, pôr lá uma chave ou um token
- Em GET e DELETE não é enviado corpo
Saídas e resposta
O pedido tem duas saídas: Sucesso (o servidor respondeu com um estado de sucesso) e Falhou (o servidor respondeu com um estado de erro). Se a Tillor não chegar sequer ao servidor, por exemplo por um tempo limite após 15 segundos ou um endereço recusado, a execução termina com o estado Falhou.
Para os passos seguintes existem três variáveis:
| Variável | Conteúdo |
|---|---|
{response.status} | O código de estado, por exemplo 200 |
{response.body} | A resposta como texto, cortada nos primeiros 4000 carateres |
{response.data} | A resposta como dados, para poder extrair campos com {response.data.items.0.id} |
Como usar isto está em Usar uma resposta da API. Um exemplo completo com uma pesquisa está em Verificação de caravana de aluguer.