Ações

As ações são o que a automação faz quando o gatilho acontece. Elas ficam na aba Ações da paleta, agrupadas por assunto:

Ação	O que faz
Analisar com IA	lê a conversa, classifica e extrai dados dela
Enviar mensagem	escreve no canal da conversa
Enviar e-mail	dispara e-mail para uma lista
Aplicar tag	adiciona ou remove tags do cadastro do contato
Gravar no contato	guarda um valor num campo do cadastro
Aplicar tag na conversa	adiciona ou remove tags daquele atendimento
Obter conversa do contato	continua a conversa que o contato já tem, ou abre uma nova
Atribuir	define quem da equipe atende a conversa
Passar para agente	troca o agente de IA da conversa
Concluir	encerra o atendimento
Chamar webhook	envia dados para um sistema externo

Enviar mensagem

Escreve no cliente pelo mesmo canal em que a conversa acontece — não há canal a escolher, é o da conversa. O texto aceita variáveis, e o botão Inserir variável mostra só as que valem naquele ponto do fluxo.

Este passo precisa de uma conversa. Num fluxo que começa por tag ou por lista não existe uma — use Obter conversa do contato antes dele.

Fora da janela de 24h

Passadas 24 horas sem o contato responder, o WhatsApp Oficial e o Instagram Direct só aceitam mensagem escrita a partir de um modelo aprovado. A faixa Fora da janela de 24h é onde você escolhe qual modelo usar nesse caso.

Sem modelo escolhido, o passo simplesmente não envia — e o motivo aparece nas execuções. Não é falha: é o SquadOS obedecendo a regra da Meta em vez de tentar um envio que seria recusado.

As proteções de envio valem para este passo: descadastro, conversa adiada, cliente esperando resposta e teto de 3 mensagens automáticas por contato a cada 24 horas.

Enviar e-mail

Diferente de Enviar mensagem, este passo não depende da conversa: ele dispara para uma lista de contatos, opcionalmente recortada por tags.

• Assunto aceita variáveis.
• Formato escolhe entre texto simples e HTML.
• Corpo você escreve ali mesmo, com variáveis do fluxo, ou reaproveita o conteúdo de uma campanha de e-mail que a sua equipe já escreveu.

E-mail não tem janela de 24 horas — essa regra é dos canais da Meta. As demais proteções continuam valendo.

Aplicar tag e Aplicar tag na conversa

São dois passos parecidos que marcam coisas diferentes, e a diferença importa:

• Aplicar tag mexe nas tags do cadastro da pessoa — valem em qualquer conversa dela, hoje e no futuro.
• Aplicar tag na conversa mexe nas tags daquele atendimento — descrevem o assunto e continuam valendo depois de uma transferência.

Cada um aceita uma lista para adicionar e outra para remover, na mesma passagem.

Aplicar uma tag de contato aqui dispara o gatilho Tag do contato de outras automações. É assim que se encadeiam fluxos — e é assim que se cria um laço sem querer.

Gravar no contato

Guarda um valor num campo do cadastro do contato: cidade, empresa, origem. O nome do campo é fixo, escrito por você; o valor aceita variáveis dos passos anteriores.

É o par natural de Analisar com IA: a IA extrai a informação da conversa, este passo grava no contato.

Obter conversa do contato

Este passo existe por um motivo específico: fluxos que começam por contato não têm conversa. Tag do contato, entrada em lista e campanha por audiência identificam uma pessoa, não um atendimento — e passos como Enviar mensagem, Atribuir ou Concluir precisam de um.

Obter conversa do contato resolve isso: procura a conversa que aquele contato já tem na caixa escolhida e, se não houver nenhuma, abre uma nova. A partir dele, todos os passos seguintes passam a ter conversa — inclusive as variáveis de conversa.

Você escolhe a caixa de entrada e, opcionalmente, um título para a conversa. Sem título, o SquadOS escolhe um.

Atribuir, Passar para agente e Concluir

Os três mexem em quem cuida do atendimento:

• Atribuir define a pessoa da equipe responsável pela conversa. Escolher “Ninguém” devolve a conversa para a fila.
• Passar para agente troca o agente de IA que atende a conversa. O campo Instrução para o agente é um recado que vai junto com a transferência — o cliente não vê esse texto.
• Concluir encerra o atendimento. Você escolhe se a conversa volta para a IA ou continua com o atendente. Os estados de uma conversa estão explicados em Estados de conversa.

Chamar webhook

Envia dados para um sistema externo: um CRM, uma planilha, um fluxo no seu próprio backend.

• URL — o endereço que recebe a chamada; aceita variáveis.
• Método — GET, POST, PUT, PATCH ou DELETE. Na dúvida, POST.
• Cabeçalhos — pares chave/valor, para um token de autenticação, por exemplo.
• Corpo da requisição — o conteúdo enviado, com variáveis dos passos anteriores.

Nem todo endereço é aceito. Endereços de rede interna e o próprio domínio do projeto são recusados, por segurança. Se o SquadOS desativar a automação com o motivo “o endereço configurado para receber os dados não é permitido”, é isso que aconteceu.

Encerrar não é uma ação

O passo Encerrar fica na aba Regras, não aqui — ele não faz nada no mundo, só termina o fluxo naquele ramo. Está descrito em Regras: condição, espera e encerramento.