Automações
As automações rodam sozinhas: cartões Quando, Se e Então, início por uma receita ou uma frase e um passo com agente onde é preciso julgamento.
Uma automação é uma cadeia de passos que roda sozinha: quando algo acontece e corresponde, o Customermates faz o que você configurou. A maioria dos passos é exata: criar uma tarefa de acompanhamento, definir um campo, avisar você ou sua equipe na página Notificações e por e-mail, ou chamar um webhook. Um passo, Pedir a um agente, deixa um agente de IA fazer a parte que exige julgamento, por exemplo redigir uma resposta. As automações sem passo de agente são gratuitas, funcionam em todos os planos e rodam em instâncias auto-hospedadas. Em uma instância auto-hospedada, as regras de data e os e-mails de resumo só funcionam depois de você configurar as duas chamadas agendadas descritas em Hospedagem própria.
A página Automações é uma lista única para tudo o que roda sozinho: automações e Rotinas, que deixam o Mate trabalhar com agendamento ou quando um registro muda (somente Customermates Cloud). Cada linha mostra em uma frase o que faz, Executa em (Grátis para passos exatos, Mate, Chave própria ou Runner próprio quando um agente participa), a última execução, as execuções dos últimos 30 dias e um interruptor para pausar ou retomar. Busca, filtro por tipo, status ou onde executa e visualizações salvas funcionam como em qualquer lista. A antiga página Rotinas redireciona para cá. Quem vê a página depende da linha Rotinas e automações da própria função em Funções (em uma instância auto-hospedada, a linha se chama Automações): Acesso de leitura Todos mostra todas as automações do espaço de trabalho, Atribuídos só as da própria pessoa, e Nenhum oculta a página. Criar exige Criar.
Como crio uma automação?
Abra Automações e clique em Nova automação, ou clique em Automatizar esta lista na barra de ferramentas de qualquer lista para começar com essa lista já escolhida. No Customermates Cloud com Mate, Nova automação abre um menu com Automação e Rotina (Mate com agendamento).
O construtor abre em uma tela inicial. Com o Mate, escreva uma frase em Diga ao Mate o que deve acontecer quando … e clique em Preparar: o Mate devolve um rascunho para você conferir, e nada é salvo até você clicar em Ativar. Cada rascunho usa um pouco dos seus créditos do Mate, e o Mate recusa quando eles acabam. Abaixo, ou como grade se você não usa o Mate, estão as receitas: Responder a novas consultas, Acompanhar depois de uma proposta, Lembrar antes de uma renovação, Dar boas-vindas a um envio de formulário, Cobrar documentos que faltam, Revisão semanal (uma rotina, somente Cloud), Motivo de ganho ou perda e Me avisar quando um agendamento for cancelado. Uma receita é uma cadeia completa; onde precisa de uma lista ou de um campo que não pode conhecer, o cartão pede que você escolha. Começar do zero abre uma cadeia vazia.
A cadeia é uma coluna de cartões que se lê de cima para baixo como uma frase. Clique em um cartão para abrir os campos no próprio lugar e no + entre os cartões para adicionar um passo da paleta, na qual você pode buscar. Dê um Nome, escolha Ativa ou Em pausa no alto e clique em Ativar (Salvar para uma automação que já existe). À direita, Prévia mostra o que um lembrete de data faria com seus registros atuais, e Execuções lista o histórico.
- Quando escolhe o que inicia a cadeia: Um registro é criado, Um registro é atualizado, Um campo muda (com Para o valor opcional, para disparar só quando o campo mudar para esse valor), Uma data é alcançada, Uma mensagem é recebida, Um formulário é enviado, Um webhook é recebido ou Um agendamento é cancelado ou reagendado (com Alteração definida como Qualquer alteração, Cancelado ou Reagendado; dispara para agendamentos que criaram um registro, seja a alteração feita pelo visitante ou pelo anfitrião).
- Se acrescenta condições sobre o registro que iniciou a cadeia: é, não é, é um de ou não é nenhum de várias opções de um campo de escolha, está vazio, não está vazio, é antes de hoje mais ou é depois de hoje mais um número de dias. Todas as condições precisam corresponder. Um campo vazio conta como não é. Hoje é o dia no Fuso horário de um gatilho de data. Para qualquer outro gatilho é o dia no seu fuso horário, que é salvo com a automação quando você a salva aqui e depois não muda. Uma automação criada com
manage_rulesvia MCP ou REST usa o dia UTC até que o gatilho traga umtimezone. - Então lista o que acontece, em ordem: Definir um campo, Criar um registro, Notificar, Chamar um webhook ou Pedir a um agente. Criar um registro é como uma automação cria uma tarefa de acompanhamento: escolha a lista de tarefas, o Campo de título e o Título, o Campo de vencimento e Vence em dias, se deve Atribuir a mim e como Vincular ao registro que a disparou como. Em títulos e detalhes,
{{record.name}}é substituído pelo nome do registro e{{rule.name}}pelo nome da automação.
Uma parte que não pode ser editada aqui, por exemplo uma regra limitada a um único formulário, a um único webhook de entrada ou a uma única página de agendamento, uma condição com uma data fixa ou uma ação que define vários campos, é definida com manage_rules por MCP ou REST; ao abrir a regra aqui, o cartão correspondente mostra uma observação e essa parte continua como está.
Como funciona o passo Pedir a um agente?
Um cartão Pedir a um agente contém, em palavras simples, o que o agente deve fazer e onde ele executa: Mate (Customermates Cloud, usa créditos de IA), Sua própria chave (uma chave de provedor que você salvou) ou Seu próprio runner (uma máquina que você controla). Uma forma de execução que ainda não está configurada mostra o motivo, por exemplo que ainda não há chave ou runner conectado, com um link para Configurações, Agentes. Se a sua função não puder abrir essa página, aparece no lugar que um administrador pode configurar isso. Com sua própria chave você pode escolher um modelo; com um runner, um específico. Um passo salvo sem modelo mantém a partir daí o modelo padrão da sua única chave; com várias chaves você precisa escolher um. Um passo não é salvo enquanto indicar um modelo que suas chaves não oferecem, um runner que não é seu ou foi revogado, ou um webhook que não existe mais ou que não selecionou o evento das automações. O registro que iniciou a cadeia é entregue ao agente como contexto, e {{record.name}} e {{rule.name}} funcionam na instrução.
Como recebo um lembrete antes de uma data?
Abra uma lista que tenha um campo de data ou de data e hora, abra Mais ações na barra de ferramentas e escolha Lembrar-me de seguido do nome do campo. O construtor abre com um gatilho Uma data é alcançada para esse campo, então você só escolhe Dias, Antes ou depois, Na hora (0 a 23) e Fuso horário, e acrescenta uma ação Notificar que avisa você. O lembrete chega a você na página Notificações e, conforme sua preferência, por e-mail.
Uma regra de data dispara uma vez por registro que o proprietário dela consegue ler, quando a data deslocada pelo seu intervalo é alcançada. Ela é verificada a cada poucos minutos. Uma regra que você cria ou liga depois ainda pega as datas alcançadas nos últimos 7 dias, e um registro cuja data você muda para outro dia dispara de novo para a nova data. Preview por MCP ou REST lista os registros que uma regra de data atingiria em seguida, entre os que você consegue ler.
Como as automações rodam, e o que o histórico mostra?
Uma automação roda como o proprietário dela, com as permissões dele: nunca pode fazer mais do que o proprietário poderia. Quem a cria é o proprietário. Só o proprietário pode alterar ou ligar uma automação; um administrador também pode desligá-la ou excluí-la. Se o proprietário deixa de ser um membro ativo, a automação se desliga sozinha e informa isso.
Uma execução acontece uma vez por registro e gatilho. O que uma automação altera nunca inicia a mesma automação de novo, e uma cadeia termina depois de duas regras, para que duas automações não se iniciem uma à outra sem fim. Uma alteração feita por uma rotina pode iniciar uma automação, mas o que essa automação altera depois não inicia uma rotina de novo. Se uma ação falha, as ações seguintes não rodam.
Abra uma automação e escolha a aba Execuções, ou escolha Histórico de execuções no menu da linha, para ver as execuções dela, das mais recentes para as mais antigas. Cada execução mostra o status (Na fila, Em andamento, Concluída, Ignorada ou Falhou), o resultado de cada ação e um link Abrir o registro. Um passo de agente que foi iniciado também tem Mostrar a execução do agente, que abre o status e a transcrição dele. Uma execução ignorada diz o motivo: as condições não foram atendidas, a automação estava desligada, a automação foi alterada depois que o gatilho dela foi atendido, a data de um gatilho de data foi alterada ou apagada antes da execução, o registro não existe mais ou o proprietário não consegue lê-lo, o proprietário mudou, ou ele não está mais ativo ou não tem mais acesso às automações. Uma execução que não termina é tentada de novo e, depois de meia hora, é marcada como Falhou. Uma execução também falha quando uma lista ou um campo que a automação usa foi excluído.
Excluir uma automação a remove para sempre junto com o histórico; desligue-a em vez disso se talvez precise dela de novo.
Como funcionam as notificações e as preferências de e-mail?
Notificações, no grupo Visão geral da barra lateral, mostra quantas notificações não foram lidas. Abra a página para ver as mais recentes, abrir o registro correspondente ou escolher Marcar tudo como lido. As notificações vêm de três tipos de eventos: Vencem hoje, Respostas recebidas e Alertas de automação. A página sempre mostra tudo e guarda as notificações por 90 dias.
Se um tipo também chega a você por e-mail, a escolha é sua, tipo por tipo, no cartão E-mails de notificação em Perfil e preferências, uma tabela com uma linha por tipo: E-mail imediato, Resumo diário ou Sem e-mail (detalhes). Enquanto você não mudar nada, os alertas de automação chegam na hora, e vencimentos e respostas chegam no resumo diário. O resumo é um e-mail por dia com o que ainda não foi enviado por e-mail. Um e-mail que não pôde sair na hora, por exemplo porque chegaram mais de 20 em uma hora ou o serviço de e-mail não respondeu, segue em poucos minutos, vários deles em um único e-mail. Uma notificação que não pôde ser enviada por e-mail em 48 horas não é mais enviada e fica na página Notificações. Em uma instância com hospedagem própria, esse reenvio precisa da chamada a cada cinco minutos descrita em Hospedagem própria.
Todo e-mail de notificação termina com duas linhas. A primeira diz por que você o recebe: "Você recebe este e-mail porque ... enviou uma notificação para você", com o nome da automação quando a notificação vem de uma e, caso contrário, com o tipo. A segunda tem dois links. Desativar este tipo abre uma página que informa o tipo, o espaço de trabalho e o endereço de e-mail mascarado a que se aplica, e pede confirmação. Depois de confirmar, esse tipo fica em Sem e-mail sem precisar entrar e uma página informa de quem os e-mails foram desativados; se você estiver conectado como esse membro, abre-se Perfil e preferências com um aviso. O link vale por 30 dias, ou até você mesmo mudar a opção de e-mail desse tipo, por exemplo ligando-o de novo, e um link expirado ou incorreto abre uma página que diz isso; Gerenciar notificações abre Perfil e preferências. Um resumo que reúne vários tipos nomeia cada fonte e oferece um link de desativação por tipo. Ele lista até 20 notificações, diz quantas outras aguardam, e seu botão abre a página Notificações.
Quantas automações meu plano inclui?
O limite conta as automações ligadas: o Free inclui 3, o Starter 20, e o Pro, o Business, o Max e o Enterprise ilimitado. Desligar uma automação libera a vaga dela na hora. No limite, criar ou ligar outra é recusado com um convite para fazer upgrade em Faturamento ou para desligar outra automação. Quando o plano muda para um que permite menos, as automações mais antigas cujo proprietário continua sendo um membro ativo seguem até o limite; as demais são desligadas com a nota de que o plano as pausou, e voltam a ser ligadas quando o plano permitir. Instâncias auto-hospedadas não têm plano, então lá não vale nenhum limite.
Como o Mate gerencia as automações?
Em um chat, o Mate pode listar suas automações, ler uma com o histórico de execuções e mostrar antes quais registros uma regra de data atingiria, sem pedir antes. Criar, alterar, ligar ou desligar e excluir uma automação pedem, cada um, a sua aprovação. Quando o Mate configurou seu espaço de trabalho a partir de um modelo, ele oferece uma vez as regras desse modelo, depois que as listas existem, e cria cada uma só depois da sua aprovação; as regras que exigem uma rotina de agente ou um gatilho que o mecanismo de regras não tem são citadas com o motivo.
Para agentes
Use manage_rules por MCP, com as ações list, get, runs, create, update, enable, disable, delete e preview. Se enabled for omitido em create, a automação nasce ligada; passe enabled: false para salvar um rascunho. Os gatilhos são recordCreated, recordUpdated, fieldChanged, dateReached, messageReceived, formSubmitted, webhookReceived e bookingChanged (change é any, cancelled ou rescheduled, e sourceId limita o gatilho a uma página de agendamento); os ids de lista e de campo vêm de discover_record_types e get_record_model. Uma recusa por causa do plano chega com o limite e o preço do upgrade. REST oferece as mesmas operações como POST /api/v1/rules/list, read, runs, create, update, enable, disable, delete e preview, com permissão de leitura em Rotinas e automações para ler e permissão de criação para criar; veja a referência da API.
Perguntas frequentes
Uma automação é a mesma coisa que uma rotina?
Não. Uma rotina abre uma conversa e deixa o Mate trabalhar, usa a franquia do Mate do proprietário e só existe no Customermates Cloud. Uma automação executa uma regra fixa de quando, se e então sem IA, em todos os planos e em instâncias auto-hospedadas. Para o outro tipo, veja as rotinas.
Por que minha automação não rodou para um registro?
Abra a automação e escolha a aba Execuções, ou escolha Histórico de execuções no menu da linha. Uma execução ignorada diz o motivo, por exemplo condições não atendidas ou um proprietário que não está mais ativo. Uma regra de data também precisa de uma data no campo e dispara uma vez por registro e data.
Uma automação pode enviar um e-mail para um cliente?
Não diretamente. Uma automação não envia e-mails nem mensagens por si mesma. Ela pode notificar membros do seu espaço de trabalho, o que pode alcançá-los por e-mail, e pode chamar um dos seus webhooks, por exemplo para iniciar um fluxo do n8n que envie algo. A chamada é o evento automation.rule.fired, entregue como qualquer outro evento de webhook com novas tentativas e histórico, então o webhook precisa tê-lo selecionado em Quais eventos existem?.
Quem recebe a notificação quando uma automação avisa alguém?
A ação decide: Avisar-me alcança o proprietário da automação, Avisar as pessoas atribuídas alcança os membros a quem o registro que a disparou está atribuído. A notificação aparece na página Notificações deles e segue a preferência de e-mail deles para Alertas de automação. Um membro que não consegue ler o registro que a disparou recebe a notificação sem o nome do registro e sem o link.