A Evolution API permite a criação e gerenciamento de bots utilizando a tecnologia Flowise, proporcionando automação e interatividade avançada através de diferentes tipos de interações. A seguir, você encontrará as instruções detalhadas sobre como configurar bots, gerenciar sessões e definir configurações padrão.Documentation Index
Fetch the complete documentation index at: https://doc.evolution-api.com/llms.txt
Use this file to discover all available pages before exploring further.
1. Criação de Bots no Flowise
Você pode configurar diversos bots no Flowise utilizando triggers para iniciar as interações. A configuração do bot pode ser feita através do endpoint/flowise/create/{{instance}}.
Endpoint para Criação de Bots
Endpoint
Corpo da Requisição
Aqui está um exemplo de corpo JSON para configurar um bot no Flowise:Explicação dos Parâmetros
enabled: Ativa (true) ou desativa (false) o bot.apiUrl: URL da API do Flowise (sem a/no final).apiKey: Chave da API fornecida pelo Flowise (opcional).- Opções:
triggerType: Tipo de trigger para iniciar o bot (alloukeyword).triggerOperator: Operador utilizado para avaliar o trigger (contains,equals,startsWith,endsWith,regex,none).triggerValue: Valor utilizado no trigger (por exemplo, uma palavra-chave ou regex).expire: Tempo em minutos após o qual o bot expira, reiniciando se a sessão expirou.keywordFinish: Palavra-chave que encerra a sessão do bot.delayMessage: Delay (em milissegundos) para simular a digitação antes de enviar uma mensagem.unknownMessage: Mensagem enviada quando a entrada do usuário não é reconhecida.listeningFromMe: Define se o bot deve escutar as mensagens enviadas pelo próprio usuário (trueoufalse).stopBotFromMe: Define se o bot deve parar quando o próprio usuário envia uma mensagem (trueoufalse).keepOpen: Mantém a sessão aberta, evitando que o bot seja reiniciado para o mesmo contato.debounceTime: Tempo (em segundos) para juntar várias mensagens em uma só.ignoreJids: Lista de JIDs de contatos que não ativarão o bot.
2. Configurações Padrão do Flowise
Você pode definir configurações padrão que serão aplicadas caso os parâmetros não sejam passados durante a criação do bot.Endpoint para Configurações Padrão
Endpoint
Corpo da Requisição
Aqui está um exemplo de configuração padrão:Explicação dos Parâmetros
expire: Tempo em minutos após o qual o bot expira.keywordFinish: Palavra-chave que encerra a sessão do bot.delayMessage: Delay para simular a digitação antes de enviar uma mensagem.unknownMessage: Mensagem enviada quando a entrada do usuário não é reconhecida.listeningFromMe: Define se o bot deve escutar as mensagens enviadas pelo próprio usuário.stopBotFromMe: Define se o bot deve parar quando o próprio usuário envia uma mensagem.keepOpen: Mantém a sessão aberta, evitando que o bot seja reiniciado para o mesmo contato.debounceTime: Tempo para juntar várias mensagens em uma só.ignoreJids: Lista de JIDs de contatos que não ativarão o bot.flowiseIdFallback: ID do bot de fallback que será utilizado caso nenhum trigger seja ativado.
3. Gerenciamento de Sessões do Flowise
Você pode gerenciar as sessões do bot, alterando o status entre aberta, pausada ou fechada para cada contato específico.Endpoint para Gerenciamento de Sessões
Endpoint
Corpo da Requisição
Aqui está um exemplo de como gerenciar o status da sessão:Explicação dos Parâmetros
remoteJid: JID (identificador) do contato no WhatsApp.status: Status da sessão (opened,paused,closed).
4. Variáveis Automáticas e Especiais no Flowise
Quando uma sessão do Flowise é iniciada, algumas variáveis predefinidas são automaticamente enviadas:Explicação das Variáveis Automáticas
remoteJid: JID do contato com quem o bot está interagindo.pushName: Nome do contato no WhatsApp.instanceName: Nome da instância que está executando o bot.serverUrl: URL do servidor onde a Evolution API está hospedada.apiKey: Chave de API usada para autenticar as requisições.
Variáveis Especiais para Workflows
No caso de bots do tipo workflow, a mensagem recebida é enviada na variávelquery dentro dos inputs. Isso permite que o workflow processe a mensagem diretamente com base no conteúdo da variável query.

