Referência: eventos, condições e ações das Automações

Este artigo é a referência completa dos três blocos de uma automação. Para o passo a passo de criação, veja Criando uma automação.

---

Eventos (Quando roda)

O evento é o que chama a automação. Ao escolher um, os campos de configuração dele aparecem logo abaixo.

Grupo Pipeline

Evento	Quando dispara	Campos
Oportunidade criada	A oportunidade não existia e foi criada	Pipeline (específica ou todas) · Etapa (específica ou qualquer)
Oportunidade entrou na etapa	A oportunidade já existia e entrou na etapa	Pipeline · Para a etapa (em branco = qualquer) · Só uma vez por oportunidade
Oportunidade parada na etapa há N dias	A oportunidade completou N dias parada na etapa	Pipeline · Etapa (em branco = qualquer) · Parada há X dias · Só uma vez por oportunidade
Oportunidade ganha	A oportunidade foi marcada/arrastada para Ganho	Pipeline (específica ou qualquer) · Só uma vez por oportunidade
Oportunidade perdida	A oportunidade foi marcada/arrastada para Perdido	Pipeline (específica ou qualquer) · Só uma vez por oportunidade

Sobre o Só uma vez por oportunidade: com ele ligado, o card que voltar para a mesma etapa não dispara de novo; desligado, cada passagem pela etapa dispara.

Sobre o parada na etapa há N dias:

• A contagem começa quando a oportunidade entra na etapa (um card criado nela conta desde a criação);
• A verificação roda de hora em hora — o disparo acontece na primeira verificação após o prazo;
• Cada card dispara uma vez por passagem pela etapa: se sair e voltar, pode disparar de novo (a menos que Só uma vez por oportunidade esteja ligado).

Grupo Contato

Evento	Quando dispara	Campos
Contato criado	Um novo contato foi criado	—
Etiqueta adicionada ao contato	A etiqueta escolhida foi aplicada	Etiqueta · Só uma vez por oportunidade
Etiqueta removida do contato	A etiqueta escolhida foi retirada	Etiqueta · Só uma vez por oportunidade

Grupo Conversa

Evento	Quando dispara	Campos
Nova conversa	Uma conversa foi criada	Canal (em branco = todos)
Conversa atribuída	Uma conversa foi atribuída a alguém	Canal · Setor
Conversa fechada	Uma conversa foi encerrada	Canal (opcional)
Conversa reaberta	Uma conversa fechada foi reaberta	Canal (opcional)
IA passou para humano	O agente de IA transferiu a conversa para um humano	Canal (opcional)

---

Condições (Só se)

Sem condições, a automação roda sempre que for chamada. Com condições, escolha o modo:

• Todas as condições — conector E: todas precisam ser verdadeiras;
• Qualquer uma — conector OU: basta uma ser verdadeira.

Exemplo: etiqueta tem "cliente ativo" + setor é "Geral" → em Todas, só roda com as duas verdadeiras; em Qualquer uma, roda com qualquer uma delas.

Campos disponíveis

Grupo	Campos
Contato	Etiqueta · Fonte · Tipo de cliente · Setor · E-mail · Empresa
Oportunidade	Pipeline · Etapa · Valor (maior, igual ou menor que X) · Responsável · Título
Conversa	Canal · Setor · Responsável · IA ativa · Status
Gatilho	Etapa de origem — a etapa de onde a oportunidade veio
Campos personalizados	Todos os campos personalizados do contato e da oportunidade da sua conta

💡 Os campos personalizados variam de conta para conta — a lista que aparece para você reflete os campos que a sua operação criou (dados de Instagram, cidade, categoria, o que for).

---

Ações (O que faz)

As ações executam em ordem, uma depois da outra. Catálogo completo:

Atribuição

• Definir responsável — define o responsável pela oportunidade;
• Transferir para setor — move para um setor específico.

Contato

• Adicionar etiqueta — aceita várias etiquetas de uma vez;
• Remover etiqueta — idem, várias de uma vez;
• Alterar campo — altera um campo do contato (do sistema ou personalizado), definindo o novo valor;
• Adicionar nota — registra uma nota no contato;
• Adicionar à lista — inclui o contato em uma das suas listas de envios;
• Remover da lista — retira o contato de uma lista.

Oportunidade

• Criar oportunidade;
• Mover para etapa — move a oportunidade para a etapa escolhida;
• Alterar campo da oportunidade — do sistema ou personalizado;
• Marcar como ganha;
• Marcar como perdida;
• Adicionar comentário — na oportunidade;
• Iniciar playbook — inicia um playbook na oportunidade, criando as tarefas do processo automaticamente.

Conversa

• Enviar mensagem — você escolhe o destino da mensagem e pode enviar arquivos;
• Nota privada — adiciona uma nota interna à conversa;
• Ligar ou pausar a IA — ativa ou pausa o agente de IA naquela conversa;
• Fechar conversa.

Tarefas e equipe

• Criar tarefa — cria uma tarefa específica;
• Notificar — notifica sobre a tarefa.

Ritmo

• Esperar — pausa a sequência por quantos minutos você definir, antes de executar a próxima ação.

Integrações

• HTTP Request — chama uma API externa a partir da automação. É a única ação com editor próprio; está detalhada na seção abaixo.

---

A ação HTTP Request

Chama uma API externa no meio da automação — para avisar um sistema, criar um registro do outro lado ou buscar um dado e usá-lo nas ações seguintes.

Método e URL

Escolha o método e informe a URL. A URL aceita variáveis, por exemplo /contacts/{{contato.email}}.

Corpo (JSON)

São dois modos, e a escolha entre eles é a decisão mais importante da ação.

Dados do GetRaze

A GetRaze monta o corpo para você. São 124 campos em nove blocos, e quatro regras explicam o comportamento:

Regra	O que significa
Formato fixo	O corpo é o mesmo para todo gatilho. O que muda é o bloco trigger e o que vem vazio — quem recebe não precisa de um tratamento por evento
Sem mensagem	O histórico da conversa nunca sai. Vão canal, status, responsável, setor, contagens, data e direção da última mensagem, a prévia dela e o resumo da IA
Ausente é nulo	Bloco sem dado vira null, nunca some. Lista vazia vira []. Um gatilho de contato, sem oportunidade, manda "opportunity": null
Desmarcar corta	Bloco desmarcado na tela sai do JSON — a chave nem aparece. É diferente de vir nula, e serve para aliviar o corpo quando a API do outro lado não precisa de tudo

Os nove blocos, cada um com a sua caixa de marcação:

Bloco	Chave no JSON	O que leva
Gatilho	trigger	O tipo do evento e o recorte dele — pipeline, etapa, etiqueta, canal, conforme o caso. É o único bloco cujo formato muda
Contato	contact	A pessoa: nome, e-mail, telefone, cargo, tipo, origem, responsável, setor, etiquetas, campos personalizados, canais e o link para o contato
Empresa	company	A empresa cadastrada: domínio, site, ramo, porte, sede, fit de ICP e camada
Oportunidade	opportunity	O negócio: título, valor, moeda, probabilidade, pipeline, etapa, responsável, produtos, etiquetas, campos personalizados e datas de ganho/perda
Outras oportunidades	other_opportunities	Os demais negócios do mesmo contato, em qualquer funil, em versão reduzida. Teto de 20
Conversa (resumo)	conversation	Canal, status, quem atende, contagens, a prévia da última mensagem e o resumo da IA
Tarefas	tasks	Contagem, não lista: quantas abertas, quantas vencidas e qual a próxima
Playbooks	roadmaps	As execuções de playbook do negócio ou do contato, da mais nova para a mais antiga. Teto de 10
Calendário	calendar	Só a próxima reunião confirmada. Compromisso passado ou cancelado não entra

⚠️ A chave do bloco de Playbooks continua sendo roadmaps no JSON. A tela foi renomeada, mas o corpo manteve o nome antigo para não quebrar integrações que já existiam.

Cinco chaves vão sempre, em qualquer modo, e não têm caixa na tela: event, sent_at, test, automation e account. O test vem true quando o envio partiu do botão Testar request, e não de uma rodada de verdade — útil para o outro lado ignorar os testes.

Escrever o meu

Você monta o JSON à mão, no formato que a API do outro lado espera, e a GetRaze substitui as variáveis antes de enviar.

• Onde as variáveis valem: no corpo, na URL, nos headers e nos parâmetros da URL — as mesmas nos quatro lugares;
• Como substitui: sempre por texto. Valor ausente ou nulo vira string vazia, nunca a palavra null;
• Se o JSON não for válido depois da substituição, o corpo é enviado como texto puro em vez de objeto. Vale conferir as aspas em volta de cada variável.

As variáveis disponíveis:

Variável	De onde vem
{{contato.nome}}	Nome completo do contato
{{contato.primeiro_nome}}	Primeiro nome; na falta dele, a primeira palavra do nome
{{contato.email}}	E-mail do contato
{{contato.telefone}}	Telefone, no formato internacional com +
{{contato.empresa}}	O campo "empresa" do contato, em texto
{{contato.cargo}}	Cargo do contato
{{oportunidade.titulo}}	Título do negócio da rodada
{{oportunidade.valor}}	Valor, sem símbolo nem separador de milhar
{{etapa.nome}}	Etapa do gatilho
{{pipeline.nome}}	Funil do gatilho
{{usuario.nome}}	Quem disparou, quando houve alguém
{{resposta.nome_do_campo}}	Um campo guardado da resposta de um HTTP Request anterior na mesma automação

⚠️ São 11 variáveis, contra os 124 campos do corpo pronto. Quem precisa de empresa, etiquetas, produtos, campos personalizados ou dados da conversa não consegue montar isso à mão — nesses casos, use Dados do GetRaze e trate o corpo do outro lado.

Autenticação

Quatro opções: Nenhuma, Bearer token, Basic (usuário e senha) e API Key em header.

Headers e Parâmetros na URL

Adicione quantos precisar. Os dois aceitam as mesmas variáveis do corpo.

Guardar da resposta

Informe o caminho na resposta e o nome da variável. Cada campo guardado fica disponível para as ações seguintes da automação, como {{resposta.rd_uuid}}.

💡 Depois de usar Testar request, a plataforma lista os campos da resposta — clique em um deles para guardá-lo, em vez de digitar o caminho à mão.

Tempo limite

Quantos segundos esperar pela resposta antes de desistir.

Se falhar

O que fazer quando a chamada não dá certo:

Opção	Quando usar
Repetir até 5 vezes	Só quando a API aceita a mesma chamada duas vezes sem duplicar nada
Seguir para a próxima ação	Quando a chamada é um aviso e a automação deve continuar mesmo assim
Parar a automação	Quando as ações seguintes dependem do resultado desta

⚠️ Cuidado com Repetir: além de exigir uma API que aceite a repetição, quem usa a resposta nas ações seguintes fica esperando as tentativas terminarem.

Segredo (opcional)

Assina o corpo com HMAC-SHA256 no cabeçalho X-Getraze-Signature. É o que permite a quem recebe um corpo genérico confirmar que a requisição veio mesmo da sua conta.

Testar request

Chama a API de verdade, na hora, e mostra a resposta — diferente do Ensaio, que simula tudo mas não envia o request.

---

Próximos passos

• Monte a sua primeira automação com o guia Criando uma automação;
• Teste tudo em simulação com o Ensaio antes de ativar;
• Acompanhe cada rodada na aba Execuções.