Automação de Processos Internos com IA

O SquadOS pode atender colaboradores em linguagem natural e também executar fluxos em segundo plano. Essas duas jornadas usam recursos diferentes:

Necessidade	Recurso correto
Uma pessoa pergunta, pede uma ação ou precisa conversar	Agente, ligado a uma caixa de entrada e às bases e ferramentas necessárias
Um evento, uma mudança em contato/conversa ou um horário deve iniciar uma sequência	Automações, em Admin → Automações

O produto não automatiza cliques como um RPA. O agente interpreta uma conversa e pode usar as ferramentas vinculadas a ele. Uma Automação percorre um fluxo explícito de gatilhos, regras e ações.

Antes de montar o fluxo

Defina por escrito:

O que inicia o processo — evento da conversa, conversa sem resposta, tag do contato, contato adicionado a uma lista, audiência ou agenda.
Qual contexto existe na entrada — alguns gatilhos fornecem conversa e contato; outros começam sem esses objetos.
O que deve acontecer — por exemplo, analisar uma conversa, separar caminhos, aguardar, aplicar uma tag, atribuir atendimento ou chamar um sistema externo.
Quando o mesmo contato pode entrar novamente — uma vez por conversa, uma vez por contato ou sempre.
Como verificar o resultado — teste controlado, critérios de sucesso e responsável por acompanhar falhas em Atividade.

Essa definição evita salvar um fluxo que depende de uma conversa ou de um contato que o gatilho escolhido não entrega.

Criar a Automação

Para criar ou alterar fluxos, sua função precisa da permissão de escrita em Automações.

Abra Admin → Automações e selecione Nova automação.
Escolha Começar do zero ou Follow-up de conversa parada. O segundo modelo já contém três tentativas espaçadas, mas todos os passos podem ser alterados.
Renomeie Nova automação #N na barra superior.
Em Adicionar, escolha um item nas abas Gatilhos, Ações ou Regras. Você pode clicar no item ou arrastá-lo para o canvas.
Selecione cada passo e preencha sua configuração. O seletor de variáveis mostra apenas dados disponíveis naquele ponto do caminho.
Abra Configurações e escolha a regra de Reentrada. O modo Sempre cria uma nova execução para cada evento, inclusive para o mesmo contato; passos de IA consomem créditos a cada execução.
Selecione Testar e confira o caminho em Atividade.
Selecione Salvar. O SquadOS valida o grafo e destaca passos inválidos. Salvar cria uma nova versão para as próximas execuções, mas não liga a Automação.
Depois de salvar pelo menos uma versão, ative a Automação em Configurações ou pelo controle da lista.

Gatilhos disponíveis

Gatilho	Quando usar
Evento da conversa	Quando uma conversa muda de estado
Conversa sem resposta	Quando sua equipe falou por último e ninguém respondeu após o intervalo configurado
Tag do contato	Quando uma tag é aplicada ou removida
Contato adicionado à lista	Quando um contato entra em uma lista pela API, por importação ou manualmente
Audiência	Para iniciar um segmento na data agendada
Agendar	Para rodar uma vez ou de tempos em tempos no horário configurado

O antigo gatilho Webhook foi descontinuado. Para iniciar um fluxo por um sistema externo, adicione o contato a uma lista pela API de Listas e use Contato adicionado à lista.

Ações, regras e IA

O editor oferece Condição, Aguardar e Encerrar para controlar o caminho. As ações atuais permitem enviar mensagem ou e-mail, aplicar tag ao contato ou à conversa, escolher contato, obter a conversa do contato, atribuir atendimento, passar para outro agente de IA, concluir a conversa, gravar um valor no contato e chamar um webhook externo.

Analisar com IA classifica e extrai dados da conversa. Na versão atual, esse passo não executa ferramentas de agente e não consulta bases de conhecimento. Se o fluxo precisar enviar dados a outro sistema, use Chamar webhook; se precisar que uma pessoa converse e o agente consulte conhecimento ou execute ferramentas, use a jornada de Agente.

Veja os contratos completos em Gatilhos, Ações, Regras e Variáveis.

Testar sem confundir simulação e efeito real

O teste pode executar o Canvas atual, mesmo ainda não salvo, ou a Versão no ar, quando ela existir. Se houver mais de um gatilho, escolha qual será simulado e informe a conversa, o contato ou os dados pedidos para aquela entrada.

ações de envio são simuladas;
passos de IA executam de verdade e consomem créditos;
Obter conversa do contato pode abrir uma conversa real, embora não envie mensagem;
um passo que exige conversa ou contato falha quando o teste não recebe esse alvo.

Ao terminar, abra Atividade. Cada execução mostra status, custo, entrada, saída e o caminho percorrido na versão usada por ela. Consulte Execuções e testes para interpretar cada estado.

Dois exemplos seguros

Triagem depois de uma conversa

Use Evento da conversa → Analisar com IA → Condição. Em cada ramo, grave o resultado no contato, aplique uma tag ou atribua o atendimento. Teste casos que devem seguir por caminhos diferentes antes de salvar e ativar.

Entrada enviada por um sistema interno

Crie uma lista dedicada, use Contato adicionado à lista como gatilho e cadastre o contato pela API. Depois, aplique as ações necessárias. Para enviar mensagem, o fluxo precisa de uma conversa: configure Obter conversa do contato com a caixa correta e considere que esse passo pode criar uma conversa nova.

Agente para atendimento interno

Quando o processo começa com uma pergunta ou pedido humano, crie um Agente, vincule as bases e ferramentas necessárias e conecte uma caixa de entrada. Um agente pode consultar políticas internas, responder dúvidas ou executar uma ferramenta HTTP/Composio durante a conversa; isso não transforma essas ferramentas em passos do editor de Automações.

Comece com um fluxo curto, teste entradas esperadas e inesperadas, salve, ative e acompanhe Atividade antes de ampliar a sequência.