Nós
Acção personalizada
Chame uma API ou webhook externo durante uma chamada.
Acção personalizada
O nó Acção personalizada (custom_action) permite chamar qualquer API HTTP durante a chamada e usar a resposta no fluxo.
Acção vs. nó
A Acção é a configuração global (método, URL, headers, body, auth). O nó no fluxo referencia essa acção e mapeia variáveis do fluxo para os placeholders definidos.
Campos da acção
| Campo | Descrição |
|---|---|
| Nome | Identificação da acção. |
| Método HTTP | GET, POST, PUT, PATCH, DELETE. |
| URL do endpoint | Endpoint a chamar. |
| Tipo de autenticação | none, custom, gohighlevel, hubspot, salesforce, salesforce_sandbox. |
| Headers | Headers customizados. |
| Corpo do pedido | Template do body com placeholders <variavel>. |
| Instrução de IA | Como o agente deve anunciar ou reagir ao resultado. |
| Mensagens de atraso/falha | Textos falados enquanto espera ou em caso de erro. |
| Timeout e retries | Configuração de resiliência. |
Placeholders
Use <nome_da_variavel> no URL, headers ou body. O runtime substitui pelos valores do fluxo.
Nó no fluxo
- Referencia a acção por
actionId. - Mapeia variáveis para os placeholders (
inputMapping). - Guarda a resposta em
outputVariable.
Validação
- Erro se não estiver associada nenhuma acção.
- Erro se o modo webhook não tiver URL.
- Erro se
inputMappingnão for JSON object válido.