AutomatizeEtapa 1 de 5

Tudo o que inicia: a aba Gatilhos

Todo script e todo flow têm uma aba Gatilhos ao lado do código. Ela reúne tudo o que pode iniciar o item sem você clicar em Executar — o endpoint de API, os agendamentos e os gatilhos de evento — e os dois limites que o protegem. Nesta lição você lê a aba de cima a baixo, muda o endpoint com Configurar e vê os dois limites funcionando.

8 min de leituraAntes: Publique a versão testada, Chame de outro sistemaAbrir no Waiso

O que você vai aprender

Ler o cartão da API e copiar um curl síncrono ou assíncrono que funciona como mostrado
Mudar método, modo, autenticação, parâmetros e limites com Configurar
Adicionar e pausar agendamentos sem sair do editor
Limitar chamadas por minuto e execuções ao mesmo tempo

Uma aba, todas as entradas

Abra um script no editor e escolha Gatilhos na barra lateral (num flow, é uma das abas da direita). A aba tem quatro partes, sempre nesta ordem: API, Agendamentos, Eventos e Limites. Cada parte lê e grava os mesmos registros das páginas do projeto — o endpoint é o mesmo da página API, os agendamentos são os mesmos da página Agendamentos — então uma mudança feita num lugar aparece no outro na hora.

docs-demoCódigohello.pySalvarPublicar

hello.py

1def main(name: str = "world"):2    print(f"saying hello to {name}")3    return {"message": f"Hello, {name}!"}

Gatilhos1

APIAbrir na página da API

Outro sistema inicia este script com uma requisição HTTP — copie a URL ou o curl abaixo.

POST/exec/p_58e3011e/hello

ModoSyncAuthBearerLimite60/minStatus

ChamarSyncAsync

1curl -X POST "$WAISO_URL/exec/p_58e3011e/hello" \2  -H "Authorization: Bearer $WAISO_TOKEN" \3  -H "Content-Type: application/json" \4  -d '{"name":"world"}'

AgendamentosAbrir em Agendamentos

morning_helloDias úteis às 08:00Ativo

Adicionar agendamento

Eventos

Rode este script quando algo acontecer em outro lugar: chega um e-mail, uma linha do banco muda, chega uma mensagem MQTT.Adicionar gatilho de evento

Limites

Chamadas por minuto60Execuções ao mesmo tempoLimite do plano

O cartão da API no topo com a URL, o curl de Chamar, depois Agendamentos, Eventos e Limites.

Todo gatilho roda a versão publicada. Enquanto o item não é publicado, a aba diz Os gatilhos executam a versão publicada. Publique este script para chamá-lo por URL ou por agendamento. e os botões de adicionar ficam desativados, com o motivo ao passar o mouse. Depois de publicar, se você continuar editando, uma linha avisa Há alterações não publicadas — os gatilhos continuam executando a versão publicada.

O cartão da API e o curl

Ative o endpoint
Num item que está Ainda não está na API, clique em Ativar endpoint. O cartão passa a mostrar o selo do método, a URL com o caminho em negrito, as colunas Modo, Auth, Limite e Status, e Abrir na página da API, que abre a página API focada neste endpoint.
Copie o curl
Em Chamar, um seletor Sync | Async escolhe qual exemplo aparece, depois vem Copiar curl. O seletor só muda a exibição — nunca muda o endpoint, porque trocar o modo de um endpoint em uso quebraria quem chama. Quando o exemplo difere do endpoint, uma linha diz Este endpoint é Síncrono — altere em Configurar.
Defina o token
O curl lê o token de $WAISO_TOKEN (Defina $WAISO_TOKEN com um token da API.). Criar token abre as configurações da página API com um novo token para este endpoint.

Sync espera e responde com a saída (ideal abaixo de ~30 s). Async responde na hora com um runId; consulte até terminar. Um flow que para numa etapa de Aprovação responde 202 com a execução enquanto espera, em vez de segurar a chamada. O contrato completo — códigos de status, a URL de consulta, erros de token — está em Endpoints de API.

Configurar: as opções do endpoint

Configurar abre o mesmo diálogo da página API. As seções ficam listadas à esquerda; cada uma está a um clique e Save changes grava tudo junto. Os rótulos desse diálogo aparecem em inglês nos dois idiomas do app.

Seção	O que você escolhe
Endpoint URL	O caminho depois do id do projeto. Só letras, números, `-`, `_` e `/`.
HTTP Method	GET, POST (o padrão), PUT ou DELETE.
Execution Mode	Synchronous (espera e devolve a saída) ou Asynchronous (devolve um `runId` para consultar).
Authentication	Protected (exige token de API — recomendado) ou Public (sem token).
Parameter Passing	Só quando o script tem parâmetros: Request body (JSON) ou Query string.
Limites	Chamadas por minuto e Execuções ao mesmo tempo — os mesmos dois campos da aba.
Active Tokens	Só para endpoint protegido: os tokens que podem chamá-lo.

Agendamentos e eventos

Agendamentos lista todos os agendamentos que rodam este item, como a página Agendamentos mostra, com a próxima execução (um pausado mostra “—”). Adicionar agendamento abre o assistente de agendamento já apontado para este item; Pausar agendamento e Retomar agendamento funcionam em cada linha; Abrir em Agendamentos leva à página completa. Eventos guarda os gatilhos que iniciam o item quando chega um e-mail, muda uma linha no banco ou chega uma mensagem MQTT — veja Gatilhos de evento.

Cada linha de agendamento tem o próprio botão de pausa.

Os dois limites

Protege contra chamadas demais ou execuções demais ao mesmo tempo. Os dois campos aceitam números inteiros e são salvos quando você sai do campo ou aperta Enter (a linha de ajuda mostra Salvo por um instante). Os dois ficam vazios por padrão — aí só vale o limite do seu plano.

Limite	Faixa	Acima do limite
Chamadas por minuto (endpoint)	1–100.000	HTTP `429`, o cabeçalho `Retry-After` e `{"code": "rate_limited", "retryAfter": n}`; nenhuma execução é criada.
Execuções ao mesmo tempo (item)	1–1.000	As execuções a mais esperam na fila e começam quando uma termina; nunca falham.

As chamadas são contadas por endpoint em cada minuto do relógio, qualquer que seja o token; retryAfter são os segundos até o próximo minuto (1 a 60).
O limite de chamadas precisa do endpoint ativo (Ative o endpoint para limitar as chamadas.). O limite de execuções vale para toda execução do item: chamadas de API, agendamentos, eventos e execuções do editor.
Uma chamada recusada fica registrada: aparece no uso da página API como limitada.

ExercícioFaça a segunda execução esperarAbrir no Waiso

Ver Execuções ao mesmo tempo segurar uma execução na fila em vez de fazê-la falhar.

Antes de começar

Um projeto onde você possa criar e publicar um script

Passos

1Crie um script slow-report com o código da solução e publique.
2Em Gatilhos → Limites, digite 1 em Execuções ao mesmo tempo e aperte Enter.
3Ative o endpoint, abra Configurar, escolha Asynchronous em Execution Mode, clique em Save changes e depois em Copiar curl.
4Rode o curl duas vezes seguidas e abra Execuções.
5Apague o campo quando terminar.

Resultado esperado

Duas linhas do slow-report: a primeira Executando, a segunda Na fila; uns 20 segundos depois a segunda começa, e as duas terminam em Sucesso com {"slept": 20}.

Dica

Um endpoint assíncrono responde na hora com um runId, então a segunda chamada começa enquanto a primeira ainda roda. O seletor Sync | Async ao lado do curl só muda o exemplo.

Ver solução

O limite é do item, não do endpoint: a segunda execução esperou uma vaga e nunca foi recusada. Chamadas por minuto a teria recusado com 429.

slow-report.py

import time

def main(seconds: int = 20):
    time.sleep(seconds)
    return {"slept": seconds}

Confira · 3 perguntas

Você troca o exemplo do curl para Async. O endpoint mudou?

Não — o seletor só muda o exemplo. O modo muda em Configurar.

Quem chama passa de Chamadas por minuto. O que recebe, e uma execução começa?

HTTP 429 com Retry-After; nenhuma execução começa.

Onde mais dá para editar os agendamentos mostrados aqui?

Na página Agendamentos — as duas leem os mesmos agendamentos.

1 / 5