Your AI Connector Docs

Automações

Automações permite que você crie fluxos de trabalho com várias etapas — pense no Zapier ou n8n, mas criados para seus contatos e conversas.

Automações estão disponíveis em todas as contas — elas já estão na sua barra lateral, e não há nada para habilitar ou solicitar.


Uma Automação é um fluxo de trabalho: um gatilho que o inicia, seguido por qualquer número de etapas que são executadas em ordem (ou ramificadas, com base em uma condição). É a ferramenta para qualquer coisa mais complexa do que “enviar esta mensagem de abertura, passar as respostas para um Agente” — sequências de várias etapas, consultas de dados, conexão com ferramentas externas e lógica que se ramifica dependendo do que um contato faz.

Onde encontrar: Na barra lateral, sob o grupo AI Studio, clique em Automações.

Criando uma Automação

Clique em Criar sua primeira automação (ou Nova automação assim que tiver outras). Você chegará a uma tela em branco com duas maneiras de construir:

  • Descreva em linguagem simples. Digite o que você deseja na caixa de prompt (por exemplo, “Envie um acompanhamento se não houver resposta em 1 hora”, “Marque contatos que perguntarem sobre preços” ou “Dê ao meu agente de IA uma maneira de consultar o status de um pedido”) e ele criará o gatilho e as etapas para você (incluindo ferramentas de Função de Agente de IA que seu agente pode chamar). Você pode continuar conversando para refinar o resultado posteriormente. Não tem certeza do que pedir? Uma linha com exemplos de ideias fica abaixo da caixa. Clique em um para inseri-lo na caixa e editá-lo a partir daí, ou clique em Mais ideias para alternar entre as demais. Conforme você digita, a caixa também sugere como terminar a frase, exibida em cinza à frente do seu cursor: pressione Tab para aceitar a sugestão ou apenas continue digitando para ignorá-la.
  • Crie manualmente. Arraste peças do painel à esquerda para a tela e conecte-as. O + em uma etapa funciona nos dois sentidos: clique e arraste — uma linha seguirá seu ponteiro, e onde você soltar é onde a próxima etapa será criada, já conectada — ou apenas clique nele para abrir um pequeno seletor e inserir a etapa ali mesmo. Você pode arrastar a partir de um ponto de saída da mesma forma, e os itens no seletor podem ser arrastados para a tela. Digitar na caixa de pesquisa do seletor procura por tudo de uma vez — ações integradas, aplicativos conectados e etapas de lógica — para que você não precise saber em qual guia algo está. O painel à esquerda tem a mesma caixa de pesquisa no topo: digite “loop”, “webhook” ou o nome de um aplicativo e ele filtrará todas as seções — gatilhos, ações, aplicativos e lógica — de uma só vez.

Você pode misturar ambos: comece a partir de um prompt e depois ajuste o resultado manualmente, ou vice-versa.

Gatilhos

Toda automação começa com exatamente um gatilho — o evento que a inicia. Existem muitos deles agora, então o seletor de gatilhos os organiza em grupos de acordo com o que eles fazem.

Mensagens

Gatilho Disparado quando…
Mensagem recebida Um contato envia uma mensagem, em qualquer canal ou em um que você escolher — opcionalmente restrito a mensagens que contenham certas palavras e às conversas de um agente de IA (ou uma campanha clássica). Veja Executando uma automação para apenas um agente
Mensagem entregue Uma mensagem que você enviou é confirmada como entregue pelo canal. Pode ser restrito a um canal
Falha na mensagem Uma mensagem que você enviou não pôde ser entregue. A execução recebe o motivo retornado pelo canal, para que você possa alertar alguém, tentar outro canal ou marcar o contato

Contatos

Gatilho Dispara quando…
Novo contato Um contato é adicionado à sua conta — a partir de uma conversa, uma importação, um formulário, a API, de qualquer lugar
Contato atualizado Os detalhes de um contato mudam — qualquer campo, ou um campo específico que você escolher
Contato adicionado Você mesmo adiciona contatos a ela — em massa a partir de Contatos, de um contato, de uma conversa ou da própria automação. Uma execução por contato. Veja Adicionando contatos a uma automação

Negócios

Gatilho Dispara quando…
Negócio atualizado Os detalhes de um negócio mudam — qualquer campo, ou um campo específico que você escolher (o estágio dele, por exemplo)

Compromissos

Gatilho Dispara quando…
Agendamento marcado Um novo agendamento é marcado
Agendamento cancelado Um agendamento marcado é cancelado — o motivo do cancelamento é incluído
Antes de um agendamento Um tempo definido antes de cada agendamento confirmado, para lembretes. Escolha os momentos que desejar — 24 horas antes, 3 horas antes ou seu próprio número de minutos — até cinco por automação. O lembrete dispara exatamente naquele momento, independentemente do horário local. Se um intervalo puder cair no meio da noite para alguns contatos, ative Respeitar horário de silêncio no gatilho e a mensagem aguardará até as 8h do horário deles — veja Respeitando o horário de silêncio e Exemplo: lembretes de agendamento

Tarefas

Gatilho Dispara quando…
Tarefa criada Uma tarefa é criada — opcionalmente apenas um tipo de tarefa, como um alerta humano, uma lacuna na base de conhecimento ou um acompanhamento
Tarefa concluída Uma tarefa é movida para um estágio de concluída

Conta

Gatilho Dispara quando…
Saldo de crédito baixo Seu saldo de crédito cai abaixo do limite de alerta definido em sua conta. Ele dispara no máximo uma vez por dia e é reativado após você recarregar

Geral

Gatilho Dispara quando…
Agendado Um horário recorrente que você define (por exemplo, toda manhã às 9h)
Webhook Uma ferramenta ou site externo envia dados para um endereço web que a automação fornece a você. Ele pode enviar JSON ou um post de formulário clássico (o formato que muitos provedores de pagamento e ferramentas de formulário usam) — de qualquer forma, cada campo enviado fica disponível para as etapas posteriores como ${trigger.field_name}. Qualquer coisa adicionada ao final do endereço web também se torna um campo: …?phone=15551234567 fornece a você ${trigger.phone}. Essa é a forma de entrada para construtores de formulários que não podem alterar o formato do que enviam, mas podem inserir uma resposta no endereço (o “answer piping” do Paperform, por exemplo: …?phone={{ your_phone_question_key }})
Função de Agente de IA Seu agente de IA chama a automação por conta própria, durante a conversa, como uma de suas habilidades — veja a próxima seção
Novo item de feed Um novo item aparece em um feed RSS ou Atom que você indicar — verificado a cada poucos minutos. Ativar a automação não a dispara para itens que já estão no feed, apenas para novos itens a partir desse momento
E-mail recebido Um e-mail chega na sua caixa de entrada. Conecte a caixa de entrada uma vez (detalhes IMAP do seu provedor — endereço do servidor, nome de usuário, senha; se você usa autenticação em duas etapas, use uma senha de aplicativo). Você pode restringir a e-mails cujo remetente ou assunto contenha certas palavras
Execução manual Apenas quando você mesmo clica em Executar — útil enquanto você ainda está criando e testando

Os gatilhos reagem a toda a sua conta, não apenas ao construtor. As opções Mensagem recebida, Contato atualizado e Negócio atualizado são acionadas independentemente de onde a alteração venha: seu agente de IA atualizando um contato no meio de uma conversa, uma campanha, alguém editando um registro na tela, uma importação ou seu próprio software chamando a API. Você não precisa fazer nada na automação para isso — é simplesmente assim que eles funcionam agora.

Escolheu o errado ou mudou de ideia depois? Abra o gatilho e clique em Alterar gatilho para mudar para um tipo diferente — o restante da sua automação permanece exatamente como está. Se o gatilho atual já tiver configurações que você preencheu, será solicitado que você confirme antes que elas sejam apagadas.

Respeitando o horário de silêncio

Uma automação é executada no momento em que seu gatilho dispara, e esse momento nem sempre é oportuno — um lembrete de agendamento definido para 12 horas antes pode chegar às 2h da manhã para qualquer pessoa com um horário no início da manhã, e um contato do outro lado do mundo pode estar dormindo quando você não está.

Respeitar horário de silêncio é uma chave por automação exatamente para isso. Onde encontrar: clique na etapa do gatilho na tela e role até a parte inferior de suas configurações — a chave seletora fica abaixo das configurações específicas daquele gatilho, e está presente em todos os tipos de gatilho.

Ela vem desativada por padrão, tanto em automações novas quanto nas existentes, portanto, nada que você já criou mudará de comportamento por conta própria.

Quando você a ativa, apenas para aquela automação:

  • Etapas de mensagem que seriam enviadas entre 20h e 8h no horário local do contato aguardam e são enviadas por volta das 8h do horário dele — um pequeno atraso aleatório as distribui entre 8:00 e 8:15, em vez de disparar todas de uma vez. Isso cobre as etapas de Enviar mensagem, Modelo de WhatsApp e Envio via WhatsApp Web.
  • Todas as outras etapas ainda são executadas imediatamente. Tags, condições, atrasos, webhooks, atualização de um contato, criação de uma tarefa — nada disso é retido. Apenas a mensagem em si aguarda.
  • Etapas de mensagem dentro de um Loop são a única exceção — elas são enviadas imediatamente, mesmo com a opção ativada: reter a mensagem de cada contato separadamente espalharia um loop por toda a janela de silêncio. Coloque a mensagem após o loop se ela precisar aguardar até a manhã, ou use Executar apenas durante estes horários no gatilho para que todo o loop seja executado em um horário apropriado.
  • O tempo do próprio gatilho não muda. Um lembrete de “3 horas antes do compromisso” ainda é executado três horas antes; se isso cair às 3h da manhã, a execução acontece e a mensagem é o que aguarda até a manhã.
  • Horário local significa o horário do contato, não o seu. Ele é calculado a partir do código do país do número de telefone ou de um fuso horário salvo no contato — da mesma forma que a configuração de Horário de Silêncio de toda a conta faz.

Isso é separado da configuração de Horário de Silêncio de toda a conta em Configurações → Perfil, que cobre envios de campanhas e acompanhamentos. Essa configuração não afeta suas automações, e é por isso que cada automação possui sua própria chave. Veja Horário de Silêncio e Conformidade para o lado da conta.

Criando um lembrete para um horário fixo do dia? Se a mensagem só for enviada durante o horário comercial de qualquer maneira, deixe a chave desativada — não custa nada, mas não há motivo para adicionar uma espera que nunca será usada.

Executar apenas durante determinados horários

O modo de horas de silêncio retém as mensagens; todos os outros passos continuam sendo executados. Às vezes, isso não é o que você deseja — às vezes, toda a automação deve permanecer desativada fora de um determinado período. Digamos que ela transfira chats para sua equipe, e sua equipe só trabalha das 9h às 18h: às 2h da manhã, você não quer que a transferência seja adiada para a manhã seguinte, você quer que ela simplesmente não aconteça.

Executar apenas durante estes horários é uma segunda opção por automação exatamente para isso. Onde encontrar: clique no passo de gatilho e role até o final de suas configurações — ele fica logo ao lado de Respeitar horas de silêncio, em todos os tipos de gatilho. Ative-o e defina um horário de início, um horário de término e um fuso horário.

  • Dentro do período a automação se comporta exatamente como antes.
  • Fora do período, o gatilho é simplesmente ignorado. A automação não é executada, nada é colocado na fila para depois e nada aparece no histórico de execuções — o evento é tratado da mesma forma que uma mensagem que não corresponde ao filtro de texto do gatilho. Se os eventos noturnos ainda precisarem ser tratados eventualmente, este interruptor é a ferramenta errada; deixe-o desligado e use Respeitar horas de silêncio em vez disso.
  • Término antes do início significa um período noturno. Das 21:00 às 08:00, a automação funciona durante a noite e permanece desativada durante o dia.
  • O período usa o único fuso horário que você definiu na automação — não o horário local de cada contato. As horas de silêncio são por contato; este é um relógio para toda a automação. Digite o fuso horário da mesma forma que o gatilho Agendado aceita, por exemplo, Europe/London ou America/Lima.
  • Gatilhos agendados são verificados no momento em que são disparados. Uma execução agendada cujo momento cai fora do período é ignorada, não movida.

A diferença em uma linha: Respeitar horas de silêncio executa a automação e retém apenas suas mensagens até a manhã seguinte; Executar apenas durante estes horários não executa a automação de forma alguma.

E se o que você realmente deseja é uma automação que se comporte de forma diferente dependendo do horário — uma coisa durante o dia, outra à noite — não pule a execução: crie uma ramificação com uma etapa de Condição definida como Hora do dia (veja Etapas).

Executando uma automação para apenas um agente

A maioria das contas executa mais de um agente de IA, e uma automação que deveria se aplicar apenas a um deles — o agente de suporte, por exemplo, e não o de vendas — costumava não ter como especificar isso. O gatilho Mensagem recebida agora possui um campo Agente ou campanha (opcional) exatamente para isso.

Abra o gatilho, clique no campo e você verá uma lista agrupada: seus agentes de IA por nome e suas campanhas clássicas abaixo, caso sua conta ainda possua alguma. Escolha um e a automação será executada apenas para as conversas que esse agente gerencia; todas as outras conversas em sua conta serão ignoradas. Deixe o campo vazio e a automação será executada para cada mensagem recebida na conta, exatamente como antes.

O campo aceita apenas uma escolha, não um conjunto — uma automação é restrita a um único agente ou a uma única campanha, portanto, crie uma segunda automação se desejar as mesmas etapas em outro.

Nem todo agente pode ser selecionado ainda. Qualquer agente que o campo não puder oferecer será contabilizado logo abaixo dele, para que você possa ver rapidamente que a lista está curta, em vez de se perguntar por que um agente está faltando. Essas conversas ainda funcionam normalmente; elas apenas não podem ser selecionadas aqui por enquanto.

Mais uma coisa que vale a pena saber, em contas que usam agentes de IA: uma automação acionada por mensagem restringida dessa forma é disparada na primeira mensagem de um contato totalmente novo, bem como em todas as mensagens seguintes. Antigamente, ela começava a partir da segunda mensagem, então a mensagem de abertura de cada nova conversa passava despercebida. (Isso se refere a automações cujo gatilho é uma mensagem recebida — é diferente do gatilho Contato adicionado acima, que é executado exatamente uma vez por contato que você insere.)

Permitindo que seu agente de IA chame uma automação

O gatilho Função de Agente de IA transforma uma automação em uma habilidade que seu agente de IA pode usar enquanto conversa com um cliente — da mesma forma que ele já usa funções personalizadas. O cliente pergunta algo, o agente decide que sua automação é a ferramenta certa para isso, chama-a com os detalhes coletados na conversa e (se você desejar) recebe uma resposta para usar na próxima interação.

Configurando uma:

  1. Nomeie a função. Um nome curto com letras, números e sublinhados — check_availability, register_warranty. A IA vê esse nome, então faça com que ele descreva o que a função faz.
  2. Descreva quando usá-la. A descrição é como seu agente decide chamá-la — escreva da maneira que você instruiria um novo membro da equipe: “Use isso quando um cliente perguntar se temos um horário de agendamento livre em um determinado dia.”
  3. Adicione os detalhes a serem coletados. Cada parâmetro é uma informação que a IA deve reunir da conversa antes de chamar a automação — uma cidade, um número de pedido, uma data preferencial. Dê a cada um um nome, um tipo e uma breve descrição; marque os que são obrigatórios. O tipo pode ser texto, número, sim/não ou JSON — escolha JSON quando a IA precisar fornecer um conjunto estruturado de campos (por exemplo, um endereço de entrega completo) em vez de um único valor.
  4. Escolha quais agentes podem usá-la. Selecione os agentes de IA (ou campanhas) que devem ter essa habilidade — seja aqui no gatilho ou posteriormente na aba Habilidades de IA de qualquer agente, onde a função aparece ao lado das outras habilidades do agente com um botão de ligar/desligar. Ambos os locais editam a mesma coisa, então use o que for mais conveniente para você.
  5. Ative a automação. A partir desse momento, esses agentes possuem a função — nada para copiar, sem endereços de webhook ou segredos para colar por aí.

Não quer escrever o nome, a descrição e os detalhes você mesmo? Crie as etapas da automação primeiro e, em seguida, clique em Preencher com IA na parte superior das configurações do gatilho — ele lê o que sua automação faz e escreve tudo para você. Qualquer coisa que você já tenha digitado permanece como está; ele preenche apenas o que você deixou vazio. Revise o resultado, ajuste o que desejar e salve.

Dentro da automação, tudo o que a IA enviou está disponível através dos botões de dados usuais: cada parâmetro em trigger.args, além de qual contato e canal a conversa está utilizando.

Respondendo ao agente. Adicione uma etapa Retornar resposta e tudo o que for enviado de volta se tornará a resposta que a IA lerá — assim, ela pode citar dados reais na mesma interação da conversa: consultar estoque em seu próprio banco de dados, verificar uma agenda, calcular um orçamento. Sem uma etapa de Retornar resposta, o agente é simplesmente informado de que a automação começou e continua — ideal para trabalhos do tipo “registre esta reclamação no meu sistema” que não precisam de uma resposta. Uma coisa a ter em mente: o agente aguarda até 25 segundos por uma resposta, portanto, mantenha as etapas de Atraso fora do caminho entre o gatilho e a etapa de Retornar resposta.

Enquanto a automação estiver desativada, os agentes não podem chamá-la — a função desaparece de suas habilidades até que você a ative novamente.

Você também notará a função listada na sua página de Funções Personalizadas com um selo “Gerenciado por automação”. Essa entrada é cuidada para você — seu nome e campos seguem o que você definir no gatilho — portanto, não pode ser editada ou excluída lá; abra a automação em vez disso.

Adicionando contatos a uma automação

A maioria dos gatilhos aguarda algo acontecer. O gatilho Contato adicionado é aquele que você mesmo controla: você escolhe os contatos e a automação é executada uma vez para cada um deles. É assim que você cria uma sequência de acompanhamento, uma série de boas-vindas ou uma campanha de reengajamento — mensagem, espera, mensagem novamente — e insere pessoas nela sempre que desejar.

Crie-a como qualquer outra automação: use o gatilho Contato adicionado e, em seguida, adicione suas etapas. Tudo sobre o contato fica disponível para essas etapas através dos botões de dados usuais — nome, telefone, e-mail e canal — para que uma etapa de Enviar mensagem possa cumprimentá-lo pelo nome, e ela já saiba para qual contato enviar.

Existem quatro lugares para adicionar pessoas, para que você possa fazer isso de onde já estiver:

De Contatos, em massa. Vá para Contatos, marque os contatos que deseja — um, alguns ou todos em uma lista filtrada — e clique em Automação na barra inferior. Escolha a automação e clique em Adicionar contatos. Apenas automações com o gatilho Contato adicionado aparecem, e aquelas que ainda estão pausadas ficam cinzas até que você as ative.

De um contato. Abra um contato para exibir seu painel de detalhes e clique em Adicionar à automação.

A partir de uma conversa. Em Chats, abra o menu de três pontos no topo da conversa e escolha Adicionar à automação — útil quando você está no meio de uma resposta e percebe que essa pessoa deve entrar na sua sequência de acompanhamento.

A partir da própria automação. Esta é a opção a ser usada quando você olha para uma automação e pensa “quem entra aqui?”. Na lista de Automações, uma automação de Contato adicionado que esteja ativada possui um ícone de adicionar pessoa em sua linha; clique nele e pesquise seus contatos por nome, telefone ou e-mail, marque os que deseja e adicione-os. O mesmo botão fica no topo do painel de Contatos adicionados da automação em sua página de Registro.

Qualquer que seja o caminho escolhido, a automação começa a ser executada para esses contatos e você pode continuar trabalhando.

Adição gradual (drip). Adicionar algumas centenas de pessoas de uma vez significa centenas de mensagens sendo enviadas em um curto intervalo, o que raramente é o que você deseja — especialmente no WhatsApp. Marque Adicionar gradualmente na mesma caixa de diálogo e defina quantos contatos adicionar por vez e quantos minutos aguardar entre os lotes: 20 contatos a cada 30 minutos distribui uma lista de 500 pessoas ao longo de cerca de meio dia. O que quer que você escolha, os contatos são sempre inseridos de forma constante em vez de todos de uma vez, para que um lote grande não sobrecarregue sua conta.

Monitorando o progresso. Abra a automação e clique em Registro. Acima do histórico de execução, o painel de Contatos adicionados mostra cada lote que você adicionou, quantos contatos foram processados até o momento e botões para Pausar, Retomar ou Cancelar. Pausar impede que novos contatos sejam adicionados; as execuções já iniciadas terminam normalmente. Cancelar interrompe o restante permanentemente — não pode ser retomado.

Adicionando a mesma pessoa duas vezes. Por padrão, cada contato só pode passar por uma determinada automação uma vez: adicione-o novamente mais tarde e ele será ignorado silenciosamente, contado como “ignorado” na linha de progresso. Se você quiser que um contato possa passar por ela novamente — um check-in mensal, por exemplo — abra o gatilho e altere Reentrada para “Contatos podem entrar várias vezes”.

Duas coisas que vale a pena saber: os detalhes do contato são capturados no momento em que você adiciona alguém, portanto, editar um número de telefone posteriormente não altera uma execução que já está na fila; e se você desligar a automação enquanto os contatos ainda estão sendo adicionados, o lote é pausado em vez de falhar — ligue-a novamente e clique em Retomar.

Etapas

Após o gatilho, adicione quantas etapas precisar:

  • Ações — faça algo no Your AI Connector: envie uma mensagem a um contato, edite seus detalhes, adicione etiquetas, mova-os entre listas ou campanhas, crie e atualize tarefas e negócios, agende, mova ou cancele compromissos, procure informações para usar mais tarde no fluxo de trabalho ou alerte um humano. A lista completa está em Ações abaixo.

  • Integrações — conecte um aplicativo externo (Google Sheets, Slack e outros) e use suas ações dentro da sua automação. Conecte-o uma vez a partir do construtor e, em seguida, arraste-o como qualquer outra etapa. Se uma etapa usar um aplicativo que você ainda não conectou, a etapa mostrará um pequeno ponto âmbar na tela e seu painel de configurações mostrará um botão Conectar exatamente onde você precisa — clique nele, aprove o aplicativo na guia que se abre e a etapa será desbloqueada automaticamente. Isso também cobre automações que a IA cria para você: qualquer etapa que ainda precise de uma conexão de aplicativo informará isso antes que você ative a automação.

    Toda ação que você encontrar sob o cabeçalho Popular de um aplicativo vem com um formulário guiado em vez de campos técnicos. Adicionar uma linha ao Google Sheets, por exemplo, guia você pelo processo: escolha uma de suas planilhas em uma lista, escolha a aba e, em seguida, cada um dos cabeçalhos de coluna da sua planilha aparecerá como seu próprio campo para preencher — com os botões de dados usuais para inserir valores de etapas anteriores. Encontrar uma linha funciona da mesma maneira: escolha a planilha e a aba, digite o que pesquisar, pronto. O mesmo tratamento cobre Gmail (enviar, rascunhar, responder, encontrar e-mails), Slack (canais vêm de uma lista ao vivo), Notion (escolha um banco de dados e cada uma de suas propriedades aparece como um campo), HubSpot (contatos, negócios, empresas, tickets), Google Calendar (escolha uma agenda da sua própria lista ao criar ou encontrar eventos), Google Docs (escolha um documento de uma lista) e Telegram. Qualquer coisa incomum fica atrás de Mostrar opções avançadas com valores sensatos já definidos. Etapas configuradas antes disso existir continuam funcionando como estão; abra uma e escolha Mudar para modo simples sempre que quiser a versão guiada.

    Use Testar etapa dentro de qualquer etapa de integração para executar apenas essa etapa de verdade — para o exemplo do Sheets, a linha aparece realmente na sua planilha, para que você saiba que a automação funciona antes de ativá-la.

  • E-mail (seu servidor de e-mail) — envie um e-mail do seu próprio servidor de e-mail, em vez de usar o Gmail. Escolha-o como o tipo de etapa e preencha os detalhes de envio do seu provedor uma vez: endereço do servidor, porta, nome de usuário, senha e o endereço do qual você deseja que o e-mail venha. Você encontrará isso nas configurações do seu provedor de e-mail, geralmente sob “SMTP” ou “Envio”. Verificamos os detalhes com seu servidor de e-mail antes de salvar, então, se algo estiver errado, você descobre imediatamente, em vez de na primeira vez que a automação for executada.

    Duas coisas que vale a pena saber. Use a porta 587 — ela é criptografada, quase todos os provedores a suportam e é a porta que funciona a partir da nossa rede de envio. E se sua conta de e-mail usa login em duas etapas, crie uma senha de aplicativo nas configurações da conta do seu provedor em vez de digitar sua senha normal.

    Uma vez conectado, a etapa é apenas Para, Assunto e Mensagem, com os botões usuais para inserir dados de etapas anteriores. Cc e Cco também estão lá, se você precisar. Sua senha é armazenada criptografada e nunca é exibida para você — reconectar solicitará a senha novamente.

  • Aplicativos integrados — algumas ferramentas possuem suas próprias etapas de primeira classe, separadas do catálogo de integrações:

    • Mollie — crie um link de pagamento ou verifique se um pagamento foi efetuado. Conecte-o uma vez com sua chave de API do Mollie (Painel do Mollie → Desenvolvedores → Chaves de API).
    • WooCommerce — pesquise um cliente ou pedido em sua loja, mova um pedido para um novo status ou crie um código de cupom. Conecte-o com o endereço da sua loja mais uma chave de API REST (WooCommerce → Configurações → Avançado → API REST → Adicionar chave).

    A conexão funciona da mesma forma que a etapa de e-mail: os detalhes são verificados em tempo real com o serviço antes que qualquer coisa seja salva, as chaves são armazenadas criptografadas e nunca exibidas novamente para você, e cada etapa recebe campos simples com os botões usuais de inserção de dados.

  • Consulta de banco de dados — para usuários técnicos: execute uma consulta SQL em seu próprio banco de dados MySQL ou Postgres externo (pesquise um cliente no banco de dados da sua loja, por exemplo). Adicione uma conexão uma vez — ela é testada em tempo real antes de salvar — e então escreva a consulta. Use espaços reservados $1, $2 (Postgres) ou ? (MySQL) para valores que vêm de etapas anteriores e coloque esses valores no campo Valores, para que o texto digitado pelo contato nunca seja colado diretamente no seu SQL. O banco de dados deve ser acessível pela internet.

  • Requisição HTTP — chame qualquer endereço web externo diretamente, para ferramentas que ainda não possuem uma integração nativa.

  • Condição — ramifique a automação em um dos dois caminhos, dependendo de uma regra que você definir. Insira o item que deseja verificar com o botão + em vez de digitá-lo, escolha como compará-lo (é igual a, contém, é maior que, corresponde a regex…) e digite o valor de comparação. Contém procura pelo texto exato que você digitou; quando precisar de um padrão — várias grafias de uma palavra-chave, uma palavra apenas no início de uma mensagem, um formato de número de pedido — escolha corresponde a regex e digite uma expressão regular como ^(ja|yes)\b. Adicione sinalizadores do estilo /i escrevendo o padrão como /ja|yes/i. Um padrão que não seja válido falha na etapa com um erro no histórico de execução, em vez de seguir silenciosamente pelo caminho falso. As etapas no caminho verdadeiro são executadas quando a regra corresponde, as etapas no caminho falso quando não corresponde; um caminho que você deixar vazio simplesmente encerra a execução. Verificar as tags de alguém é uma das opções mais úteis — insira os tag_names do contato e use contém com o nome da tag, como em Exemplo: ignore qualquer pessoa marcada como spam abaixo.

    Uma Condição também pode ramificar com base no relógio em vez de um valor. Defina seu Tipo de condição como Hora do dia e forneça um horário de início, um horário de término e um fuso horário: o caminho verdadeiro é executado enquanto o horário atual estiver dentro dessa janela, e o caminho falso fora dela. Definir um término antes do início cria uma janela noturna (21:00 às 08:00), e as opções de Dias limitam a automação a certos dias da semana — deixe-os todos desativados para todos os dias. O sistema verifica o relógio no momento em que a etapa é executada, portanto, uma condição de tempo colocada após um Atraso analisa o horário em que a etapa é realmente alcançada, não o horário em que a execução começou. É assim que você cria “uma automação, comportamento diferente por horário” — faça uma coisa durante o dia e outra à noite; quando, na verdade, a automação não deveria ser executada fora de uma janela, use Executar apenas durante estes horários no gatilho.

    Em uma condição normal de Comparar um valor, você também pode comparar diretamente com o relógio: o grupo Hora atual no seletor de inserção de dados oferece now.hour (0–23), now.minute, now.weekday (1 = segunda-feira … 7 = domingo), now.day, now.month e now.year. Eles são lidos em UTC, a menos que você preencha o campo opcional de fuso horário da condição.

  • Etapa de IA — peça para a IA integrada ler os dados até o momento e gerar uma resposta ou decisão como parte do fluxo de trabalho. Escreva um prompt, insira valores de etapas anteriores, e a saída da etapa estará disponível para todas as etapas seguintes. Não há nada para configurar além do prompt — a própria IA é gerenciada para você. As configurações da etapa informam o preço antecipadamente: cada vez que uma etapa de IA é executada, ela consome 0,25 créditos (portanto, uma etapa de IA dentro de um Loop consome 0,25 créditos por repetição), e o Testar etapa executa a IA real, portanto, consome os mesmos 0,25 créditos.

    Dois limites que vale a pena conhecer, ambos generosos o suficiente para que a maioria das automações nunca os atinja. As respostas têm um comprimento máximo; se a IA precisar de mais espaço do que isso, a resposta será cortada — você verá uma nota informando isso ao testar a etapa, então peça algo mais curto ou divida o trabalho em duas etapas de IA. E o próprio prompt tem um tamanho máximo assim que os dados das etapas anteriores são preenchidos: se você inserir uma quantidade muito grande de dados (um longo histórico de chat, uma página inteira extraída), a execução para com uma mensagem instruindo você a inserir menos.

  • Atraso — pause antes de continuar. O Tipo de espera oferece duas maneiras de fazer isso. Por um período fixo de tempo é o clássico: aguarde 10 minutos, 2 horas, 3 dias, com um pouco de variação aleatória opcional para que execuções consecutivas não disparem todas no mesmo segundo. Até um momento específico aguarda por uma data e hora — geralmente uma que você insere de uma etapa anterior com o botão +, como o horário de início do compromisso — e um Deslocamento em minutos o altera: -180 significa três horas antes daquele momento, -1440 um dia antes, 0 o momento em si. Se o momento já tiver passado quando a execução chegar à etapa, ela não aguarda nada e simplesmente continua; esperas superiores a 30 dias são recusadas. Esperas de mais de meio minuto pausam a execução corretamente em vez de mantê-la aberta — a execução aparece como aguardando até chegar a hora, então minutos, horas e dias funcionam perfeitamente.

  • Loop — repita um grupo de etapas uma vez para cada item em uma lista (por exemplo, uma vez por contato que Encontrar contatos retornou, ou uma vez por tag em um contato). Deixe Máximo de iterações em branco para percorrer todos os itens, até 1.000; defina um número para parar antes. Uma lista longa não precisa caber de uma só vez: quando uma execução está perto do seu limite de tempo, o loop pausa onde está e retoma alguns segundos depois a partir do mesmo item, para que uma varredura diária em várias centenas de contatos termine por conta própria. Um Atraso dentro do loop funciona da mesma maneira — o loop aguarda e continua com a próxima etapa para aquele item.

  • Retornar resposta — para automações que começam com um gatilho de Webhook ou Função de Agente de IA: envie dados de volta para o que quer que tenha chamado a automação — a ferramenta externa que acessou seu webhook ou seu próprio agente de IA no meio da conversa. Por padrão, uma chamada apenas recebe uma confirmação; adicione esta etapa e o chamador receberá sua própria resposta — escolha um código de status, escreva o corpo (JSON ou texto simples) e insira valores de etapas anteriores, para que a ferramenta que chamou você receba, por exemplo, a linha que você pesquisou ou o contato que você criou. O chamador aguarda até 30 segundos; se a automação levar mais tempo do que isso (uma etapa de Atraso antes, por exemplo), ela volta para a confirmação normal e a automação continua independentemente. Testar etapa mostra uma prévia da resposta com seus dados de exemplo.

Há também uma etapa de Transformação para remodelar dados com um pouco de código — esta é para usuários técnicos confortáveis em escrever um pequeno script; todos os outros podem ignorá-la com segurança.

Ações

As ações são as coisas que uma automação faz dentro do próprio Your AI Connector — sem aplicativo para conectar, nada para configurar primeiro. Elas estão agrupadas no seletor da mesma forma que estão agrupadas aqui.

Contatos

Ação O que faz
Criar contato Adiciona um novo contato. Um número de telefone é obrigatório. Se um contato com esse número já existir na conta (uma grafia de WhatsApp equivalente do número conta como o mesmo contato), a etapa retorna o contato existente em vez de falhar ou criar uma duplicata, e o log de execução registra que o fez. Etapas posteriores obtêm o ID do contato de qualquer maneira
Atualizar contato Altera o nome, e-mail ou número de telefone de um contato
Encontrar contato Pesquisa um contato por número de telefone ou e-mail, para que etapas posteriores possam usar seus detalhes
Encontrar contatos Lista contatos — todos, uma pesquisa de texto livre, uma lista ou filtrados. O caminho rápido: Com tag retorna apenas contatos que possuem uma tag, Sem tag exclui todos que possuem uma (tags correspondidas por nome; um nome que não existe faz a etapa falhar com uma mensagem clara, para que um erro de digitação não retorne ninguém silenciosamente). O caminho poderoso: Filtros avançados abre o mesmo construtor de regras que as listas inteligentes usam, para que você possa filtrar por qualquer coisa que uma lista inteligente possa — tags, listas, canal, status, datas de atividade, IA ligada/desligada, não perturbe, nome/e-mail/telefone, estágio do negócio, campos personalizados — com uma contagem em tempo real de quantos contatos correspondem. Quando os Filtros avançados são definidos, eles assumem o controle e os campos simples acima são ignorados. Quantos define quantos contatos a etapa retorna, até 1.000 por execução (o padrão é 50); qualquer valor acima de 100 é buscado em lotes nos bastidores, para que uma varredura diária em algumas centenas de contatos caiba em uma execução
Ligar ou desligar IA para um contato Liga ou desliga o agente de IA para aquele contato específico, sem afetar mais ninguém
Definir não perturbe Interrompe (ou retoma) qualquer saída para aquele contato, com uma nota opcional dizendo o motivo
Definir campo personalizado Escreve um campo personalizado em um contato e deixa os outros como estão. O campo é criado se ainda não existir
Adicionar contato à lista / Remover contato da lista Move um contato para dentro ou para fora de uma de suas listas de contatos
Atribuir agente de IA ou campanha Entrega o contato a um agente de IA diferente, para que a persona e as configurações desse agente assumam o controle a partir da próxima mensagem — a mesma coisa que Atribuir Agente de IA no menu de um chat, mas feito pelo fluxo de trabalho. Escolha o agente na lista; o campo também aceita uma campanha clássica ativa para configurações mais antigas. Opcionalmente, permita que o novo agente responda imediatamente. É assim que você alterna agentes no meio da conversa: pontos de entrada de palavras-chave apenas decidem quem responde a uma conversa totalmente nova, então um gatilho de Mensagem recebida restringido a uma palavra como “suporte” seguido por esta ação move um chat existente para seu agente de suporte. Passo a passo: Alternar Agente de IA no Meio da Conversa
Definir tag de contato / Remover tag de contato Aplica ou remove uma tag por nome. Uma tag que ainda não existe é criada

Mensagens

Ação O que ela faz
Enviar mensagem Envia uma mensagem no canal em que o contato já está — WhatsApp, SMS, Instagram ou Messenger, dependendo de por onde ele entrou. Você pode anexar uma imagem ou arquivo por link e, com um link de mídia, o texto pode ser deixado vazio. Para qualquer coisa que não seja uma imagem, preencha o Tipo de mídia com o tipo MIME do arquivo (application/pdf, audio/ogg, video/mp4) para que o canal o anexe da maneira correta, e opcionalmente o Nome do arquivo para o nome que o destinatário verá no documento. Para entregar áudio como uma nota de voz do WhatsApp (a bolha de reprodução, não um arquivo), ative Enviar como nota de voz e certifique-se de que o áudio esteja em OGG/Opus com o tipo de mídia audio/ogg. Um MP3 enviado como nota de voz é reproduzido em alguns telefones e aparece como arquivo em outros, portanto, converta antes. Esta ação substitui as antigas etapas separadas “Enviar WhatsApp” e “Enviar SMS”, que já faziam exatamente isso; automações que ainda as utilizam continuarão funcionando
Enviar modelo de WhatsApp Envia um dos seus modelos de WhatsApp aprovados, que é o que alcança alguém fora da janela de 24 horas do WhatsApp. Forneça um contato ou um número de telefone simples — com um número, o contato é pesquisado e criado caso ainda não exista. As variáveis do modelo são preenchidas a partir dos detalhes do próprio contato, não digitadas nesta etapa. Requer o canal da API do WhatsApp Business conectado. Veja Modelos de WhatsApp
Enviar mensagem via WhatsApp Web Envia através de um telefone WhatsApp Web vinculado por QR code, endereçado pelo número em formato internacional completo (+31612345678). Para contas no canal WhatsApp Web. O número para o qual você envia é apenas um destinatário — ele não precisa estar conectado como um canal em si (um telefone de gerente recebendo relatórios de agendamento é o caso típico). Se você conectar o telefone do destinatário como um segundo canal na mesma conta, cada mensagem entre os dois telefones será registrada duas vezes (uma por canal) e o novo número pode ser o escolhido para enviar, o que, em seu primeiro dia de aquecimento, tem um limite de 0 novos contatos — a execução falha com Daily limit of 0 new contacts reached. Mantenha o destinatário como um número simples. Envios também são recusados quando o contato destinatário está em Não Perturbe (a execução mostra Contact is on Do Not Disturb list); desative o Não Perturbe nesse chat primeiro

Tarefas

Ação O que faz
Criar tarefa Cria uma tarefa, opcionalmente com uma descrição, data de vencimento, responsável e um contato
Atualizar tarefa Altera o título, descrição, estágio, prioridade, data de vencimento ou contato de uma tarefa
Encontrar tarefa / Encontrar tarefas Carrega uma tarefa ou uma lista filtrada por estágio, prioridade, contato, negócio, responsável ou data de vencimento — para que a automação possa ramificar com base no que encontrar

Negócios

Ação O que faz
Criar negócio Cria um negócio. O estágio é obrigatório e deve ser um dos estágios do seu pipeline
Atualizar negócio Altera o título, valor, estágio, status ou contato de um negócio
Mover estágio do negócio Move um negócio para outro estágio e coloca o cartão no topo dessa coluna

Compromissos

Ação O que ela faz
Criar agendamento Reserva um agendamento para um contato em um dos seus tipos de evento agendáveis
Cancelar agendamento Cancela um agendamento, com um motivo opcional. Ele permanece no registro como cancelado em vez de desaparecer
Reagendar agendamento Move um agendamento para um novo horário. Defina o horário de término, bem como o de início — ele não é recalculado a partir da duração do tipo de evento
Encontrar agendamento / Encontrar agendamentos Carrega um agendamento, ou uma lista para um contato, um dia ou um status
Encontrar horários disponíveis Lista os horários livres em um dos seus tipos de evento entre dois momentos, para que uma etapa posterior possa oferecer ou reservar um

Outros

Ação O que ela faz
Registrar evento Registra um evento personalizado no log de automação da sua conta — útil para contar com que frequência algo aconteceu
Alertar humano Envia um e-mail e notifica você de que alguém precisa intervir, com prioridade baixa, média ou alta, nomeando o contato se você apontar para um

Como as variáveis são escritas. Tudo o que você inserir com o botão + aparece como ${…} — por exemplo ${trigger.contact.first_name} ou ${trigger.appointment.start_time} — e esse é o único formato que a automação resolve. O estilo {{first_name}} que você talvez conheça de modelos de campanha e transmissão não é compreendido aqui: ele é enviado exatamente como digitado, então a mensagem chega com {{first_name}} nela em vez do nome. Se uma mensagem foi enviada com o texto do marcador de posição ainda nela, quase sempre é por isso — exclua o marcador de posição e insira-o novamente com o botão +. Campos personalizados ficam em contato como tudo o mais sobre a pessoa (${trigger.contact.your_field_key}).

Uma coisa que vale a pena saber sobre o preenchimento desses campos: qualquer coisa que termine em ID — ID do Contato, ID da Tarefa, ID do Agendamento — deve ser inserida a partir de uma etapa anterior com o botão + em vez de ser digitada manualmente; a dica abaixo de cada campo indica isso.

Exemplo: lembretes de agendamento 24 horas e 3 horas antes

Esta é a automação que a maioria das pessoas cria primeiro, então aqui está ela de ponta a ponta.

1. Inicie a automação. AI Studio → Automações → Nova automação, então clique no gatilho na tela.

2. Escolha o gatilho. Clique em Alterar gatilho, abra Agendamentos e escolha Antes de um agendamento.

3. Escolha seus horários de lembrete. Em Lembretes, clique nos chips 24 horas antes e 3 horas antes. Precisa de algo que não é oferecido — 45 minutos, por exemplo? Digite o número de minutos em Outro e clique em Adicionar. Você pode ter até cinco lembretes em uma automação, e pelo menos um: sem nenhum definido, a automação nunca é executada.

Se algum dos seus agendamentos começar cedo o suficiente para que um lembrete caia durante a noite, ative Respeitar horário de silêncio na parte inferior do mesmo painel de gatilho — o lembrete ainda é executado no horário, a mensagem apenas aguarda até as 8h no horário local do contato. Veja Respeitando o horário de silêncio.

Cada lembrete é executado uma vez por agendamento, portanto, dois lembretes significam duas execuções para a mesma reserva. Isso se aplica a agendamentos já existentes no seu calendário, não apenas aos agendados após você ativá-la — e ela acompanha as alterações: mova um agendamento e seus lembretes se movem com ele, cancele-o e eles também serão cancelados. Um lembrete cujo momento já passou quando a reserva é feita (um lembrete de 24 horas em um agendamento marcado para esta tarde) é simplesmente ignorado em vez de enviado com atraso.

4. Opcional: dê a cada lembrete uma redação diferente. Adicione uma etapa de Condição após o gatilho e escolha Lembrete: minutos antes como o campo, ==, e 1440 como o valor. O caminho verdadeiro é a mensagem do dia anterior (“Nos vemos amanhã às…”), o caminho falso é o de três horas (“Nos vemos em breve às…”). Ignore isso se a mesma redação servir para ambos.

5. Envie a mensagem. Adicione uma ação Enviar mensagem. Para ID do Contato, clique em + e insira o contato do agendamento. Para a mensagem, escreva seu lembrete e use + para inserir o primeiro nome do contato e o horário de início do agendamento — por exemplo:

Hi ${trigger.contact.first_name}, a reminder about your appointment on ${trigger.appointment.start_time}. Reply CONFIRM to keep it or CANCEL if you can't make it.

Outros detalhes que o gatilho lhe fornece: a sala do agendamento, seu resumo, o telefone e e-mail do contato e qual lembrete é esta execução. O horário de início chega como uma data e hora completas (2026-09-01T10:00:00Z), então, se você preferir que a mensagem diga “amanhã às 10:00”, coloque uma etapa de IA antes da mensagem e peça para ela expressar o horário nas próprias palavras do contato.

6. Teste e depois ative. Clique em Executar para dispará-la uma vez com dados de exemplo, verifique a execução no Log e, em seguida, alterne o botão Ativado.

Sobre a janela de 24 horas do WhatsApp. Se o contato enviou uma mensagem para você pela última vez há mais de 24 horas, o WhatsApp não permitirá o envio de uma mensagem normal — que é exatamente a situação de um lembrete feito um dia antes. Use a ação Enviar modelo do WhatsApp para esse lembrete, com um modelo aprovado; um modelo tem permissão para abrir a conversa e também reabre a janela de 24 horas para que a resposta do contato possa ser tratada normalmente. O lembrete de três horas pode frequentemente usar uma Enviar mensagem simples, porque, a essa altura, o contato pode ter respondido à primeira. Veja Modelos do WhatsApp para criar e obter um modelo aprovado.

Sobre os botões Confirmar / Cancelar. Botões de resposta rápida clicáveis ainda não estão disponíveis em automações. A maneira de fazer isso hoje é solicitar uma palavra de resposta — “responda CONFIRMAR para manter ou CANCELAR para cancelar” — e lidar com a resposta com seu agente de IA (ele lê a resposta como qualquer outra mensagem e pode cancelar ou reagendar) ou com uma segunda automação no gatilho Mensagem recebida, filtrada para mensagens que contenham CANCELAR, que localiza o agendamento com Encontrar agendamentos para aquele contato, executa Cancelar agendamento e avisa você com Alertar humano.

Exemplo: ignore qualquer pessoa marcada como spam

Marque um contato que faz você perder tempo uma vez e nunca mais ouça falar dele — o mesmo formato funciona para “responder apenas a pessoas marcadas como VIP”, “pular qualquer pessoa marcada como Cliente” e assim por diante.

1. Inicie a automação. AI Studio → Automações → Nova automação, então clique no gatilho na tela.

2. Escolha o gatilho. Clique em Alterar gatilho, abra Mensagens e escolha Mensagem recebida. Deixe o canal em Qualquer canal para que cubra todas as conversas.

3. Adicione a verificação. Adicione uma etapa de Condição após o gatilho. No primeiro campo, clique no botão +, digite tag na caixa de pesquisa e escolha tag_names (aquela em contato, no grupo gatilho de mensagem recebida) — essas são as tags do contato por nome. O campo se preenche automaticamente como ${trigger.contact.tag_names}. Defina a comparação como contém e, na caixa de valor, digite a tag exatamente como você a nomeou, por exemplo spam.

4. Decida o que acontece. No caminho verdadeiro — aquele que é executado quando o contato possui a tag — adicione uma ação Definir não perturbe, que impede que qualquer mensagem de saída seja enviada para ele. Preencha três coisas: ID do contato com o botão + (insira o contato do gatilho, não digite), Não perturbe como true e, opcionalmente, um Motivo para seus próprios registros. Prefere manter a conversa aberta, mas silenciar a IA? Use Ativar ou desativar IA para um contato em vez disso, com IA ativada definido como false. Deixe o caminho falso vazio: todos os outros continuam normalmente.

5. Teste e ative. Clique em Executar para disparar uma vez com dados de exemplo, verifique a execução em Log e, em seguida, alterne a chave Ativado.

Três coisas que vale a pena saber:

  • Letras maiúsculas contam. Uma tag chamada Spam não corresponderá a spam. Copie o nome em Configurações → Tags se não tiver certeza — veja Criando Tags.
  • Escolha tag_names, não tags. Logo ao lado, na mesma lista, está tags, que contém códigos de ID internos em vez de nomes. Uma verificação em relação a isso nunca pode corresponder a uma palavra que você digita, então a automação seguiria silenciosamente o caminho falso para sempre. Se você preferir digitar o campo em vez de escolhê-lo, o que você deseja é ${trigger.contact.tag_names}.
  • Aplica-se a partir da próxima mensagem. A verificação lê as tags que o contato possui no momento em que a mensagem chega, portanto, marcar alguém não desfaz as mensagens já enviadas. Se você quiser que a própria tag seja o ponto de partida, use o gatilho Contato atualizado, que é disparado no momento em que uma tag é adicionada ou removida.

Exemplo: entre em uma lista com uma palavra-chave (e saia com outra)

Permita que as pessoas se inscrevam em uma lista enviando uma palavra — JOIN, VIP, OFFERS — e cancelem a inscrição com a mesma facilidade. Duas pequenas automações, uma lista de contatos e suas transmissões ganham um público que se constrói sozinho.

1. Inicie a automação. AI Studio → Automações → Nova automação, então clique no gatilho na tela.

2. Escolha o gatilho. Clique em Alterar gatilho, abra Mensagens e selecione Mensagem recebida. Escolha o canal no qual a palavra-chave deve funcionar — WhatsApp, por exemplo — ou deixe em Qualquer canal. Em Contém texto, digite a palavra-chave, por exemplo JOIN. Letras maiúsculas não importam aqui: join, Join e JOIN correspondem da mesma forma.

3. Adicione-os à lista. Adicione uma ação Adicionar contato à lista. Insira o ID do contato com o botão + — o contato vem com o gatilho — e escolha a lista na qual as pessoas devem entrar. Se você ainda não tiver uma, crie-a primeiro (veja Gerenciamento de Listas e Contatos).

4. Opcional: confirme. Adicione uma ação Enviar mensagem logo após, com o ID do contato inserido da mesma forma, com algo como “Você está na lista! Responda STOP a qualquer momento para sair.”

5. Teste e ative. Clique em Executar para disparar uma vez com dados de exemplo, verifique a execução em Log e, em seguida, alterne a chave Ativado.

6. Crie a saída. Faça uma segunda automação da mesma maneira: o mesmo gatilho com STOP em Contém texto e uma ação Remover contato da lista em vez disso. Mencione a palavra de parada no que você enviar — pessoas que sabem que existe uma saída educada não bloqueiam o número para conseguir sair.

A partir de então, qualquer transmissão pode usar essa lista como seu público — todos que enviaram a palavra-chave, menos todos que enviaram posteriormente a palavra de parada. Uma transmissão contínua que envia mensagens para novos membros da lista inclui automaticamente quem entrou pela palavra-chave.

Uma coisa que vale a pena saber: Contém texto corresponde a qualquer parte da mensagem, então “joining you tomorrow” contém join. Escolha uma palavra que as pessoas não usariam no meio de uma frase ou use o campo Regex do gatilho quando precisar de uma correspondência exata.

Exemplo: mover um lead do Instagram ou Facebook para o WhatsApp quando a janela se fecha

Um funil de anúncios comum: as pessoas veem seu anúncio no Instagram ou Facebook, enviam uma DM para sua página, e seu agente de IA as qualifica e pede o número de telefone. Quando um lead digita seu número ou e-mail no chat, a IA o salva nos campos de telefone e e-mail do contato automaticamente, em tempo real — não há nada para mapear ou configurar nessa parte.

O que não acontece automaticamente é o salto para o WhatsApp. O Instagram e o Messenger só permitem mensagens dentro de 24 horas após a última mensagem do contato, não suportam modelos para reabrir a conversa, e os acompanhamentos integrados do Your AI Connector sempre permanecem no canal em que a conversa está — portanto, assim que a janela se fecha, os acompanhamentos nesses canais são simplesmente ignorados (veja Sistema de Acompanhamento). Esta automação faz o salto para você, usando o número que a IA capturou:

1. Inicie a automação. AI Studio → Automações → Nova automação, então clique no gatilho na tela.

2. Escolha o gatilho. Clique em Alterar gatilho, abra Contatos e escolha Contato atualizado, restringindo ao campo número de telefone. Ele é disparado no momento em que a IA salva um número capturado — não importa em qual canal a conversa esteja.

3. Adicione um Atraso. Uma espera fixa de, digamos, 24 horas dá à conversa — e a quaisquer acompanhamentos rápidos dentro da janela — tempo para fazer seu trabalho primeiro. Se o lead converter nesse meio tempo, você pode interromper a execução com uma Condição antes da próxima etapa (verificando os tag_names do contato para algo como Customer, o mesmo padrão do Exemplo: ignorar qualquer pessoa que você marcar como spam).

4. Envie o modelo. Adicione uma ação Enviar modelo do WhatsApp, insira o ID do Contato com o botão + e escolha um de seus modelos aprovados. Modelos têm permissão para abrir uma conversa, então isso funciona não importa há quanto tempo o lead esteja em silêncio — esse é o objetivo principal da etapa. As variáveis do modelo são preenchidas a partir dos próprios campos do contato, e isso requer que seu canal da API do WhatsApp Business esteja conectado. Veja Modelos do WhatsApp para criar e aprovar um.

5. Teste e ative. Clique em Executar para disparar uma vez com dados de exemplo, verifique a execução em Log e, em seguida, alterne a chave Ativado.

Quando o lead responde, a conversa passa para o WhatsApp — dentro de sua janela de 24 horas — e seu agente continua a partir daí.

Exemplo: IA à noite, sua equipe durante o dia

Algumas equipes invertem os turnos: o agente de IA cobre a noite e a madrugada, e pessoas reais assumem pela manhã. Defina os horários ativos do agente para o turno da noite e isso já é metade do trabalho — uma mensagem que chega durante o dia é respondida pela IA quando seus horários abrirem novamente, e ela aparece sob o filtro Fora do horário em Chats enquanto isso.

A outra metade é tornar a transferência matinal automática, para que um chat que a IA abriu às 21h não fique esperando até as 21h do dia seguinte quando o cliente responder às 10h da manhã. Duas pequenas automações fazem isso — a primeira pausa a IA em qualquer chat que receba uma mensagem durante o dia, a segunda devolve tudo para a IA à noite:

Automação 1 — transferir chats diurnos para sua equipe.

  1. AI Studio → Automações → Nova automação. O gatilho já é Mensagem recebida; deixe-o em toda a conta ou restrinja-o a um agente.
  2. Nas configurações do gatilho, ative Executar apenas durante estes horários e defina o dia da sua equipe — digamos, das 08:00 às 20:45 — com seu fuso horário (veja Executar apenas durante determinados horários).
  3. Adicione uma ação Ativar ou desativar IA para um contato: insira ID do contato com o botão +, defina IA ativada como false.
  4. Adicione uma ação Definir etiqueta de contato com uma etiqueta como day-shift, para que a automação noturna possa encontrar esses chats novamente.

Agora, qualquer mensagem que chegar durante o dia pausará a IA nessa conversa imediatamente: o chat aparece sob seu filtro IA pausada e sua equipe responde a partir daí. Responder manualmente também cancela a resposta na fila da IA para aquele chat, então a IA não voltará a intervir quando seus horários abrirem.

Automação 2 — devolver os chats para a IA à noite.

  1. Nova automação com o gatilho Agendado, definido para alguns minutos antes do início dos horários da IA — para um início às 21h, o cron 50 20 * * * com o mesmo fuso horário.
  2. Adicione uma ação Encontrar contatos filtrada por Com etiqueta day-shift.
  3. Adicione um Loop sobre o resultado com dois passos dentro: Ativar ou desativar IA para um contato com IA ativada true, depois Remover etiqueta de contato day-shift.

Os chats que sua equipe finalizou durante o dia voltam para a IA durante a noite, e um chat diurno que ninguém atendeu ainda recebe sua resposta da IA na fila no momento em que os horários do agente abrirem — nada é perdido.

Na barra de ferramentas da tela, Executar dispara a automação uma vez usando dados de exemplo, sem ativá-la para contatos reais — uma maneira segura de verificar se funciona. Reexecutar a executa novamente com os dados reais da sua última execução. Log abre o histórico de execuções, para que você possa ver cada execução passada e se ela foi bem-sucedida, falhou ou ainda está em andamento.

Três coisas ajudam você a detectar um erro antes que seus contatos o façam:

  • Uma etapa que não possui algo obrigatório não será iniciada. Campos marcados como obrigatórios são verificados antes de uma execução e antes que a chave Ativado seja ligada: se uma etapa Enviar mensagem não tiver um ID de contato, você receberá uma mensagem nomeando a etapa e o campo, em vez de uma execução que falha silenciosamente. Preencha-o e a chave funcionará normalmente. Pausar nunca é bloqueado.
  • Variáveis que não são resolvidas são relatadas. Se um valor ${…} em uma de suas etapas não encontrou nada — um nome de campo com erro de digitação ou dados que o gatilho na verdade não carrega — a etapa ainda é executada com essa parte em branco, e o detalhe da execução mostra uma linha de Avisos nomeando exatamente quais vieram vazios. Essa geralmente é a resposta para “por que minha mensagem chegou com um buraco nela”.
  • Uma etapa recusada é exibida como falha, com o motivo. Uma etapa que o aplicativo rejeitou (um contato duplicado, um estágio que não existe, um modelo que não foi aprovado) é marcada como falha e mostra o que foi dito, em vez de um tique verde sem nada por trás.

Para automações que começam com um gatilho de Webhook, o histórico de execuções também avisa sobre chamadas que nunca se tornaram execuções: se algo estiver chamando seu webhook com um segredo ausente ou incorreto, um banner na parte superior conta essas solicitações rejeitadas e lembra você do que corrigir — o chamador precisa enviar o segredo da etapa de gatilho, seja como um cabeçalho X-Webhook-Secret ou como ?secret= no final da URL. Antes, essas chamadas eram simplesmente recusadas sem nada para mostrar, o que fazia um chamador mal configurado parecer que a automação nunca foi disparada.

Ativando uma Automação

Salve sua automação e, em seguida, use a chave Ativado para colocá-la em funcionamento — a partir desse momento, ela dispara de verdade toda vez que seu gatilho ocorrer. Mude de volta para Pausado a qualquer momento para interrompê-la sem perder seu trabalho. Uma automação precisa estar pausada antes que você possa excluí-la.

Automações que disparam a si mesmas

Alguns fluxos podem ativar seu próprio gatilho. O caso clássico: uma automação que inicia em Tarefa criada e possui uma etapa Criar tarefa. A nova tarefa dispara o gatilho novamente, o que cria outra tarefa, e assim por diante, uma execução a cada segundo ou mais, cada uma custando créditos. A mesma coisa pode acontecer com Contato criado mais Criar contato, ou Agendamento marcado mais Criar agendamento.

Três salvaguardas detectam isso:

  • O editor avisa você imediatamente. Assim que um fluxo assume esse formato, um banner vermelho aparece acima da tela, nomeando a etapa e a correção; a etapa recebe um marcador vermelho, e os botões Ativado, Executar e Reproduzir permanecem desativados até que o problema seja resolvido. Você pode continuar editando e salvando uma automação pausada; se a automação já estiver ativada, a alteração não será salva até que você a pause ou corrija a etapa. Fluxos que podem disparar a si mesmos (um gatilho de Contato atualizado com uma etapa que altera o contato, por exemplo) recebem um aviso âmbar, que não bloqueia nada: escolha um campo para o gatilho monitorar, de modo que ele inicie apenas nas alterações que lhe interessam.
  • O construtor de IA recusa o formato óbvio. Se você descrever um fluxo onde um gatilho de “algo foi criado” é seguido por uma etapa que cria esse mesmo tipo de coisa, o construtor não o produzirá e informará qual etapa deve ser alterada. Quando você quiser alterar exatamente o item que iniciou a execução (definir uma data de vencimento na tarefa que acabou de ser criada, marcar o contato que acabou de entrar), use a etapa de Atualizar correspondente no ID do gatilho: Atualizar tarefa com ${trigger.task.id}, Atualizar contato com ${trigger.contact.id}. A atualização não dispara novamente um gatilho de “criado”.
  • Uma automação em loop é desativada automaticamente. Uma automação que continua sendo executada mais de 30 vezes por minuto durante vários minutos seguidos é pausada automaticamente, e uma execução com falha aparece em seu histórico explicando o motivo. Uma automação com o formato de autoalimentação mencionado acima é interrompida muito mais cedo, após 10 execuções em um minuto. Picos normais de atividade são aceitáveis: importar 300 contatos em uma automação de Contato criado dispara 300 execuções em um minuto e depois fica inativa, o que não é um loop. Execuções de teste iniciadas por você na barra de ferramentas nunca são contabilizadas. Corrija o fluxo e ative-o novamente.

Quanto custam as automações

Cada execução de uma automação usa 0,25 créditos, independentemente do que a iniciou — um gatilho disparando de verdade, ou você pressionando Executar ou Reexecutar. Você pode criar automações com quantas etapas quiser sem custo adicional; a única etapa que aumenta o preço é a etapa de IA, que usa mais 0,25 créditos cada vez que é executada. Se o seu saldo acabar, uma execução falha com uma mensagem clara de “créditos insuficientes” no histórico de execuções, e novas execuções são processadas novamente assim que você recarregar.

A cobrança de execução sempre é feita na conta em que a automação está salva. Apontar uma etapa para uma de suas subcontas através do campo ID da subconta não altera a cobrança — a execução ainda é cobrada do seu workspace, enquanto qualquer coisa que a etapa inicie dentro da subconta (uma resposta de IA para um chat não pausado, por exemplo) é cobrada dessa subconta normalmente. Se você quiser que o saldo do próprio cliente pague pelas execuções, crie a automação dentro da conta dele.

Usando sua própria chave da Anthropic (BYOK)? As automações são cobradas em créditos de qualquer forma. A etapa de IA é executada em nossa IA de automação integrada, não na sua chave, portanto, ela sempre consome 0,25 créditos por execução, assim como os 0,25 créditos fixos por execução de automação. Sua chave continua cobrindo as respostas dos seus Agentes como antes; as duas coisas não interagem.

Automações vs. Pontos de Entrada

Eles parecem semelhantes, mas resolvem problemas diferentes:

  • Um Ponto de Entrada faz apenas uma coisa — corresponde a um evento e transfere a conversa para um Agente. Sem atrasos, sem condições, sem ramificações.
  • Uma Automação é a ferramenta de fluxo de trabalho completa — múltiplas etapas, condições, atrasos e ações envolvendo contatos, negócios, tarefas e integrações externas, não apenas a transferência de conversas.

Se tudo o que você precisa é “encaminhar esta conversa para aquele Agente”, use um Ponto de Entrada. Se você precisar de uma sequência de etapas ou lógica além disso, crie uma Automação.


Trabalhando com várias automações ao mesmo tempo

Cada linha na lista de automações tem uma caixa de seleção, e a caixa de seleção do cabeçalho seleciona tudo o que está sendo exibido no momento. Com as automações selecionadas, uma barra na parte inferior da tela oferece Ativar, Pausar e Excluir — cada uma pede que você confirme primeiro, e a exclusão também remove o histórico de execuções das automações. Pressione Esc para limpar uma seleção.


Próximos passos

  • Pontos de Entrada — a ferramenta de roteamento mais simples para encaminhar conversas para um Agente.
  • Agentes de IA — a persona para a qual uma Automação ou Ponto de Entrada pode rotear.
  • Transmissões — envie uma mensagem única ou contínua para uma lista de contatos.
  • Sistema de Agendamento — configure os compromissos sobre os quais uma automação pode lembrar, agendar, mover ou cancelar para as pessoas.
  • Modelos do WhatsApp — necessários para enviar mensagens a alguém fora da janela de 24 horas do WhatsApp.