API

Gatilho de API que inicia o fluxo por chamadas HTTP autenticadas, com entrada estruturada.

Quando usar: Use quando o seu fluxo precisar expor um endpoint HTTP legado para iniciar o fluxo; em fluxos novos, prefira o bloco Início.

Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.

Este bloco existe para compatibilidade com fluxos antigos. Para novos fluxos de chat, execução manual ou API, use Início (start_trigger).

Conexão necessária: Sem conexão externa obrigatória.

Nenhuma conta externa é obrigatória para usar este bloco.

1. Adicione API ao desenho a partir da seção Gatilhos da aba Blocos.
2. Nenhuma conta externa é obrigatória para usar este bloco.
3. Revise a ação principal descrita no cartão do bloco.
4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
6. Só publique depois de conferir o resultado da execução de teste.

Este bloco não declara campos de saída separados.

Objetivo: Processar os dados antes de seguir para a próxima etapa.

Campos de entrada

{ "chave": "valor" }

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

O bloco não executa

Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.

Aparece “Validação do fluxo” no terminal

Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.

Um campo chega vazio na etapa seguinte

Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <api.campo>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

O fluxo não inicia sozinho

Gatilhos só disparam com a automação publicada. Confira também se o evento aconteceu na conta conectada e se os filtros do gatilho não estão excluindo o evento.

• AgendamentoIniciar a execução automaticamente nos dias e horários programados.
• Aguardar uma pessoaPausar a execução e aguardar uma decisão ou informação fornecida por uma pessoa.
• AnotaçãoAdicionar uma anotação visual ao desenho do fluxo sem executar uma ação.
• AvaliadorAvaliar um conteúdo com critérios definidos e devolver uma nota ou conclusão.
• Base de conhecimentoPesquisar semanticamente nas bases de conhecimento disponíveis.
• CondiçãoAvaliar uma condição e escolher por qual saída o fluxo deve continuar.