## Visão geral

Uma **macro** é uma sequência de ações pré-definidas que o agente dispara **manualmente** dentro de
uma conversa. Enquanto a regra de automação age sozinha quando um evento acontece, a macro é acionada
por uma pessoa, no momento certo, com um único clique.

Macros são ideais para procedimentos padronizados: encerrar um atendimento com a mensagem de
despedida, escalar para outra equipe, marcar etiquetas e responder com um texto-padrão — tudo de uma
vez, sem erros e sem repetição.

## Pré-requisitos

- Permissão de administrador para criar e editar macros em Configurações.
- Pelo menos uma conversa onde a macro será executada pelo agente.
- Para ações que envolvem outros módulos (CRM, Tarefas, Catálogo), o módulo correspondente precisa
  estar ativo.

## Passo a passo

Se a conta ainda não tiver macros, o estado vazio explica o próximo passo e oferece o botão de
criação diretamente no cartão.

1. Em Configurações, abra a área de **Macros** e crie uma nova macro.
2. Dê um **nome** claro (é o que o agente verá na conversa).
3. Adicione as **ações** na ordem em que devem ser executadas — por exemplo:
   1. Atribuir a uma equipe;
   2. Adicionar uma etiqueta;
   3. Enviar uma mensagem ao contato;
   4. Resolver a conversa.
4. **Salve** a macro.
5. Para executar: abra uma conversa, localize a área de macros e clique na macro desejada. As ações
   são aplicadas na sequência definida.

## Configurações & opções

- **Visibilidade**: defina se a macro fica disponível para toda a conta ou apenas para quem a criou,
  conforme as opções do formulário.
- **Ordem das ações**: as ações são executadas de cima para baixo — reordene conforme o procedimento.
- **Tipos de ação**: atribuir agente/equipe, adicionar/remover etiqueta, enviar mensagem, adicionar
  nota privada, reabrir conversa, marcar como pendente, resolver conversa, enviar anexo, **enviar um
  e-mail para o time**, **adicionar SLA** (requer o módulo de SLA) e ações de módulos ativos (CRM,
  Tarefas, Catálogo).
- **Ações de contato**: adicionar etiqueta ao contato (`add_contact_label`), remover etiqueta do
  contato (`remove_contact_label`), adicionar nota ao contato (`add_contact_note`), definir atributo do
  contato (`set_contact_custom_attribute`), criar contato (`create_contact`) e criar conversa
  (`create_conversation`) — as mesmas ações disponíveis nas Automações e no Flow Builder.
- **Ações sem parâmetros**: ações como cancelar, pausar, retomar e pular etapa de follow-up, enviar
  cobrança, cancelar assinatura e enviar cartão de produto **salvam sem exigir parâmetros** — elas
  resolvem o contexto a partir da conversa em que a macro é executada.
- **Edição**: você pode editar a sequência a qualquer momento; a alteração vale para as próximas
  execuções.

## Casos de uso

- **Encerramento padrão**: enviar a mensagem de despedida, etiquetar como "resolvido" e resolver.
- **Escalonamento**: atribuir à equipe de suporte avançado e adicionar uma nota interna com o contexto.
- **Qualificação**: etiquetar como "lead quente" e criar/atualizar o negócio no CRM.
- **Primeira resposta**: enviar a mensagem de boas-vindas e atribuir ao responsável do canal.

## Dicas, limites e boas práticas

- Crie macros para os 5–10 procedimentos mais comuns da equipe — é onde elas mais economizam tempo.
- Use nomes que descrevam o resultado ("Encerrar atendimento", "Escalar para N2"), não o passo a passo.
- Revise as macros periodicamente: etiquetas e equipes mudam, e ações órfãs podem falhar.
- Macro x regra: se a ação deve acontecer **sozinha** quando um evento ocorre, use uma **regra de
  automação**; se deve ser **decidida pelo agente**, use uma **macro**.

## Solução de problemas

- **Não vejo a macro na conversa**: confirme se ela está salva e visível para o seu usuário.
- **Uma ação da macro não executou**: verifique se o agente, equipe ou etiqueta referidos ainda
  existem e se o módulo da ação está ativo.
- **A ordem saiu errada**: reabra a macro e reordene as ações; elas seguem a sequência de cima para baixo.
- **Uma ação aparece com o valor bloqueado, mostrando só um número**: a ação aponta para um registro de
  um módulo que está desativado na conta ou ao qual o seu perfil não tem acesso (por exemplo, uma
  sequência de follow-up ou uma política de SLA). Um valor bloqueado também pode significar que a
  lista ainda não carregou, que a busca falhou ou que a lista do seu perfil de acesso não inclui o
  registro (ele pode estar fora do seu alcance ou ter sido removido). A dica explica a causa. A
  referência fica inalterada ao salvar outras mudanças. Recarregue a página para repetir uma busca
  que falhou; se o acesso for restrito, peça a quem tem acesso ou reative o módulo.
- **Uma ação mostra um número em vez do nome**: o registro pode estar fora da página carregada de uma
  lista longa ou ter sido removido. Um lote preparado também pode aparecer só pelo identificador.
  Quando uma busca confirma a remoção, o campo o identifica como removido. O valor continua
  selecionado e é salvo sem alteração; escolha outro item só se quiser
  trocá-lo.
- **Aparece o aviso "Não foi possível verificar quais módulos estão ativos nesta conta"**: a plataforma não
  conseguiu carregar as configurações da conta. Clique em **Tentar novamente** no próprio aviso. Enquanto isso, as
  ações que dependem de um módulo ficam bloqueadas com o valor salvo, e salvar outras mudanças não as altera.
- **Não encontro uma ação de fluxo, follow-up ou contrato ao criar uma macro**: essas ações só aparecem quando o
  módulo correspondente (Flow Builder, Follow-up ou Contratos) está ativo na conta. Uma macro que já usa a ação
  continua mostrando-a, bloqueada e com o valor salvo.

## Veja também

- [Regras de automação: gatilhos, condições e ações](/hc/ajuda/articles/automation-flows-regras-de-automacao-pt-br)
- [Automações de contato: gatilhos e ações no cadastro](/hc/ajuda/articles/automation-flows-automacoes-de-contato-pt-br)
- [Visão geral de Automação e Fluxos](/hc/ajuda/articles/automation-flows-overview-pt-br)
- [Flow Builder: fluxos conversacionais visuais](/hc/ajuda/articles/automation-flows-flow-builder-pt-br)