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.

• Pergunte ao Champ. De qualquer página, diga ao assistente no aplicativo o que você deseja (“quando alguém fizer uma reserva, marque-os e envie um lembrete no dia anterior”, “ligue a IA novamente duas horas depois que eu assumir um chat”) e ele criará isso para você. Veja Pedindo ao Champ para criar ou corrigir uma abaixo.

Você pode combinar os três: comece a partir de um prompt ou do Champ, depois ajuste o resultado na tela (canvas), ou vice-versa.

Criando com a barra de prompt #

A barra de prompt permanece na parte inferior da tela, para que você possa continuar pedindo alterações enquanto cria.

• Você pode interrompê-lo. Enquanto ele está sendo criado, o botão de enviar torna-se um botão Parar. Clique nele e a criação termina ali, deixando a tela exatamente como estava antes de você solicitar.
• Ele lembra da conversa. Suas últimas instruções na mesma sessão permanecem na memória, então um acompanhamento curto como “remova esse passo” ou “mude o atraso para dois dias” é compreendido sem que você precise descrever toda a automação novamente.
• As alterações aguardam o seu OK. Quando você pede à IA para alterar uma automação que já possui passos, ela não substitui mais sua tela imediatamente. A versão proposta aparece na tela com novos passos destacados em verde e passos alterados em âmbar, e uma barra na parte inferior lista o que foi adicionado, alterado e removido, quantas conexões mudaram e o novo nome, caso tenha escolhido um. Clique em Aceitar para manter ou Rejeitar para colocar tudo de volta exatamente como estava (Cmd+Z ou Ctrl+Z também rejeitam). Até que você escolha, a automação não pode ser salva ou ativada. A criação a partir de uma tela vazia ainda é aplicada imediatamente, já que não há nada a perder.
• O que a IA diz permanece até que você feche. Quando a IA explica algo sobre o que criou (um passo que ela deixou de fora, uma pergunta que precisa de resposta), essa nota permanece na tela até que você a dispense. Ela também aparece na barra de revisão ao lado das alterações e, depois disso, um botão Mostrar nota da IA acima da barra de prompt a abre novamente até sua próxima solicitação.
• Um Desfazer reverte toda a alteração. Tudo o que a IA adicionou ou reorganizou conta como uma única alteração, portanto, depois de aceitar, clicar em Desfazer na barra de ferramentas uma vez coloca a tela de volta como estava.
• Ela adiciona apenas o que você pediu. Ela não incluirá passos que alterem os créditos de uma conta, bloqueiem uma conta, excluam itens ou enviem mensagens para pessoas, a menos que você tenha solicitado, então um prompt sobre marcar contatos retornará apenas como marcar contatos e nada mais.
• Ela escreve no seu idioma. Os rótulos dos passos que ela coloca na tela, bem como o nome, a descrição e as notas da automação, retornam no idioma em que seu aplicativo está definido, aquele que você escolheu em Configurações → Perfil → Idioma. Defina o aplicativo para francês e o que a IA escrever será em francês, sem que você precise pedir. As automações que você já possui permanecem exatamente como estão, portanto, alterar seu idioma não as reescreve: peça à barra de prompt para renomear os passos ou renomeie-os você mesmo.
• Ela nomeia e descreve o que cria. Uma nova automação retorna com um nome e uma breve descrição já preenchidos, para que a lista de Automações informe o que cada uma faz sem que você precise abri-la. Quando você pede uma alteração mais tarde, ela deixa o nome e a descrição que você tem como estão, a menos que você peça para renomear ou descrever a automação novamente, ou se a alteração os tornou incorretos. Qualquer coisa que você mesmo digitou só é substituída quando você pede.

Salvando suas alterações #

Nada na tela é salvo automaticamente. Cada alteração que você faz — adicionar uma etapa, editar um campo, mover um nó, alterar as configurações da automação — permanece como um rascunho no seu navegador até que você clique em Salvar no canto superior direito (ou pressione Cmd+S / Ctrl+S). Enquanto houver algo não salvo, o status ao lado do botão será Rascunho não salvo; Descartar descarta o rascunho e retorna a automação ao seu último estado salvo.

Uma automação ativa continua sendo executada na sua última versão salva enquanto você trabalha, para que você possa reconstruir metade dela sem que nada inacabado seja disparado de verdade. Ligar a chave Ativado salva a automação primeiro, porque o que você ativa é o que está na tela. Se você fechar a aba ou for para outra página com alterações não salvas, será perguntado se deseja salvar, sair sem salvar ou permanecer.

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

Contatos

Negócios

Compromissos

Tarefas

Conta

Apps

Geral

Os gatilhos reagem a toda a sua conta, não apenas ao construtor. Mensagem recebida, Contato atualizado e Negócio atualizado são disparados de onde quer que a alteração venha: seu agente de IA atualizando um contato no meio de uma conversa, uma transmissão, 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.

Eventos de aplicativo #

O gatilho Evento de aplicativo inicia uma automação a partir de algo que acontece em outro aplicativo que você usa. Existem 41 aplicativos para escolher hoje, entre eles HubSpot, Pipedrive, Salesforce, Close, Stripe, Shopify, Calendly, Typeform, Google Sheets, Google Drive, Google Calendar, Gmail, Outlook, Slack, Discord, Trello, ClickUp, Asana, Monday, Jira, Linear, Notion, Airtable, Zendesk, Zoom, Mailchimp, MailerLite, Kit, DocuSign e GitHub. O seletor lista apenas aplicativos que podem relatar eventos.

Configuração

1. Abra o gatilho e escolha Evento de aplicativo em Apps. (Já tem outro gatilho? Clique em Alterar gatilho primeiro.)
2. Em Aplicativo, escolha o app. Em Evento, escolha o que precisa acontecer nele para que a automação seja executada uma vez.
3. Se o aplicativo ainda não estiver conectado, conecte-o ali mesmo, da mesma forma que você conecta um aplicativo para uma etapa de ação. Em Conta, a automação mostra em qual conta conectada ela está ouvindo.
4. Preencha as Configurações do evento, se o evento tiver alguma. Esses são os detalhes que o aplicativo precisa para saber quais eventos enviar, e os obrigatórios estão marcados. Alguns eventos solicitam detalhes das configurações de desenvolvedor do próprio aplicativo. Quando for esse o caso, Como configurar isso no aplicativo abaixo do evento explica onde encontrá-los.
5. Salve a automação e ative-a.

Está ouvindo? Abaixo das configurações, o gatilho informa onde ele se encontra. Ouvindo significa que os eventos do aplicativo iniciam a automação. Pausado com a automação significa que a automação está desligada: ative-a novamente e ela voltará a ouvir. Não ouvindo aparece com o motivo fornecido pelo aplicativo, por exemplo, que a conta conectada foi removida. Pausar a automação interrompe os eventos. Excluí-la ou alterar o gatilho para outro aplicativo ou evento remove o ouvinte antigo. Desconectar a conta de um aplicativo interrompe todas as automações que ouvem nessa conta, e seus gatilhos mostram o motivo.

Alguns aplicativos relatam eventos com alguns minutos de atraso. Nem todo aplicativo envia um evento no momento em que ele acontece. Para esses, o evento é verificado a cada poucos minutos (o intervalo nas Configurações do evento, em minutos), portanto, uma execução pode começar um pouco depois do evento em si. O gatilho mostra uma nota quando o evento que você escolheu funciona dessa maneira.

Usando o que o aplicativo enviou. Cada campo que o aplicativo envia sobre o evento fica disponível para as etapas posteriores como ${trigger.field_name}. Além desses, ${trigger.app_event.toolkit} é o aplicativo, ${trigger.app_event.event} o evento, ${trigger.app_event.id} o ID desta entrega e ${trigger.app_event.received_at} quando ela chegou. A entrega completa, sem alterações, fica em ${trigger.raw}. O exemplo no seletor + começa com o que o evento geralmente contém. Assim que um evento real for recebido, clique em Usar o último evento real como exemplo e o seletor mostrará exatamente os campos que seu aplicativo envia.

Quanto custa. Cada execução custa o mesmo que uma execução iniciada por qualquer outro gatilho (veja Quanto custam as automações). O histórico de execução rotula essas execuções como Evento de aplicativo.

Exemplo: uma etapa de negócio muda no HubSpot. Digamos que você queira que uma mensagem do WhatsApp seja enviada quando um negócio no HubSpot mudar para uma nova etapa.

1. Escolha Evento de aplicativo, depois HubSpot como o aplicativo e Etapa de negócio atualizada como o evento, e conecte sua conta do HubSpot.
2. Os dois eventos do HubSpot (Contato criado e Etapa de negócio atualizada) precisam de um ID de aplicativo do HubSpot e uma chave de API de desenvolvedor em Configurações do evento. Ambos vêm da sua conta de desenvolvedor do HubSpot em developers.hubspot.com.
3. Adicione uma etapa de Condição na nova etapa, para que apenas a etapa que lhe interessa (Fechado ganho, por exemplo) prossiga, e depois dela uma etapa de Enviar mensagem para o contato.
4. Salve, ative a automação e mova um negócio de teste no HubSpot. Em seguida, clique em Usar o último evento real como exemplo, para que os campos de etapa e contato de um evento real do HubSpot apareçam no seletor +.

Configurações da automação #

Algumas escolhas pertencem à automação como um todo, em vez de a um único passo. Elas ficam atrás do ícone de engrenagem no canto superior direito do editor, em Configurações da automação, e fazem parte do rascunho como tudo o mais — clique em Salvar para que entrem em vigor. Existem cinco:

• Descrição: uma nota sobre o que esta automação faz, exibida abaixo do nome na lista.
• Permitir reentrada — se um contato pode passar por esta automação mais de uma vez.
• Parar na resposta — encerrar a execução de um contato no momento em que ele lhe enviar uma mensagem.
• Respeitar o horário de silêncio — reter mensagens que seriam enviadas à noite no horário local do contato.
• Executar apenas durante estes horários — ignorar o gatilho fora de uma janela que você definir.

Dizendo o que uma automação faz #

Um nome como “Retorno de chamada perdida” diz o suficiente; “Acompanhamento 3” um mês depois, não. A caixa Descrição na parte superior das Configurações da automação é um campo de texto livre exatamente para isso: escreva uma ou duas linhas sobre o que a automação faz, para quem ela é ou por que você a criou.

O que você escreve aparece abaixo do nome da automação na lista de Automações, para que você possa ler a página e ver para que serve cada uma sem precisar abri-la. A caixa de pesquisa nessa página procura tanto nas descrições quanto nos nomes, então “restaurante” ou “lembrete” em uma descrição é o suficiente para encontrar a automação novamente. É opcional, não altera nada sobre como a automação é executada, e deixá-la vazia mantém a lista exatamente como estava.

Permitindo que um contato passe por ela mais de uma vez #

Permitir reentrada decide o que acontece quando o gatilho dispara novamente para alguém que já passou pela automação.

• Desativado: cada contato passa pela automação uma vez. Na próxima vez que o gatilho disparar para ele — ele enviar outra mensagem, marcar outro agendamento, receber a mesma tag novamente — nada começa. O histórico de execução permanece silencioso para ele, da mesma forma que ocorre para uma mensagem que não corresponde ao filtro do gatilho. Qualquer pessoa que já teve uma execução desta automação conta como tendo passado por ela, independentemente de a execução ter terminado, falhado ou sido interrompida.
• Ativado: um contato pode entrar novamente toda vez que o gatilho disparar. Esta é a configuração para qualquer coisa recorrente — lembretes de agendamento, confirmações de reserva, uma palavra-chave que deve receber a mesma resposta todas as vezes.

O padrão depende do gatilho. Para Contato adicionado (pessoas que você adiciona a partir da página de Contatos), ele está desativado, para que adicionar a mesma lista duas vezes nunca envie mensagens duplicadas para ninguém. Para todos os outros gatilhos, ele está ativado, que é como as automações sempre se comportaram — nada que você construiu antes de essa configuração existir muda por conta própria.

Duas coisas para ter em mente. A reentrada é sobre o contato, portanto, gatilhos que não carregam um — Agendado, Webhook recebido, RSS, E-mail recebido — não são afetados de qualquer maneira. E os três gatilhos de agendamento (Agendamento marcado, Agendamento cancelado, Antes de um agendamento) sempre permitem a reentrada, independentemente do que a chave diz: eles disparam uma vez por agendamento, e um gatilho de lembrete dispara uma vez por horário de lembrete, então um “uma vez” por contato pularia o próximo agendamento de um cliente recorrente e até o segundo lembrete para o mesmo. A chave fica desativada para esses casos.

Parando quando um contato responde #

Parar na resposta é para sequências de acompanhamento: uma execução que está aguardando em um Atraso, ou processando suas etapas, termina no momento em que o contato lhe envia uma mensagem em qualquer canal. A execução dele aparece como Cancelada no histórico de execuções; a execução de ninguém mais é afetada, e a automação permanece ativa para todos. Quando a opção Parar na resposta encerra uma execução, a página de detalhes informa que o contato respondeu, enquanto uma execução que você mesmo cancela indica que foi cancelada manualmente.

Ele é desativado por padrão. Quando está ativado e o próprio gatilho da automação é Mensagem recebida, a resposta que interrompe uma execução pode iniciar uma nova se o gatilho corresponder a ela e o reingresso for permitido — da mesma forma que uma sequência de acompanhamento reiniciaria na maioria dos CRMs. Desative o reingresso também se quiser que cada contato receba a sequência apenas uma vez.

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 opção por automação exatamente para isso. Onde encontrar: clique no ícone de engrenagem no canto superior direito do editor para abrir as Configurações da automação — ela está lá, independentemente do tipo de gatilho que a automação tenha.

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 acompanhamentos e envios agendados por IA. Essa configuração não alcança suas automações, e é por isso que cada automação possui seu próprio interruptor. Veja Horário de Silêncio e Conformidade para o lado do nível 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: abra as Configurações da automação (o ícone de engrenagem no canto superior direito do editor) — ela fica logo abaixo de Respeitar horário de silêncio, independentemente do tipo de gatilho que a automação tenha. Ative-a 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 deve se aplicar apenas a um deles — o agente de suporte, por exemplo, e não o de vendas — precisa de uma maneira de especificar isso. Quatro gatilhos possuem um campo exatamente para isso:

Abra o gatilho, clique no campo e você receberá 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 os contatos pelos quais aquele agente é responsável; todas as outras conversas na sua conta serão ignoradas. Deixe em Qualquer agente, que é como ela começa, e a automação será executada para todos os contatos da conta, incluindo contatos aos quais nenhum agente foi atribuído.

Ela lê o agente ao qual o contato está atribuído naquele momento, portanto, mover um contato para outro agente hoje altera quais dessas automações serão executadas para ele a partir de então.

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.

Todos os outros gatilhos são executados para toda a conta. Não existe um campo de agente nos gatilhos de contato, negócio, agendamento, tarefa, conta ou gerais: eles são disparados para tudo na conta. Para restringir um deles a um único agente, adicione uma etapa de Condição como a primeira etapa após o gatilho e verifique o agente atribuído ao contato, então coloque o restante das etapas no caminho verdadeiro. Veja Etapas.

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 diga o que 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 coletar. Cada parâmetro é uma informação que a IA deve reunir da conversa antes de chamar — 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, um número, um sim/não ou JSON — escolha JSON quando a IA precisar entregar um pacote estruturado de campos (digamos, um endereço de entrega completo) em vez de um único valor.
4. Escolha quais agentes podem usá-la. Escolha os agentes de IA que devem ter essa habilidade — seja aqui no gatilho ou mais tarde na aba Habilidades de IA de qualquer agente, onde a função aparece ao lado das outras habilidades do agente com um botão liga/desliga normal. Ambos os lugares editam a mesma coisa, então use o que você já estiver acessando.
5. Ative a automação. A partir desse momento, esses agentes têm a função — nada para copiar em lugar nenhum, 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 Return response (Retornar resposta) e o que quer que ela envie de volta se tornará a resposta que a IA lê — assim, ela pode citar dados reais no mesmo turno da conversa: consultar estoque em seu próprio banco de dados, verificar um calendário, calcular um orçamento. Sem uma etapa Return response, o agente aguarda a automação terminar (até 25 segundos) e é informado se funcionou: concluído com sucesso ou falhou. Isso é adequado para trabalhos do tipo “registre esta reclamação no meu sistema” que não precisam de dados de retorno. Se a automação ainda estiver em execução após 25 segundos, ou estiver aguardando em uma etapa de Delay (Atraso) longa, o agente é informado de que está sendo executado em segundo plano e continua. Uma coisa a ter em mente: o agente aguarda até 25 segundos por uma resposta, portanto, mantenha as etapas de Delay fora do caminho entre o gatilho e a etapa Return response. Se a execução falhar antes de chegar à etapa Return response (uma etapa apresenta erro ou seu saldo não cobre a execução), o agente é informado de que a chamada falhou, alerta um humano e informa ao cliente que houve um problema técnico. Ele nunca promete uma resposta que não virá. O mesmo acontece quando a própria etapa Return response envia um status de erro (400 ou superior), portanto, envie um 200 com uma mensagem clara no corpo quando “não encontrado” for uma resposta que você deseja que o agente transmita.

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.

Adicionar 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, sendo 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 as Configurações da automação (o ícone de engrenagem no canto superior direito) e ative Permitir reingresso. Veja Permitir que um contato passe por ela mais de uma vez.

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 DM Champ: envie uma mensagem para um contato, edite seus detalhes, adicione etiquetas, mova-os entre listas, transfira-os para outro agente de IA, crie e atualize tarefas e negócios, agende, mova ou cancele compromissos, procure coisas 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 pelo 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 aba que abrir 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.

  Cada outra ação mostra um campo por configuração que o aplicativo solicita, rotulado em palavras simples, com o i ao lado de um rótulo explicando-o. Uma configuração que contém vários valores é um pequeno formulário, não uma caixa de código: uma lista (os registros aos quais uma nova nota do HubSpot está vinculada, por exemplo) é um conjunto de linhas que você adiciona com Adicionar e remove com o x, escolhas fixas são menus suspensos, e um conjunto de valores nomeados são linhas de nome e valor. Cada caixa recebe valores de etapas anteriores com o botão +. Se você preferir digitar os valores brutos, Editar como JSON ao lado do campo mostra a mesma coisa como texto, e o que você altera lá aparece no formulário.

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

  Para alterar a conta que um aplicativo usa, abra qualquer etapa desse aplicativo. Uma vez conectado, a parte superior do painel de configurações mostra a conta conectada (por nome ou e-mail, quando o aplicativo compartilha um) com Disconnect (Desconectar) e Use another account (Usar outra conta). Use another account desconecta a conta atual; em seguida, clique em Connect (Conectar) e faça login com a outra conta. A conexão pertence a todo o seu espaço de trabalho, portanto, toda automação que usa esse aplicativo muda para a nova conta, e as etapas que a utilizam param de ser executadas enquanto nada estiver conectado.

• Email (your mail server) (E-mail (seu servidor de e-mail)) — envie um e-mail a partir do seu próprio servidor de e-mail, em vez de usar o Gmail. Selecione-o como o tipo de etapa e preencha os detalhes de envio do seu provedor uma única vez: endereço do servidor, porta, nome de usuário, senha e o endereço do qual você deseja que o e-mail seja enviado. Você encontrará essas informações nas configurações do seu provedor de e-mail, geralmente em “SMTP” ou “Envio”. Verificamos os detalhes com o seu servidor de e-mail antes de salvar, portanto, se algo estiver errado, você saberá imediatamente, em vez de descobrir apenas 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 da Mollie (Mollie Dashboard → Developers → API keys).
  • WooCommerce — procure 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 → Settings → Advanced → REST API → Add key).
  • WordPress: crie, atualize ou busque um post, crie um usuário ou encontre um usuário por e-mail. Conecte-o com o endereço do seu site, seu nome de usuário do WordPress e uma senha de aplicativo (Users → Profile → Application Passwords). Veja WordPress.
  • FluentCRM: crie ou atualize um contato, encontre um por e-mail, adicione ou remova tags e adicione alguém a listas. Os mesmos detalhes de conexão do WordPress, pois o FluentCRM é executado no seu site WordPress. Tags e listas são fornecidas como IDs, não nomes. Veja FluentCRM.
  • MemberPress: obtenha um membro, encontre um por e-mail, crie um membro, liste suas assinaturas ou transações e crie uma transação, que é como uma assinatura é concedida. Conecte-o com o endereço do seu site mais a chave de API em MemberPress → Developer Tools. Veja MemberPress.

  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.

  Verificando mais de uma coisa. Uma Condição pode conter várias regras ao mesmo tempo. Defina Correspondência como Todas as seguintes (cada regra precisa ser verdadeira) ou Qualquer uma das seguintes (uma regra verdadeira é suficiente) e use Adicionar condição para cada regra extra — por exemplo, país é igual a NL e mensagem contém preços. Se você precisar misturar as duas ou agrupar regras com parênteses, digite a regra como uma expressão: (${trigger.contact.country} == 'NL' or ${trigger.contact.country} == 'BE') and ${trigger.message.body} contains 'pricing' — and tem precedência sobre or, e os parênteses substituem isso. Uma condição escrita dessa forma abre como uma caixa de expressão em vez de linhas.

  

  Os estágios são comparados pelo seu ID, não pelo seu nome. O estágio de uma tarefa ou negócio chega como seu ID interno (todo, in_progress, done…), que pode ser diferente do título da coluna no seu quadro. Portanto, quando o campo é o estágio da tarefa ou do negócio e a comparação é igual a ou diferente de, a caixa de valor se torna uma lista dos seus próprios estágios: escolha a coluna pelo nome e a etapa armazena seu ID. Uma condição salva anteriormente com um nome de estágio digitado é sinalizada com um aviso abaixo da lista e, quando o texto corresponde a uma das suas colunas, um botão o substitui pelo ID dessa coluna.

  Outros valores que apontam para sua conta também são listas. Com as tags do contato (contém, é igual a), a tag que um gatilho de Tag aplicada carrega, o responsável por um negócio ou tarefa, o agente de IA ou um campo personalizado do tipo Menu suspenso, a caixa de valor é uma lista de suas próprias tags, membros da equipe, agentes ou as opções do campo. Clique em Usar um valor de uma etapa anterior para comparar com um valor do gatilho ou de outra etapa.

  Cada próxima etapa precisa de uma ramificação. Uma etapa conectada a uma Condição deve estar pendente de sua alça Sim ou Não. Uma etapa conectada sem uma ramificação é executada de qualquer forma que a condição responder — o editor a sinaliza e não permitirá que você ative a automação até que ela seja movida para uma alça.

  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. Terminar antes de começar cria uma janela noturna (21:00 às 08:00), e as alternâncias de Dias limitam a certos dias da semana — deixe-as todas desativadas para todos os dias. Ele 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 ele é realmente alcançado, 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, em vez disso, a automação simplesmente não deve ser executada fora de uma janela, use Executar apenas durante estes horários nas Configurações da automação.

  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 dizendo 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 depois 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 passar menos. E enquanto Pause all AI messages (Pausar todas as mensagens de IA) estiver ativado em Settings → Profile (Configurações → Perfil), uma etapa de IA não será executada: a execução para com uma nota informando que a IA está pausada para a conta e nada é cobrado. Desative a pausa e as novas execuções ocorrerão novamente.

• Delay (Atraso) — pausa antes de continuar. Wait type (Tipo de espera) oferece duas maneiras de fazer isso. For a fixed amount of time (Por um período fixo) é a clássica: aguarde 10 minutos, 2 horas, 3 dias, com um pouco de jitter aleatório opcional para que execuções consecutivas não sejam disparadas no mesmo segundo. Until a specific moment (Até um momento específico) aguarda por uma data e hora em vez disso — geralmente uma que você insere de uma etapa anterior com o botão +, como a hora de início do compromisso — e um Offset (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 espera 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 waiting (aguardando) até chegar a hora, então minutos, horas e dias são aceitáveis.

• Loop — repete um grupo de etapas uma vez para cada item em uma lista (por exemplo, uma vez por contato que Find contacts (Encontrar contatos) retornou, ou uma vez por tag em um contato). Deixe Max iterations (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 Delay dentro do loop funciona da mesma maneira — o loop aguarda e continua com a próxima etapa para aquele item. Conecte as etapas a serem repetidas ao manipulador body (corpo) do loop e pare por aí: uma ramificação que simplesmente termina é como o loop sabe que aquele item foi concluído, e ele passa para o próximo por conta própria. Uma Condition (Condição) dentro do loop decide por item: apenas a ramificação true (ou false) daquele item é executada, portanto, Loop → Condition → Send message (Enviar mensagem) envia apenas para os itens que passam. Você não precisa de uma linha de volta para o Loop, e a tela não permite mais desenhá-la: puxe uma conexão de uma etapa posterior de volta para o Loop (ou para qualquer etapa acima dele) e a linha será recusada com uma nota explicando o motivo. Se uma automação que você criou anteriormente ainda tiver uma, cada execução dela para antes da primeira etapa, e a execução informa qual conexão remover.

• Return response (Retornar resposta) — para automações que começam com um gatilho Webhook ou AI Agent Function (Função de Agente de IA): envie dados de volta para o que quer que tenha chamado a automação — a ferramenta externa que atingiu seu webhook ou seu próprio agente de IA no meio da conversa. Por padrão, uma chamada apenas recebe um reconhecimento; 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 o chamou receba, por exemplo, a linha que você consultou 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 Delay antes, por exemplo), ela retorna ao reconhecimento normal e a automação continua independentemente. Se a execução falhar antes de chegar a esta etapa, o chamador recebe uma resposta imediatamente em vez de esperar: status 200 com "status": "failed" no corpo (e insufficient_credits como o código de erro quando seu saldo não pôde cobrir a execução). Deliberadamente, não é um status de erro: a solicitação foi recebida e as etapas anteriores podem já ter sido executadas, e ferramentas como Stripe ou Shopify reenviam um webhook que recebe um erro de volta, o que executaria essas etapas novamente. Os detalhes permanecem no histórico de execução. Test step (Testar etapa) mostra uma visualização 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.

Usando o que uma etapa anterior retornou #

Quando um campo solicita um valor, como ID do contato, insira apenas esse valor com o botão +, e não a etapa inteira. Após uma etapa de Localizar contato chamada find_contact, esse valor é ${nodes.find_contact.contactId}. Inserir ${nodes.find_contact} sozinho passa tudo o que a etapa retornou de uma vez, e uma etapa que precisa de um contato falhará com a mensagem “contato não encontrado”.

Expressões #

Dentro de ${ } você pode escrever um pequeno trecho de JavaScript para alterar um valor antes que ele seja usado. Escreva em qualquer campo que aceite variáveis, usando os mesmos nomes que o botão + insere:

O texto ao redor permanece como está, então Hi ${ trigger.contact.first_name.toUpperCase() }! envia “Oi ADA!”. A caixa Resultado abaixo do campo mostra o que o código calcula com seus dados de exemplo enquanto você digita.

Se o código falhar (um erro de digitação ou um campo vazio para este contato), essa parte sai vazia e o restante da etapa continua. O histórico de execução informa qual parte do código falhou e por quê.

O código é executado instantaneamente e por conta própria: ele não tem acesso à internet, não pode esperar por nada e pode levar no máximo meio segundo. Para buscar algo, use uma etapa de Requisição HTTP e insira seu resultado. Quando a lógica precisar de mais de uma linha, ou várias etapas compartilharem o mesmo resultado, uma etapa de Transformação ainda é a melhor ferramenta.

Testando etapas que buscam um contato #

Executar e Testar etapa usam os dados de exemplo do gatilho, e esse exemplo é um contato fictício (contact_abc123, [email protected], sem número de telefone). Ele não existe na sua conta, portanto, uma etapa que busca ou envia uma mensagem para um contato falhará em um teste com “contato não encontrado” ou “nenhum número armazenado”. Isso é esperado: quando um gatilho real é acionado, a etapa recebe o contato real e funciona. Para testar com dados reais, deixe a automação ser executada uma vez de verdade e, em seguida, clique em Replay na barra de ferramentas para executá-la novamente com o que aquela última execução realmente recebeu.

Ações #

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

Campos que apontam para algo que já existe em sua conta são menus suspensos: um funil e seus estágios, uma lista de contatos, uma tag, um membro da equipe, um estágio de tarefa, um tipo de evento, um rascunho de transmissão ou um modelo de WhatsApp. Escolha na lista. Quando o valor deve vir de uma etapa anterior (um nome de estágio enviado por um webhook, por exemplo), clique em Usar um valor de uma etapa anterior abaixo do campo e insira-o com o botão +.

Contatos

Mensagens

Tarefas

Negócios

Compromissos

Outros

Ações da API da conta #

Abaixo das ações acima, o seletor de etapas possui uma seção chamada API da conta, recolhida até que você a abra. Ela contém uma ação para cada endpoint da API DM Champ, cerca de 390 delas, agrupadas pela parte da conta à qual pertencem: Contatos, Negócios, Funis, Tags, Tarefas, Agendamentos, Transmissões, Base de conhecimento, FAQs, Resumos, Mensagens, Subcontas e o restante. Tudo o que a API pode fazer, uma automação agora pode fazer como uma etapa normal, sem etapa de solicitação HTTP, sem chave de API e sem código.

Algumas coisas para saber sobre elas:

• As configurações de cada ação mostram um campo por parâmetro que o endpoint aceita. Um campo que espera um objeto ou uma lista de itens é uma caixa onde você digita JSON. Cada campo aceita valores de etapas anteriores no formato usual ${…}, inseridos com o botão +.
• A etapa na tela mostra o método e o endereço que ela chama, por exemplo PUT /v1/pipelines/:pipelineId, para que você possa consultar o endpoint na referência da API quando quiser detalhes sobre o que ele retorna. Uma parte do endereço que começa com dois-pontos é um valor que você preenche na etapa, de modo que ela realmente chama /v1/pipelines/default assim que Pipeline ID for definido como default.
• Ações que excluem algo exibem um aviso vermelho em suas configurações. Elas fazem exatamente o que a chamada da API faz, imediatamente, e não há como desfazer depois.
• As ações no topo do seletor, aquelas listadas nas tabelas acima, permanecem inalteradas. Elas continuam sendo a maneira mais rápida de realizar as tarefas comuns, e a maioria das automações nunca precisa abrir esta seção.

Exemplo: configurar o funil e as tags de uma nova conta de cliente. Esta é a versão sem código do que costumava precisar de um script.

1. Gatilho: Subconta criada.
2. API da conta → Tags → Criar ou atribuir uma tag (POST /v1/tags), com o nome da tag e a Subconta definida como ${trigger.sub_account.id}.
3. API da conta → Funis → Atualizar um funil (PUT /v1/pipelines/default), com seus estágios no campo JSON. O trigger_tag de um estágio é escrito como users/<the sub-account id>/tags/<the tag id the previous step returned>, ambos inseridos com o botão +.

Cada conta de cliente que você criar a partir de então recebe o mesmo quadro e as mesmas regras de tag, sem que você precise abri-la.

Exemplo: enviar um e-mail para si mesmo com um resumo quando alguém agendar.

1. Gatilho: Agendamento marcado.
2. API da conta → Resumos → Resumir uma conversa (POST /v1/summaries), apontado para o contato do gatilho.
3. E-mail, com o resumo da etapa 2 no corpo.

Como as variáveis são escritas. Qualquer coisa 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 dos modelos de transmissão não é compreendido aqui: ele é enviado exatamente como digitado, portanto, a mensagem chega com {{first_name}} nela em vez do nome. Se uma mensagem chegou com o texto do marcador ainda nela, quase sempre é por isso — exclua o marcador e insira-o novamente com o botão +. Campos personalizados ficam sob contato como tudo o mais sobre a pessoa (${trigger.contact.your_field_key}). Um nome de campo com espaços, um ponto de interrogação ou outros símbolos (um formulário de lead do Facebook envia cada pergunta como seu próprio campo) vai entre colchetes e aspas, como ${trigger["what_service_are_you_interested_in?"]}; o botão + insere dessa forma para você. ${…} também pode conter um pequeno trecho de código que altera o valor, como ${ trigger.contact.phone.replace("+", "") }: veja Expressões. Abaixo de cada campo que contém uma variável, uma caixa Resultado mostra o texto como ele apareceria com seus dados de exemplo: uma variável verde resolvida (seu valor é mostrado), uma âmbar não pode ser verificada ainda porque sua etapa não foi testada ou o gatilho não tem evento capturado, e uma vermelha aponta para um campo que não está no exemplo, o que geralmente é um erro de digitação ou o caminho errado. Para um trecho de código dentro de ${ }, a caixa mostra o resultado com o exemplo, ou em vermelho o motivo da falha. Variáveis também funcionam dentro de um campo que contém uma lista ou um grupo de valores (como uma lista de registros para vincular ou um conjunto de propriedades): cada ${…} nele é preenchido, e um que seja o valor total mantém seu tipo, portanto, um número continua sendo um número e uma lista continua sendo uma lista.

Dados de exemplo sem uma execução de teste. Uma etapa que você prefere não executar durante a criação (aquela que cria um contato ou envia uma mensagem) pode obter seu exemplo manualmente: abra a etapa, clique em Fixar exemplo em Exemplo de saída, cole ou digite o que a etapa retorna e clique em Fixar exemplo novamente. O seletor de variáveis, a caixa de Resultado e os testes das etapas posteriores usarão esse exemplo, e ele ficará marcado como Fixado até que um Testar etapa real o substitua. Execuções ao vivo nunca usam um exemplo fixado, apenas o que a etapa realmente retorna. Em um gatilho de Webhook, Salvar como exemplo mantém o payload que você digitou como o exemplo do gatilho sem executar nada, enquanto Enviar evento de teste também inicia uma execução de teste. A caixa Payload de exemplo (para teste) deve conter um JSON válido, com o mesmo formato que a ferramenta externa enviará: chaves e valores de texto entre aspas duplas retas, e uma aspa dupla dentro de um valor de texto escrita como \" (por exemplo, { "note": "she said \"hi\"" }). Enquanto o texto não for um JSON válido, a caixa exibirá JSON inválido e nenhum dos botões salvará ou enviará nada.

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 nas Configurações da automação (o ícone de engrenagem no canto superior direito) — 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. Ele cobre todos os agendamentos que o DM Champ conhece: reservas no calendário integrado e nas tabelas que sua IA reserva através do Zenchef, Formitable, OpenTable ou Trafft. Uma reserva feita diretamente no sistema do próprio restaurante (seu widget, telefone, cliente sem reserva) nunca chega ao DM Champ, portanto, não recebe lembrete. Isso se aplica a agendamentos já existentes no seu calendário, não apenas aos agendados após você ativá-lo — e ele acompanha as alterações: mova um agendamento e seus lembretes se moverão 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 feito 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: transforme uma chamada perdida do WhatsApp em um chat #

Um restaurante no meio do serviço, uma oficina com alguém embaixo de um carro, uma clínica entre pacientes: o telefone toca, ninguém pode atender e quem liga tenta o próximo lugar da lista. Esta automação envia uma mensagem para cada pessoa que ligou e não foi atendida no WhatsApp em segundos e permite que seu agente de IA assuma a partir daí.

Quer apenas o texto de retorno? Você não precisa criar isso manualmente: em Configurações → Canais, cada número do WhatsApp Web tem uma chave Responder chamadas perdidas com texto que cria essa automação exata para você, com sua mensagem, e o cartão SMS via Twilio tem a mesma chave para um número Twilio que você mesmo conectou. Veja WhatsApp Web → Responder chamadas perdidas com texto e SMS → Responder chamadas perdidas com texto. Crie você mesmo, como abaixo, quando quiser condições, um agente diferente para quem perdeu a chamada ou etapas de acompanhamento.

Funciona para chamadas para um número conectado via WhatsApp Web e para chamadas para o número Twilio que você conectou para SMS. Uma chamada perdida é qualquer chamada que você não atendeu: o chamador desligou após alguns toques ou a chamada caiu. Chamadas que você atende e chamadas que você recusa não contam, e chamadas em grupo são ignoradas.

1. Crie a automação. AI Studio → Automações → Nova automação, clique em Alterar gatilho, abra Mensagens e escolha Chamada perdida. Deixe Número em Qualquer número e ele disparará para cada chamada perdida em todos os números da conta, tanto no WhatsApp Web quanto no SMS; o campo lista seus números do WhatsApp Web e seu número de SMS, então escolha um lá para executar esta automação apenas para chamadas para esse número (uma segunda automação pode cobrir outro número com seu próprio texto).

2. Envie a mensagem. Adicione uma ação Enviar mensagem. Para ID do contato, clique em + e insira quem ligou a partir do gatilho. Em seguida, escreva o texto, por exemplo:

Desculpe por não termos atendido sua ligação, estamos no meio do serviço agora. Você gostaria de reservar uma mesa? Posso ajudar você por aqui.

Quem ligou torna-se um contato no momento em que a chamada é perdida (com o nome do perfil do WhatsApp, se eles mostrarem um), então a mensagem chega no chat deles como qualquer outra, e quem já tem um chat com você a recebe nesse chat. A resposta sai do número para o qual ligaram. O WhatsApp Web não tem janela de 24 horas, então uma mensagem simples é permitida, mesmo que eles nunca tenham escrito para você.

Se você preferir enviar de uma linha específica, tanto Enviar mensagem quanto Enviar mensagem do WhatsApp Web têm um campo Enviar de listando seus números do WhatsApp Web. Em Automático, a mensagem sai do número com o qual a pessoa falou por último, que para uma chamada perdida é o número para o qual ela ligou.

Se o chamador ligou para o seu número de SMS, a mesma etapa Enviar mensagem com o ID de contato do chamador responde a ele — o texto é enviado como um SMS do seu único número de SMS conectado, portanto, não há nada para escolher em Enviar de. O chamador é salvo como um contato de SMS quando a chamada termina, seu chat mostra uma linha Chamada de voz perdida e sua resposta é tratada pelo Agente de IA do número de SMS. O texto é enviado através da sua própria conta Twilio, portanto, suas taxas de SMS do Twilio se aplicam. Se uma automação cobrir ambos os tipos de número, ${trigger.channel} informa com qual você está lidando — whatsapp_web ou sms — para que uma Condição nele possa dar a um chamador do WhatsApp um texto diferente de um chamador de SMS.

3. Deixe seu agente assumir o controle. Quando quem liga atende, a conversa é tratada como qualquer novo chat nesse número: o agente definido como padrão desse número em Quem responde a novas conversas responde. Apenas se um agente diferente precisar lidar com chamadas perdidas, adicione uma ação Atribuir agente de IA antes da mensagem.

Valores úteis para uma Condição ou no texto da mensagem: ${trigger.contact.first_name}, ${trigger.contact.phone_number}, ${trigger.channel} (whatsapp_web ou sms), ${trigger.call.to_number} (o número para o qual ligaram; para uma automação por número, use o campo Número do gatilho em vez de uma condição), ${trigger.call.is_video}, ${trigger.call.missed_at} e ${trigger.is_new_contact}, que é true para alguém que nunca conversou com você, para que você possa cumprimentar um estranho de forma diferente de um contato regular.

Chamadas para um número da API do WhatsApp Business não disparam este gatilho, assim como chamadas para números comprados através da plataforma ou para um telefone usado como um gateway de SMS Android. Os chamadores só são salvos como contatos em contas que têm uma automação de Chamada perdida ativada; sem uma, uma chamada perdida não deixa rastros no aplicativo. Para o número de SMS, há mais uma condição: a chave Responder chamadas perdidas com texto no cartão SMS via Twilio deve estar ativada, porque essa chave é o que direciona as chamadas do número para DM Champ em sua conta Twilio. Uma automação criada manualmente para o número de SMS não faz nada enquanto essa chave estiver desligada; ligue-a primeiro e, em seguida, personalize a automação que ela criou.

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 DM Champ 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 independentemente de quanto tempo o lead ficou em silêncio — esse é o objetivo principal da etapa. Variáveis que você deixar vazias em Variáveis do modelo são preenchidas a partir dos próprios campos do contato, e isso requer que seu canal 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: confirmação de pedido via WhatsApp do Shopify #

Envie um modelo do WhatsApp no momento em que alguém fizer um pedido em sua loja Shopify, com o nome e o número do pedido preenchidos. É necessário um modelo aprovado (por exemplo, “Olá {{1}}, obrigado pelo seu pedido {{2}}!”) e seu canal API do WhatsApp Business conectado.

1. Comece com um gatilho de Webhook. Crie uma nova automação, escolha o gatilho Webhook e copie seu endereço web. Adicione ?secret= e o segredo da etapa de gatilho ao final do endereço, porque o Shopify não pode enviar um cabeçalho personalizado.

2. Aponte o Shopify para ele. No Shopify, vá para Configurações > Notificações > Webhooks, crie um webhook para Criação de pedido no formato JSON e cole o endereço. Na etapa de gatilho, clique em Começar a ouvir em Ouvir webhooks recebidos, faça um pedido de teste (ou envie uma notificação de teste do Shopify) e escolha o pedido capturado como amostra, para que seus campos apareçam no seletor +.

3. Opcional: salve o número do pedido no contato. Adicione uma etapa Criar contato. Defina Número de telefone como ${trigger.phone}, Nome como ${trigger.customer.first_name} e, em Campos personalizados, preencha seu campo de número de pedido (por exemplo, order_id) com ${trigger.name}. Se o cliente já for um contato, o número do pedido será salvo no contato existente.

4. Envie o modelo. Adicione uma etapa Enviar modelo do WhatsApp. Digite o nome do modelo exatamente como ele aparece em Modelos do WhatsApp e, em seguida, preencha para quem ele vai: insira o ID do contato da etapa Criar contato ou coloque ${trigger.phone} em Número de telefone. Em Variáveis do modelo, preencha as caixas:

• {{1}} (o nome do cliente): ${trigger.customer.first_name}
• {{2}} (o número do pedido): ${trigger.name}, que é o nome do pedido do Shopify, como #1001

Use o próprio número de telefone do pedido, ${trigger.phone}, em formato internacional. O campo de telefone do cliente, ${trigger.customer.phone}, geralmente está vazio nos pedidos do Shopify, e um envio sem número falha.

5. Teste. Clique em Executar com a amostra capturada, abra a execução em Log e verifique se a mensagem foi enviada com o nome e o número do pedido nela.

Em seguida, ative a automação. Enquanto ela estiver desligada, os webhooks do Shopify ainda são recebidos e aparecem em Ouvir webhooks recebidos, mas nenhuma mensagem é enviada.

Lembretes de carrinho abandonado: O Shopify não possui um webhook de carrinho abandonado. Use a mesma configuração com o webhook Atualização de checkout do Shopify, adicione um Atraso, depois uma Condição em uma tag que uma segunda automação (na Criação de pedido) dá aos compradores, para que o lembrete vá apenas para pessoas que não fizeram o pedido.

Exemplo: acompanhamentos por e-mail para leads de chat do site #

Alguém conversa com seu agente no site, deixa seu nome e e-mail, e desaparece antes de agendar. Você quer verificar por e-mail nos próximos dias — e parar no momento em que eles disserem que agendaram. Duas automações fazem isso; ambas usam seu Canal de E-mail conectado, para que as respostas caiam em Chats e seu agente de e-mail as gerencie.

Antes de começar. Ative Coletar informações do visitante no widget de chat para que cada visitante deixe um nome e e-mail. Conecte o canal de E-mail e dê ao seu agente uma regra de tag na aba Tags, como Agendado — aplicar quando a pessoa disser que agendou ou marcou sua sessão (Agentes de IA → Tags). Essa tag é o interruptor de desligamento.

Automação 1 — mover o lead para o e-mail.

1. Gatilho Mensagem recebida, restrito ao canal Chat do site, e nas Configurações de automação desative Permitir reentrada para que cada visitante passe por ele uma vez, na primeira mensagem. (Não Novo contato: um gatilho de “contato criado” seguido por uma etapa de Criar contato é o formato de auto-gatilho que o editor recusa — veja Automações que disparam a si mesmas.)
2. Uma Condição no e-mail do contato — não contém unknown@ — para que visitantes que não deixaram endereço terminem aqui em vez de falhar na próxima etapa.
3. Um Atraso de, digamos, uma hora, para que a conversa no site termine primeiro.
4. Criar contato com Canal definido como E-mail. Insira o e-mail do visitante com o botão + (${trigger.contact.email}), e seu nome e sobrenome da mesma forma. Deixe o número de telefone vazio. Se esse endereço já for um contato de e-mail, a etapa simplesmente o retorna.
5. Enviar mensagem com o ID do contato inserido a partir da etapa Criar contato. Isso sai como um e-mail da sua caixa de entrada conectada — o primeiro check-in, por exemplo, “Você conseguiu agendar sua sessão?”. Um e-mail proativo não tem mensagem anterior para responder, então seu assunto é Mensagem de seguido pelo nome do remetente da sua caixa de entrada; as respostas mantêm esse assunto.

Automação 2 — a sequência de acompanhamento, no contato de e-mail.

1. Gatilho Novo contato, restrito ao canal E-mail. Ele dispara no momento em que a Automação 1 cria o contato de e-mail (e para qualquer pessoa que lhe envie um e-mail primeiro — adicione uma Condição em uma tag ou nos detalhes do contato se você quiser apenas leads do site nela).
2. Atraso de dois dias.
3. Encontrar contato pelo e-mail do contato (insira-o a partir do gatilho), restrito ao canal E-mail, para que a verificação leia as tags do contato como elas estão agora, em vez de como estavam quando a execução começou.
4. Condição: o tag_names do contato encontrado contém Booked. Deixe o caminho verdadeiro vazio — isso encerra a execução para qualquer pessoa que tenha agendado.
5. No caminho falso, Enviar mensagem ao contato com seu segundo check-in, depois Atraso, Encontrar contato, Condição e Enviar mensagem novamente por quantas rodadas você quiser. Termine com uma Definir tag de contato como Sequence complete para que você possa ver quem foi até o fim.

Quando o lead responde a qualquer um dos e-mails, a conversa já está em Chats no contato de e-mail, o agente de e-mail responde, e se a resposta disser que agendaram, a regra de tag do agente adiciona Agendado e a Condição da próxima rodada encerra a sequência. Deixe Parar na resposta desativado na Automação 2: isso encerraria a sequência em qualquer resposta, incluindo “ainda não”.

Duas coisas que vale a pena saber. O chat do site e a conversa por e-mail são dois contatos que compartilham um endereço, não um thread mesclado — o chat do widget permanece no contato do site e os e-mails vivem no contato de e-mail. E um contato é um por canal, então se a mesma pessoa lhe enviar um e-mail primeiro, a etapa Criar contato da Automação 1 retorna esse contato de e-mail existente em vez de criar um segundo.

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 da automação (o ícone de engrenagem no canto superior direito), 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 certos 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.

Cancelando uma execução. Uma execução que ainda está em andamento, incluindo uma que esteja aguardando um Atraso ou retida devido ao horário de silêncio, pode ser interrompida manualmente: clique em Cancelar na sua linha no histórico de execuções, ou abra a execução e clique em Cancelar execução, e então confirme. A execução para onde está e é exibida como Cancelada. As etapas que ainda não foram alcançadas nunca são executadas, portanto, nada mais é enviado a partir dela; as etapas que já foram executadas não são desfeitas. Apenas essa execução é afetada: a automação permanece ativa para todos os outros.

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 o botão Ativado possa ser alternado: 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 o botão funcionará normalmente. A pausa nunca é bloqueada.
• Variáveis que não são resolvidas são relatadas. Se um valor ${…} em uma das 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 espaço em branco”.
• Uma execução que seguiu o outro caminho informa isso. Após uma execução, o painel de execução na tela lista cada Condição que passou com o caminho que seguiu (Sim ou Não) e conta as etapas que não foram executadas. Uma execução cuja condição respondeu Não ainda termina como bem-sucedida, então é aqui que você vê que as etapas no caminho Sim foram ignoradas.
• Uma etapa recusada é mostrada como falha, com o motivo. Uma etapa que o aplicativo recusou (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.

Exemplo: uma mensagem de aniversário todas as manhãs #

Envie a cada contato uma mensagem no aniversário dele. Você precisa de um campo personalizado de Data contendo o aniversário (o ano pode ser qualquer um, apenas o mês e o dia são usados).

1. Estúdio de IA → Automações → Nova automação com o gatilho Agendado, definido para 0 9 * * * (todos os dias às 9h) com seu fuso horário.
2. Adicione uma ação Encontrar contatos. Em Filtros avançados, adicione a regra Aniversário, aniversário é nos próximos N dias, 0 (apenas hoje). Defina Quantos para 1000: o padrão é 50, e apenas os contatos que ele analisar podem corresponder.
3. Adicione um Loop e, com o botão +, escolha a lista de contatos da etapa Encontrar contatos como a lista a ser percorrida.
4. No manipulador de corpo do loop, adicione uma etapa Enviar mensagem. Para ID do contato, insira o ID do item do loop com o botão + (ele aparece como ${nodes.loop_1.item.id} quando o loop é chamado loop_1). A mensagem pode cumprimentá-los pelo nome da mesma forma, com o first_name do item.

Essa é a automação completa: nenhuma etapa de Condição ou Transformação é necessária, porque Encontrar contatos já retorna apenas os aniversariantes de hoje. Em um dia sem aniversariantes, o loop é executado zero vezes e a execução ainda aparece como bem-sucedida.

A regra de aniversário conta os dias em UTC. Para uma execução matinal, isso é bom em quase todos os lugares; se você estiver mais de 9 horas à frente do UTC, execute-a mais tarde no dia (após as 11h em Sydney, após as 13h na Nova Zelândia) para que sua data e a data UTC sejam as mesmas.

Ativando uma Automação #

Use a chave Ativado para colocá-la em operação (isso salva seu rascunho primeiro) — a partir desse momento, ela é disparada de verdade toda vez que seu gatilho ocorrer. Mude-a de volta para Pausado a qualquer momento para interrompê-la sem perder seu trabalho. Pausar impede que novas execuções sejam iniciadas; execuções que já estão aguardando um Atraso ou o horário de silêncio ainda serão concluídas. Para interromper uma dessas, clique em Log e use Cancelar na sua linha no histórico de execuções. Uma automação precisa estar pausada antes que você possa excluí-la.

Automações que disparam a si mesmas #

Alguns fluxos podem acionar seu próprio gatilho. O caso clássico: uma automação que inicia em Tarefa criada e tem 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, Agendamento marcado mais Criar agendamento ou Negócio criado mais Criar negócio.

Três salvaguardas detectam isso:

• O editor avisa você imediatamente. Assim que um fluxo tem esse formato, um banner vermelho aparece acima da tela nomeando a etapa e a correção, a etapa recebe um marcador vermelho e a chave Ativado, Executar e Reexecutar permanecem desligados até que seja corrigido. Você pode continuar editando e salvando uma automação pausada; se a automação já estiver ligada, a alteração não será salva até que você a pause ou corrija a etapa. Fluxos que podem se reacionar (um gatilho de Contato atualizado com uma etapa que altera o contato — editar detalhes, tags, listas ou campos personalizados, atribuí-lo a um membro da equipe, ligar ou desligar sua IA, definir não perturbe ou entregá-lo a outro agente de IA, por exemplo) recebem um aviso âmbar, que não bloqueia nada: escolha um campo para o gatilho monitorar, para que ele inicie apenas nas alterações que lhe interessam. Um gatilho de Estágio do negócio alterado com uma etapa Mover estágio do negócio, e um gatilho de Tag aplicada ou Tag removida com uma etapa Definir tag de contato ou Remover tag de contato, recebem o mesmo aviso âmbar: esses são fluxos comuns (“quando chegar em Ganho, adicione uma tag”) até o momento em que a etapa grava exatamente o que o gatilho monitora, então nós avisamos e deixamos a escolha para você.
• 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 dirá qual etapa alterar. Quando você quiser alterar a própria coisa que iniciou a execução (definir uma data de vencimento na tarefa que acabou de ser criada, adicionar uma tag ao contato que acabou de entrar), use a etapa Atualizar correspondente no ID do gatilho: Atualizar tarefa com ${trigger.task.id}, Atualizar contato com ${trigger.contact.id}. Atualizar não dispara novamente um gatilho de “criado”.
• Uma automação descontrolada desliga-se sozinha. Uma automação que continua sendo executada a mais de 30 execuções por minuto por vários minutos seguidos é pausada automaticamente, e uma execução falha aparece em seu histórico explicando o motivo. Uma com o formato de autoalimentação acima é interrompida muito mais cedo, após 10 execuções em um minuto. Picos normais não são um problema: importar 300 contatos para uma automação de Contato criado dispara 300 execuções em um minuto e depois fica silenciosa, o que não é um loop. Execuções de teste que você inicia na barra de ferramentas nunca são contadas. Corrija o fluxo e ligue-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. Os 0,25 são cobrados uma vez, quando a execução começa, então uma execução que uma etapa de Condição interrompe na primeira ramificação ainda conta como uma execução e ainda custa os mesmos 0,25. 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. A etapa de IA sempre é executada no modelo Max, independentemente do modelo que seus Agentes usam, portanto, mudar um Agente para Mini não altera o custo de uma automação. Se o seu saldo acabar, uma execução falha com uma mensagem clara de “créditos insuficientes” no histórico de execução, e novas execuções são processadas novamente assim que você recarregar.

Uma etapa da seção API da conta é cobrada exatamente como a mesma chamada para a API seria. A maioria dos endpoints não custa nada, e aqueles que executam IA para você, resumos de conversas por exemplo, custam o que a API cobra por eles. Não há cobrança extra por etapa além disso.

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.

Copiar uma automação para uma conta de cliente #

Se você gerencia contas de clientes, uma automação que você aperfeiçoou em sua própria conta pode ser replicada em qualquer uma delas. Na lista de automações, clique no botão Copiar para conta de cliente (as duas setas) na linha da automação, marque as contas de clientes para as quais deseja copiá-la e clique em Copiar para. O botão fica ao lado de Duplicar e só aparece em uma conta de agência.

A cópia mantém o nome da automação, seu gatilho e cada etapa. Duas coisas são deliberadamente diferentes na conta do cliente:

• Ela chega pausada. Nada é executado até que alguém a abra na conta do cliente, verifique tudo e ative a opção Habilitado.
• Tudo o que apontava para sua conta é limpo, porque esses IDs não significam nada na conta de outra pessoa: a conta de cliente para a qual uma etapa era direcionada, uma lista inteligente escolhida, um evento de calendário escolhido e uma conexão de banco de dados escolhida. Preencha-os com os dados do próprio cliente assim que a cópia estiver lá — as etapas em si permanecem inalteradas.

Se uma etapa ou o gatilho apontava para um de seus agentes de IA, a cópia tenta apontar automaticamente para o agente correspondente do cliente. Isso funciona quando o agente do cliente veio do mesmo snapshot ou foi copiado do mesmo agente seu — sabemos que ambos possuem a mesma configuração, portanto, o link é refeito automaticamente. Quando não há correspondência, a cópia informa qual agente não pôde ser definido; abra a automação na conta do cliente, selecione o agente lá e ative-a.

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.