Inicie uma automação por webhook ou manualmente

A maioria das automações começa a partir de um evento no seu salão. Dois gatilhos são diferentes: Webhook inicia uma automação quando outro sistema envia uma requisição para a URL dele, por exemplo um formulário no seu site. Manual a inicia quando você clica em Executar.

Inicie uma automação por webhook

1. 1

   Etapa 1 de 4

   Escolha o gatilho Webhook

   Clique na etapa Iniciar Automação. Clique no campo Gatilho, escolha Outros e depois Webhook.

   Você verá:

   A janela mostra uma URL do webhook com um botão de copiar.

2. 2

   Etapa 2 de 4

   Proteja a URL com uma condição

   A URL do webhook é pública. Qualquer pessoa que a tenha pode iniciar a automação, então adicione uma Condição que só o seu sistema consiga cumprir, por exemplo um cabeçalho secreto.

   Use a aba Construtor ou escreva uma expressão na aba Expressão, como {{ $request.headers.authorization === "Bearer your-secret" }}. Os nomes dos cabeçalhos ficam em minúsculas. A automação só começa quando a condição inteira é verdadeira.

   Clique em Salvar e depois em Salvar no topo do editor. As alterações no gatilho só passam a valer depois que você salva a automação.

3. 3

   Etapa 3 de 4

   Use os dados da requisição nas suas etapas

   A requisição fica disponível no grupo de variáveis Requisição:

   • {{ $request.body.phoneNumber }}: um campo do corpo da requisição
   • {{ $request.query.source }}: um parâmetro de consulta, de ?source=... na URL
   • {{ $request.headers.authorization }}: um cabeçalho
   • {{ $request.method }}: o método HTTP

   Por exemplo, use {{ $request.body.emailAddress }} como destinatário de uma etapa Enviar Notificação.

4. 4

   Etapa 4 de 4

   Envie uma requisição

   A partir do seu outro sistema, envie uma requisição POST com corpo JSON ou de formulário para a URL do webhook.

   Você verá:

   A resposta tem status 202 e um executionId. Ele vem vazio quando a condição não foi cumprida. A execução aparece no Histórico da automação.

Limites e erros do webhook

• Cada webhook aceita até 60 requisições por minuto e 1.000 por hora. As requisições acima do limite são rejeitadas.
• Se a automação estiver desativada, a requisição é rejeitada com uma mensagem de que a automação não está ativa.
• Se a assinatura do seu salão não estiver ativa, a requisição é rejeitada.
• Cookies e cabeçalhos de sessão do Softalon não são repassados para a automação.

Inicie uma automação manualmente

1. 1

   Etapa 1 de 2

   Escolha o gatilho Manual

   Clique na etapa Iniciar Automação. Clique no campo Gatilho, escolha Outros e depois Manual. Salve a etapa e a automação.

2. 2

   Etapa 2 de 2

   Execute a automação

   Na página Automações, abra o menu no cartão da automação e clique em Executar. A opção só aparece em automações com o gatilho Manual, e a automação precisa estar ativa.

   Você verá:

   A mensagem Workflow iniciado. A execução aparece no Histórico.

Uma execução manual não tem evento, então só as variáveis de Outros, como o nome do seu salão, ficam disponíveis. Os destinatários precisam ser endereços fixos, como seu próprio e-mail.