> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octasend.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Automações

> Sequências de mensagens que disparam sozinhas a partir de pedidos, eventos da loja, datas, segmentos de contatos ou da sua API

Uma **automação** envia mensagens sozinha quando algo acontece: um pedido chega, um cliente faz aniversário, alguém passa 120 dias sem comprar, o seu sistema avisa que um cadastro foi concluído. Você desenha o caminho uma vez, com esperas, condições e envios, e a OctaSend executa esse caminho para cada pessoa que entra nele.

A funcionalidade fica no item **Automações** do menu lateral. O que cada pessoa pode fazer com as automações depende do **perfil de acesso** dela (veja [Configurações](https://docs.octasend.com.br/plataforma/configuracoes.md#perfis-de-acesso)): **Visualizar**, **Criar**, **Editar**, **Excluir** e **Ativar e pausar**. Com perfil só de **Visualizar**, o editor abre em somente leitura, com um aviso, e nada é gravado. Publicar uma automação exige **Editar** e **Ativar e pausar**.

> [!NOTE]
>
> Automações é um módulo que pode estar desativado na sua conta. Nesse caso, o item não aparece no menu, a aba **Automações** some da tela de Logs e quem abre um link direto vê a mensagem "Módulo não liberado". Fale com a OctaSend para ativar.

## Como uma automação funciona

* Toda automação começa por um passo **Início**, que define o gatilho: o que faz alguém entrar nela.
* Depois do Início vêm os passos (enviar, esperar, verificar uma condição, marcar o contato, e outros), ligados por setas no desenho.
* Cada vez que alguém entra, nasce uma **execução**. Ela percorre os passos um a um e fica registrada na tela de execuções, com o resultado de cada passo.
* O que você edita é um **rascunho**, salvo automaticamente. Ele só passa a valer quando você clica em **Ativar automação** (ou **Publicar alterações**, se ela já estiver ativa). Cada publicação vira uma versão nova e fixa.
* Uma execução que já começou segue até o fim na versão em que nasceu, mesmo que você publique alterações no meio do caminho.

## Lista de automações

A tela **Automações** mostra:

* **Totais:** Total de automações, Ativas, Pausadas e Rascunhos.
* **Mensagens enviadas por dia:** gráfico com os envios bem-sucedidos feitos por automações, nos últimos 7, 30 ou 90 dias (seletor **Período**).
* **Tabela:** Nome, Situação, Última alteração e Última execução de cada automação. Clique na linha para abrir o editor.

Em cada linha há os atalhos **Ver execuções** (ícone de histórico), **Renomear** (lápis) e **Excluir** (lixeira) e, nas automações ativas ou pausadas, o botão **Pausar** ou **Ativar**. Veja [Renomear e excluir](#renomear-e-excluir).

No topo ficam as duas formas de começar: **Usar um modelo** e **Nova automação**.

| Situação | O que significa |
| - | - |
| Rascunho | Ainda não foi ativada. Nada dispara. |
| Ativa | Recebe novos disparos e executa os passos. |
| Pausada | Não aceita novos disparos. Execuções em andamento são canceladas quando chega a hora do próximo passo delas. |

## Criar uma automação

Há três caminhos. Em todos, a automação nasce como **Rascunho** e só dispara depois de ativada.

### Usar um modelo

Em **Automações → Usar um modelo**, escolha um modelo e clique em **Usar este modelo**. A OctaSend cria a automação já desenhada e, junto, uma **comunicação nova** com o mesmo nome, com textos em português para e-mail e WhatsApp. Se já existir uma comunicação com o mesmo identificador, a nova ganha um sufixo (`-2`, `-3`...). Você pode editar os textos em [Comunicações](https://docs.octasend.com.br/plataforma/comunicacoes.md).

| Modelo | Como começa | O que faz | Ajuste antes de ativar |
| - | - | - | - |
| Chegou um pedido | Chegou um pedido, em qualquer situação | Busca o conteúdo dos produtos comprados, escreve um texto com IA e envia | Publique o [conteúdo rico](https://docs.octasend.com.br/plataforma/conteudo-rico.md) dos produtos |
| Lembrete de recompra | Segmento: quantidade de pedidos maior que 0 e sem comprar há 30 dias | Texto por IA citando produtos já comprados, e envio | Nenhum obrigatório. Só quem já comprou entra, uma vez por contato (veja [Segmento de contatos](#segmento-de-contatos)) |
| Aniversário do cliente | Data do campo `data_nascimento`, todo ano, no dia | Texto por IA de parabéns, e envio | O contato precisa ter o campo `data_nascimento` preenchido |
| Cliente de alto valor | Segmento: soma de pedidos acima de R\$ 2.000 em 120 dias | Texto por IA de agradecimento, e envio limitado a 1 mensagem a cada 30 dias | Preencha o status de pedido aprovado da sua loja no critério |
| Cliente inativo | Segmento: quantidade de pedidos maior que 0 e 120 dias sem pedido de um status | Convite para voltar a quem já comprou, com envio limitado a 1 mensagem a cada 30 dias | Preencha o status de pedido aprovado no critério |
| Padrão de compra do cliente | Segmento: atrasado no próprio padrão de compra | Lembrete de reposição, com envio limitado a 1 mensagem a cada 30 dias | Preencha o status de pedido aprovado no critério |
| Pedir avaliação após a entrega | Chegou um pedido com a situação `entregue` | Espera 3 dias e envia o link de avaliação | Ative [Avaliações de produtos](https://docs.octasend.com.br/plataforma/avaliacoes-de-produtos.md). Na Wake e nos pedidos importados por planilha, troque `entregue` pela situação de entrega que a sua loja usa. Na Nuvem Shop, a situação usada é a do pagamento, então este modelo não tem como esperar a entrega: use uma situação de pagamento, como a de pago, e ajuste a espera |

> [!NOTE]
>
> Nos modelos que dependem de status, o critério vem com o status em branco. A automação não ativa enquanto ele não for preenchido: o aviso "Há um critério do segmento com preenchimento inválido." aparece no editor.

### Criar com IA

Uma automação nova, ainda vazia, abre com a pergunta **"O que essa automação deve fazer?"**. Descreva em português quando ela começa e o que acontece depois, por exemplo: "Quando um pedido for pago, espere 2 dias e mande o e-mail de agradecimento". Clique em **Montar fluxo** e o desenho aparece no editor.

Depois do primeiro pedido, a conversa continua no painel **Criar com IA** (botão no topo do editor). Peça ajustes na mesma conversa: "coloque uma espera de 2 dias antes do e-mail", "tire a etiqueta VIP".

Regras:

* A descrição precisa ter pelo menos 10 caracteres.
* A IA só usa comunicações que já existem, estão ativas e têm pelo menos um canal ativo. Ela não cria comunicações.
* A IA monta gatilhos de pedido, segmento, data do contato e chamada de API. O gatilho **Evento de uma loja** precisa ser escolhido à mão.
* Cada resposta substitui o desenho inteiro. O editor não tem desfazer: se o desenho já tiver passos, ou se você mexeu nele depois da última resposta da IA, a OctaSend pede confirmação antes.
* O fluxo gerado tem no máximo 40 passos.
* Na tela inicial da conversa você também pode **ditar por voz**, com até 2 minutos por gravação.
* Se o limite de uso de IA da conta tiver sido atingido, a mensagem "O limite de uso de IA foi atingido." aparece e nada é alterado.
* A IA sugere um nome junto com o desenho. Enquanto a automação tiver o nome padrão "Nova automação", o nome sugerido é aplicado sozinho. Depois que você dá outro nome, ele nunca é trocado: a resposta mostra a **Sugestão de nome** com o botão **Usar este nome**.

O que a IA deixar incompleto (uma comunicação em branco, por exemplo) aparece na caixa **Ajuste antes de ativar**, como em qualquer automação montada à mão.

### Montar à mão

Clique em **Nova automação** e escolha **Prefiro montar à mão**.

**1. Adicione os passos**

Use a coluna **Passos**, à esquerda. Cada clique adiciona o passo abaixo do último e já abre a configuração dele.

**2. Ligue os passos**

Arraste da saída de um passo (embaixo) até a entrada do próximo (em cima). Passos com duas saídas mostram o nome de cada uma: "sim" e "não", "A" e "B", "evento" e "esgotado", "continua" e "sem conteúdo".

**3. Configure cada passo**

Clique no passo para abrir o painel **Configurar passo**. Campos obrigatórios em branco ficam marcados com "Campo obrigatório".

**4. Ative**

Quando a caixa **Ajuste antes de ativar** sumir, clique em **Ativar automação**.

Para remover um passo, use **Remover este passo** no painel, a tecla Delete (ou Backspace) ou o menu do botão direito, que também tem **Duplicar**. O botão **Remover este passo** e o menu do botão direito não aparecem para o passo **Início**. Se ele for apagado pelo teclado, adicione-o de novo pela coluna **Passos** e ligue-o outra vez ao primeiro passo: a automação só ativa com exatamente um Início. O rascunho é salvo sozinho cerca de um segundo depois de cada alteração.

## Gatilhos

O gatilho é configurado no passo **Início**, no campo **Como este fluxo começa**.

| Gatilho | Quando dispara | Quantas vezes a mesma pessoa entra |
| - | - | - |
| Chegou um pedido | Quando um pedido chega, ou quando atinge a situação escolhida | Uma vez por pedido |
| Evento de uma integração (antes, "Evento de uma loja") | Quando a integração conectada envia o evento escolhido | Uma vez por evento de cada pedido ou cliente |
| Uma dúvida de produto foi respondida | Quando você publica a primeira resposta de uma [dúvida de produto](https://docs.octasend.com.br/plataforma/duvidas-de-produto.md) | Uma vez por pergunta |
| Segmento de contatos | Na varredura agendada, para quem atende a todos os critérios | Uma vez por versão publicada da automação |
| Data de um campo do contato | Na varredura agendada, quando a data do contato bate com a regra | Uma vez por ano (Anual) ou uma única vez (Uma vez) |
| Chamada de API | Quando o seu sistema chama a API com o identificador do gatilho | A cada chamada, ou uma vez por `idempotency_key` |

Quando a execução tem e-mail ou telefone do destinatário, ela é associada a um contato da sua base, localizado por esses dados e criado se ainda não existir. Nos gatilhos por segmento e por data, o contato já é o da própria base. Veja [Contatos](https://docs.octasend.com.br/plataforma/contatos.md).

### Chegou um pedido

Dispara para pedidos das integrações conectadas (como Nuvem Shop, Wake, Yampi, Shopify, Tray, Olist Ecommerce, Linx Commerce, Bling e Conta Azul) e, se você marcar a opção, para pedidos importados por planilha.

* **Origem do pedido** (opcional): por padrão vale **Qualquer origem**. Escolha uma integração conectada quando a mesma venda chega por mais de um caminho, como loja virtual e Bling, e a automação deve disparar só por um deles. Se a integração salva deixar de estar conectada, o campo avisa: "Esta integração não está conectada. Escolha outra origem ou Qualquer origem."
* **Pedido anterior à conexão não dispara.** Quando você conecta uma integração nova, os pedidos criados **antes do dia da conexão** nunca disparam automações de pedido, o que evita mensagens sobre compras antigas. Pedidos feitos a partir do dia da conexão seguem disparando normalmente. A importação por planilha continua com a escolha da caixa **Disparar automações com gatilho "Chegou um pedido"**.
* **Situação do pedido** (opcional): o campo sugere as situações que já apareceram nos seus pedidos. Em branco, a automação dispara uma vez por pedido, na primeira vez que ele é visto, e não a cada mudança de situação. Preenchida, dispara uma vez por pedido quando ele atinge aquela situação. A comparação ignora maiúsculas, minúsculas e espaços nas pontas.
* Na Nuvem Shop, a situação usada é a situação do **pagamento** do pedido. Na Wake, é o nome da situação do pedido na loja.
* Além dos avisos em tempo real da loja, a OctaSend revisa periodicamente os pedidos recentes das lojas conectadas. Um pedido cujo aviso se perdeu ainda dispara, e um pedido que já disparou não dispara de novo.
* Na Nuvem Shop, o aviso em tempo real de um pedido só chega para os eventos de pedido que estão ativos no mapeamento de eventos da integração. Sem nenhum evento de pedido ativo, o pedido dispara pela revisão periódica, que roda a cada 30 minutos, e pode levar até meia hora.
* Na importação de pedidos por planilha (**E-commerce → Pedidos → Importar pedidos**), a opção **Disparar automações com gatilho "Chegou um pedido"** vem desmarcada. Marcada, só os pedidos novos daquela planilha disparam; pedidos já importados antes nunca disparam de novo. A opção não controla as automações por segmento: elas avaliam a base inteira no agendamento de cada uma (de hora em hora, a cada 6 horas ou 1x por dia) e podem alcançar os pedidos importados na próxima varredura. A tela de importação lista as automações de segmento ativas antes de você confirmar; pause as que não devem enxergar a carga.
* Duas automações diferentes podem disparar para o mesmo pedido: por exemplo, uma para qualquer pedido e outra para pedidos pagos.

### Evento de uma loja

Na tela, este gatilho aparece como **Evento de uma integração**: ele serve também para ERPs e sistemas financeiros, como Bling, Asaas e Conta Azul.

Escolha a **Loja** (só lojas conectadas aparecem) e o **Evento**. A automação dispara uma vez para cada combinação de evento e pedido ou cliente: o mesmo evento repetido para o mesmo pedido não dispara de novo. O evento precisa trazer e-mail ou telefone do cliente, senão nenhuma execução começa.

A lista de eventos mostra só os que conseguem iniciar uma automação. Não aparecem:

* os eventos de produto da Nuvem Shop (**Produto criado**, **Produto atualizado** e **Produto removido**), que não têm cliente a quem enviar. Eles continuam disponíveis no passo **Aguardar evento**;
* o **Carrinho abandonado** da Wake, que é enviado só pela comunicação mapeada para esse evento na integração da loja.

As variáveis disponíveis são as mesmas do mapeamento de eventos da integração. Veja a lista em [Nuvem Shop](https://docs.octasend.com.br/integracoes/nuvemshop.md).

Na Nuvem Shop, a loja só envia à OctaSend os eventos assinados. A automação não depende do mapeamento de eventos da integração: ao ativar, publicar alterações ou reativar uma automação que usa **Evento de uma loja** ou **Aguardar evento**, a OctaSend pede à loja que passe a enviar esse evento. Se a loja recusar, a automação fica ativa e o painel avisa ("A automação está ativa, mas a loja não confirmou o envio do evento: … Depois de resolver, publique de novo."). Resolva o motivo indicado e publique de novo para tentar outra vez.

> [!WARNING]
>
> Um evento que também tem comunicação ativa no mapeamento de eventos da integração dispara a comunicação do mapeamento **e** as automações desse evento: o cliente recebe as duas mensagens. Para automações baseadas em pedido, prefira o gatilho **Chegou um pedido**.

### Segmento de contatos

O contato entra quando atende a **todos** os critérios. Clique em **Adicionar critério** para cada regra e em **Ver quantos contatos** para saber quantos atendem aos critérios hoje.

| Critério | Quem atende |
| - | - |
| Situação do pedido | Tem pelo menos um pedido com essa situação |
| Valor do pedido | Tem pelo menos um pedido com valor maior (ou menor) que o informado |
| Quantidade de pedidos | O total de pedidos, em qualquer situação, é maior (ou menor) que o informado |
| Sem comprar há (dias) | Não tem pedido nos últimos N dias, incluindo quem nunca comprou |
| Marcação do contato | O contato tem a marcação (tag) informada |
| Campo do cadastro | Um campo do cadastro do contato tem exatamente o valor informado |
| Comprou o produto | Já comprou o produto com o identificador informado |
| Soma de pedidos por status (dias) | A soma dos pedidos com o status informado, nos últimos N dias, é maior (ou menor) que o valor em R\$ |
| Sem pedido de um status há (dias) | Já fez algum pedido na loja e não tem pedido com o status informado nos últimos N dias |
| Atrasado no padrão de compra (margem em dias) | Tem pelo menos 3 pedidos com o status informado, e o tempo desde o último já passou da média entre as compras dele somada à margem |

Regras do segmento:

* Só contatos ativos entram.
* Os critérios de pedido consideram os pedidos do cliente da loja com o **mesmo e-mail** do contato.
* Os campos de status comparam o texto exato da situação. Use as sugestões do campo, que listam as situações já registradas nos seus pedidos.
* Cada contato entra **uma única vez por versão publicada**, mesmo que saia do segmento e volte depois.
* Publicar uma alteração no desenho cria uma versão nova: todos os contatos que atendem ao segmento entram de novo, inclusive quem já passou pela automação. A OctaSend pede confirmação antes. Publicar sem ter mudado nada reaproveita a versão atual e não faz ninguém entrar de novo.
* Cada automação inicia no máximo 500 execuções novas por varredura. Quem sobrar entra nas varreduras seguintes.

> [!TIP]
>
> **Sem comprar há (dias)** também inclui contatos sem nenhum pedido. Para falar só com quem já comprou, acrescente o critério **Quantidade de pedidos** maior que 0. **Sem pedido de um status há (dias)** só alcança contatos que **já fizeram algum pedido**: quem nunca comprou fica de fora, inclusive nas automações já ativas. Quem comprou apenas com outro status entra.

### Data de um campo do contato

Dispara com base numa data guardada no cadastro do contato, como aniversário ou vencimento de assinatura.

* **Campo do contato:** o nome da informação no cadastro, por exemplo `aniversario`. O valor precisa estar no formato `AAAA-MM-DD` (ex.: `1990-05-17`); outros formatos são ignorados.
* **Recorrência:** **Anual** compara só dia e mês e dispara uma vez por ano. **Uma vez** compara a data completa e dispara uma única vez.
* **Quantidade de dias** e **Quando** (**Antes**, **No dia** ou **Depois**): para avisar alguns dias antes ou depois da data, até 365 dias.
* Só contatos ativos entram.

### Agendamento de segmento e data

Automações por segmento e por data de contato não disparam na hora: elas fazem varreduras agendadas. Com a automação ativa, o topo do editor mostra:

* **Frequência:** **De hora em hora**, **A cada 6 horas** ou **1x por dia** (padrão).
* **Horário:** só para **1x por dia**, no horário de Brasília. O padrão é 04:00.
* **Rodar agora:** faz a varredura na hora, sem esperar o horário. A OctaSend informa quantos contatos entraram, ou "Nenhum contato bateu no critério agora.". Se a varredura não terminar em cerca de 40 segundos, o restante fica para uma próxima rodada.

A OctaSend verifica as automações agendadas a cada 30 minutos, então uma varredura pode começar até meia hora depois do horário escolhido. Uma automação recém-ativada entra na próxima verificação. Ao trocar a frequência ou o horário, ela também roda na próxima verificação e depois segue a agenda nova.

### Chamada de API

Defina o **Identificador do gatilho** (por exemplo, `cadastro-concluido`). O seu sistema dispara a automação com a mesma autenticação do envio de mensagens (veja [Autenticação](https://docs.octasend.com.br/api-reference/autenticacao.md)):

```http theme={null}
POST /functions/v1/flow-trigger
Authorization: Bearer at_f4a92b...
Content-Type: application/json

{
  "trigger_slug": "cadastro-concluido",
  "recipient": {
    "email": "usuario@exemplo.com",
    "phone": "+5511999990000"
  },
  "variables": {
    "cliente_nome": "Ana",
    "plano": "Pro"
  },
  "idempotency_key": "cadastro-12345"
}
```

| Campo | Obrigatório | Descrição |
| - | - | - |
| `trigger_slug` | Sim | O identificador configurado no passo Início |
| `recipient` | Sim | Pelo menos um de: `email`, `phone`, `user_id`, `telegram_chat_id`, `slack_user_id`, `slack_channel`, `fcm_token` |
| `variables` | Não | Dados da execução. Viram variáveis das mensagens e podem ser usados no passo **Se** |
| `idempotency_key` | Não | Com a mesma chave, cada automação dispara uma única vez. Sem ela, cada chamada inicia uma execução nova |

Todas as automações ativas com o mesmo identificador disparam juntas. A resposta informa quantas execuções começaram e quantas foram descartadas por repetição:

```json theme={null}
{ "started": 1, "duplicated": 0 }
```

| HTTP | Quando |
| - | - |
| 400 | `trigger_slug` ausente, ou `recipient` sem nenhum identificador |
| 401 | Token ausente, inválido, vencido ou revogado |
| 404 | Nenhuma automação ativa com esse identificador |
| 429 | Limite de chamadas por minuto atingido (`rate_limited`, com `retry_after` em segundos). O limite é o mesmo da API de envio de mensagens |

> [!TIP]
>
> Envie `cliente_nome` e `pedido_numero` em `variables` para que as colunas **Cliente** e **Pedido** apareçam preenchidas na tela de execuções.

### Uma dúvida de produto foi respondida

Dispara quando você publica a **primeira resposta** de uma pergunta feita por um cliente identificado na página do produto. Editar a resposta depois não dispara de novo. Não há campos de configuração.

| Variável | O que traz |
| - | - |
| `{{pergunta}}` | O que o cliente perguntou |
| `{{resposta}}` | A sua resposta |
| `{{nome_produto}}` | O nome do produto |
| `{{link_produto}}` | O link da página do produto |
| `{{cliente_nome}}` | O primeiro nome de quem perguntou |

As mensagens deste gatilho são de serviço (transacionais), como as de pedido. Ao ligar as Dúvidas na conta, a OctaSend cria sozinha a comunicação e a automação **Dúvida respondida**. Veja [Dúvidas de produtos](https://docs.octasend.com.br/plataforma/duvidas-de-produto.md).

## Passos

| Passo | O que faz | Saídas |
| - | - | - |
| Enviar | Envia uma comunicação ao destinatário da execução | Uma |
| Esperar | Pausa a execução por um tempo | Uma |
| Se | Verifica um dado da execução | sim / não |
| Aguardar evento | Espera um evento da loja, com prazo | evento / esgotado |
| Marcar contato | Adiciona uma marcação (tag) ao contato | Uma |
| Atualizar contato | Grava um valor num campo do cadastro do contato | Uma |
| Chamar webhook | Chama uma URL do seu sistema | Uma |
| Dividir A/B | Sorteia o caminho A ou B | A / B |
| Conteúdo do produto | Prepara o conteúdo rico dos produtos para as mensagens | continua / sem conteúdo |
| Texto por IA | Escreve um texto com IA a partir do conteúdo dos produtos | Uma |

Uma saída sem ligação encerra a execução ali, como **Concluída**.

### Enviar

* **Comunicação:** só aparecem comunicações ativas.
* **Canais:** lista só os canais que você configurou e deixou **ativos**, para a comunicação escolhida. Um canal que já estava marcado e foi desativado depois continua visível como "(inativo)" e pode ser desmarcado. Sem nenhum marcado, vale o padrão configurado na comunicação.
* **Limitar quantas vezes este contato recebe mensagens de automação:** defina **Quantidade máxima** e **Período em dias** (os dois a partir de 1). A conta considera os envios bem-sucedidos de **todas** as automações para aquele contato no período. Se o limite já foi atingido, o envio é ignorado e a execução segue. O limite só vale quando a execução tem um contato identificado.

A automação não ativa se a comunicação escolhida estiver desativada, não tiver nenhum canal ativo ou tiver sido apagada. Uma comunicação usada por uma automação ativa não pode ser excluída. O **slug** pode ser trocado: a troca reescreve o identificador em todas as automações da conta (rascunho e versão publicada) e o diálogo lista as automações que serão atualizadas. Integrações externas que chamam a API pelo slug antigo deixam de funcionar até usarem o novo. Se a automação estiver pausada ou em rascunho, a exclusão pede confirmação com aviso. Se a comunicação for desativada depois que a automação foi ativada, o passo **Enviar** falha e a execução segue para o próximo passo. Veja [Comunicações](https://docs.octasend.com.br/plataforma/comunicacoes.md).

O envio usa sempre a versão **publicada** da comunicação em cada canal. Um rascunho salvo no editor de template não vai para as automações.

Um envio que falha **não** interrompe a execução: o passo fica registrado como "falhou" e a automação segue para o próximo passo. Se uma execução for retomada depois de uma falha temporária, a OctaSend confere se aquele envio já aconteceu e não manda a mensagem de novo.

Nas automações por segmento e por data, o destinatário é o e-mail e o telefone do cadastro do contato.

Regras de envio:

* **Marketing ou transacional:** o gatilho define o tipo das mensagens da automação. Com **Segmento de contatos**, **Data de um campo do contato** ou **Chamada de API**, as mensagens são de marketing. Com **Chegou um pedido**, **Evento de uma loja** ou **Uma dúvida de produto foi respondida**, são transacionais: falam de um pedido, da conta ou da pergunta do próprio cliente. Uma exceção: o evento de checkout abandonado da Shopify é tratado como marketing (respeita o descadastro e leva o link de descadastro).
* **Descadastro:** só vale para as automações de marketing. Nelas, um contato descadastrado do E-mail, do WhatsApp ou do SMS não recebe a mensagem nesse canal: o envio é pulado, aparece em [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md) como **Ignorada**, com o motivo "Contato descadastrado", e a execução segue. As automações transacionais enviam normalmente, mesmo para quem se descadastrou. Veja [Contatos](https://docs.octasend.com.br/plataforma/contatos.md).
* **Link de descadastro:** os e-mails das automações de marketing levam no rodapé a linha "Não quer mais receber estes e-mails? Descadastre-se", em português, inglês ou espanhol, conforme o idioma do e-mail (os demais idiomas recebem o texto em português). Pelo SendGrid e pelo SMTP, levam também o cabeçalho de descadastro em um clique (`List-Unsubscribe`). Os e-mails das automações transacionais saem sem essa linha e sem o cabeçalho.
* **Limite diário:** em todas as automações, cada envio a um canal conta no **Limite diário de mensagens** da conta (veja [Configurações](https://docs.octasend.com.br/plataforma/configuracoes.md)). Acima do limite, o envio falha com o motivo "Limite diário de mensagens atingido" e a execução segue para o próximo passo.

### Esperar

Defina **Tempo** (maior que zero) e **Unidade** (**Minutos**, **Horas** ou **Dias**). O tempo é contado de forma corrida: 1 dia são 24 horas a partir do momento em que a execução chegou ao passo. Os passos são processados em ciclos de cerca de um minuto.

### Se

* **Campo:** o nome exato da variável, sem chaves e sem pontos (ex.: `pedido_status`, `pedido_total`).
* **Comparação:** **é igual a**, **é diferente de**, **é maior que**, **é menor que**, **contém** ou **está preenchido**.
* **Tipo do valor:** para "é igual a" e "é diferente de", escolha **Texto** ou **Número**.
* **Valor:** não aparece em "está preenchido".

Como a condição é avaliada:

* Os dados são os do momento em que a execução começou (as variáveis do gatilho). O passo não consulta a loja de novo e não enxerga as variáveis `{{produto.conteudo.*}}` criadas pelos passos **Conteúdo do produto** e **Texto por IA**.
* Se o campo não existir na execução, a condição segue por **não**, inclusive em "é diferente de".
* "é maior que" e "é menor que" aceitam números que chegam como texto (a loja envia `pedido_total` como texto, por exemplo).
* "é igual a" e "é diferente de" comparam o valor e o tipo exatamente. Para valores numéricos vindos da loja, prefira "é maior que" e "é menor que".
* "contém" procura um texto dentro de outro texto, ou um item dentro de uma lista.

### Aguardar evento

Escolha o **Evento** (agrupado por loja conectada), o **Prazo** e a **Unidade**. Se o evento chegar antes do prazo, a execução segue pela saída **evento**; se o prazo acabar, segue por **esgotado**. O **Carrinho abandonado** da Wake não aparece na lista, porque só é enviado pelo mapeamento de eventos da integração.

Quem libera a espera:

* **Eventos de pedido e de cliente**: só o evento do mesmo cliente da execução. A OctaSend compara o e-mail (sem diferenciar maiúsculas) ou o telefone (só os dígitos) do evento com os da execução; basta um dos dois bater. Um evento de outro cliente não libera a espera, e um evento sem e-mail nem telefone não libera ninguém: a execução segue até o prazo.
* **Eventos de produto da Nuvem Shop** (**Produto criado**, **Produto atualizado** e **Produto removido**): não têm cliente, então o evento libera todas as execuções que esperam por ele.

Na Nuvem Shop, a loja passa a enviar o evento quando a automação é ativada ou publicada, como descrito em [Evento de uma loja](#evento-de-uma-loja).

### Marcar contato e Atualizar contato

* **Marcar contato:** adiciona a **Tag** informada ao contato da execução.
* **Atualizar contato:** grava o **Valor** no **Campo** informado do cadastro do contato. O campo pode ser usado depois em segmentos e gatilhos por data.

Se a execução não tiver um contato identificado, os dois passos são ignorados e a execução segue.

### Chamar webhook

Informe a **URL** (começando com `http://` ou `https://`) e o **Método** (**POST** ou **GET**).

* Em **POST**, o corpo é um JSON com `recipient` (destinatário) e `context` (os dados da execução).
* Cada tentativa espera até 10 segundos. Se o seu servidor responder com erro 5xx ou não responder, a OctaSend tenta de novo, com até 3 tentativas no total. Um erro 4xx não é repetido.
* O resultado não muda o caminho: a execução segue para o próximo passo, com o passo registrado como sucesso ou falha.

### Dividir A/B

Defina a **Porcentagem para o caminho A**, de 0 a 100. Cada execução é sorteada: a porcentagem informada segue por A e o restante por B.

### Conteúdo do produto

Coloca o [conteúdo rico](https://docs.octasend.com.br/plataforma/conteudo-rico.md) do produto na mensagem, adaptado a cada canal. Em **De onde vem o produto**:

| Origem | Quando usar |
| - | - |
| Do contexto da automação | Quando a execução traz a variável `produto_id` com o identificador ou SKU do produto, por exemplo enviada em `variables` numa [Chamada de API](#chamada-de-api). Os eventos de produto da Nuvem Shop não iniciam automações, e a Wake não informa qual produto disparou o evento |
| Produto fixo | Sempre o mesmo produto, pelo **Identificador ou SKU do produto**. Funciona com qualquer gatilho |
| Produtos deste pedido | Todos os produtos comprados. Só com o gatilho **Chegou um pedido** |

Depois do passo, as mensagens podem usar:

| Variável | Conteúdo |
| - | - |
| `{{produto.conteudo.html}}` | Conteúdo para e-mail |
| `{{produto.conteudo.whatsapp_texto}}` | Texto para WhatsApp, cortado em 3.800 caracteres com a marca "\[…continua]" |
| `{{produto.conteudo.push_texto}}` | Texto curto para push |

Só entram na mensagem os blocos publicados com o **Conteúdo IA** ligado. Um produto cujo conteúdo está publicado só para a página da loja conta como produto sem conteúdo.

Regras de **Produtos deste pedido**:

* Produtos sem conteúdo são ignorados, e a tela de execuções mostra os códigos deles. Se nenhum produto do pedido tiver conteúdo, a execução segue pela saída **sem conteúdo**. Sem nada ligado nessa saída, a automação para ali e nada é enviado.
* São usados até 50 produtos diferentes por pedido. A notificação push leva só o primeiro produto.

Nas outras origens, a falta de conteúdo não interrompe: a execução segue pela saída **continua**, com as variáveis vazias, e a tela de execuções explica o motivo.

### Texto por IA

Escreve um texto com IA e o grava na variável `{{produto.conteudo.ia}}`. Use essa variável no modelo de e-mail ou de WhatsApp da comunicação; sem ela, a mensagem sai como sempre e o texto da IA não aparece.

* **Instrução para a IA** (obrigatória): orienta tom e ênfase. Ela não autoriza a IA a afirmar o que não está cadastrado.
* **Tom de voz:** **Padrão da conta** usa o tom definido na Base de Conhecimento; sem tom definido, vale o Formal. Você pode escolher outro tom só para este passo.
* A IA usa apenas o conteúdo dos produtos (preparado por um passo **Conteúdo do produto** antes dela), os dados do pedido (nome do cliente, número, itens e total) e, em automações por segmento e por data, até 5 produtos que o cliente comprou mais recentemente. Ela não inventa prazo, preço, troca, garantia, desconto ou disponibilidade.
* Se as **Instruções da empresa** estiverem preenchidas (menu **Chatbot Site**, aba **System Prompt**; veja [Chatbot do site](https://docs.octasend.com.br/plataforma/chatbot-do-site.md)), a IA também as segue.
* Se a IA não responder em 20 segundos, falhar, devolver texto vazio ou o limite de uso de IA da conta tiver sido atingido, a mensagem sai com o texto do produto sem IA. A tela de execuções mostra o motivo.

## Variáveis nas mensagens

As variáveis disponíveis nas comunicações enviadas por uma automação dependem do gatilho.

| Gatilho | Variáveis |
| - | - |
| Chegou um pedido | `{{pedido_id}}`, `{{pedido_numero}}`, `{{pedido_total}}`, `{{pedido_moeda}}`, `{{pedido_status}}`, `{{pedido_data}}`, `{{pedido_itens}}`, `{{cliente_nome}}`, `{{cliente_email}}`, `{{cliente_telefone}}`, `{{loja_origem}}`, `{{link_avaliacao}}` |
| Evento de uma loja | As variáveis do evento, as mesmas do mapeamento da integração |
| Segmento de contatos e Data de um campo do contato | `{{cliente_nome}}` e os campos do cadastro do contato, pelo nome (ex.: `{{data_nascimento}}`). Para um contato **Sem nome**, `{{cliente_nome}}` fica vazio |
| Chamada de API | As chaves enviadas em `variables` |
| Uma dúvida de produto foi respondida | `{{pergunta}}`, `{{resposta}}`, `{{nome_produto}}`, `{{link_produto}}`, `{{cliente_nome}}` |

Detalhes do gatilho **Chegou um pedido**:

* `{{pedido_numero}}` é o número que o cliente vê; quando a loja não informa número, vem o identificador do pedido.
* `{{pedido_itens}}` traz um item por linha, no formato `2x Camiseta Preta`.
* `{{loja_origem}}` indica de onde veio o pedido: a integração de origem (por exemplo, `nuvemshop`, `wake`, `shopify` ou `yampi`) ou `manual` (importado por planilha).
* `{{link_avaliacao}}` é o link para o cliente avaliar os produtos. Ele só é gerado quando o módulo [Avaliações de produtos](https://docs.octasend.com.br/plataforma/avaliacoes-de-produtos.md) está ativo, e sai preenchido em qualquer automação do mesmo pedido: se o pedido já recebeu um link que ainda vale (não usado e não vencido), as automações seguintes, disparadas por outro evento do pedido, repetem esse link; se não, um link novo é gerado. Com o módulo desligado, a variável fica vazia.

> [!WARNING]
>
> Uma variável que não existe na execução aparece na mensagem como texto literal, por exemplo `{{pedido_numero}}` numa automação por segmento. A exceção são as variáveis `{{produto.conteudo.*}}`, que ficam vazias. Use só as variáveis que o gatilho fornece.

## Ativar, publicar e pausar

### Ajuste antes de ativar

Enquanto o desenho tiver algum problema, a caixa **Ajuste antes de ativar** lista o que corrigir e o botão de ativar fica desabilitado. Os avisos mais comuns:

| Aviso | O que fazer |
| - | - |
| O fluxo precisa ter exatamente um ponto de partida. | Deixe um único passo Início |
| Este passo não está conectado ao restante do fluxo. | Ligue o passo a partir do Início, ou remova-o |
| Este passo tem mais de um caminho saindo do mesmo ponto. | Cada saída pode ter só uma seta |
| O fluxo volta para um passo anterior e nunca termina. | Remova a seta que volta para trás |
| Escolha a comunicação que será enviada. | Selecione a comunicação no passo Enviar |
| A comunicação "…" está desativada. / não tem nenhum canal ativo. | Ative a comunicação ou um canal dela em [Comunicações](https://docs.octasend.com.br/plataforma/comunicacoes.md) |
| Usar os produtos do pedido exige que o fluxo comece pelo gatilho "Chegou um pedido". | Troque o gatilho ou a origem do produto |
| Há um critério do segmento com preenchimento inválido. | Complete os campos do critério, como o status |

### Ativar e publicar

* **Ativar automação** publica o rascunho e liga a automação.
* Com a automação ativa, o botão vira **Publicar alterações**: as mudanças do rascunho só passam a valer depois dele. Execuções já em andamento continuam na versão anterior.

### Pausar e reativar

Pause pelo botão **Pausar** da lista ou pela chave ao lado do nome, no editor.

* Enquanto pausada, a automação não aceita novos disparos e as varreduras agendadas não rodam.
* Uma execução em andamento é cancelada quando chega a hora do próximo passo dela com a automação pausada. Ela aparece como **Cancelada**, com a mensagem "A automação foi pausada ou excluída enquanto esta execução estava em andamento.", e não é retomada ao reativar.
* A chave e o botão **Ativar** da lista religam a última versão publicada. Para colocar no ar alterações do rascunho, use **Ativar automação** no editor.
* Ao reativar uma automação que usa **Evento de uma loja** ou **Aguardar evento**, a OctaSend pede de novo à loja que envie o evento. Se a loja recusar, o painel mostra o mesmo aviso da publicação.

### Renomear e excluir

* **Renomear:** use o lápis na linha da lista ou ao lado do nome, no editor. O nome aparece na lista e no editor e não muda o que a automação faz. Ele não pode ficar vazio.
* **Excluir:** use a lixeira na linha da lista ou no topo do editor e confirme em **Excluir automação?**. A automação sai da lista e para de disparar. Se ela já foi ativada alguma vez, o painel avisa que as execuções em andamento são encerradas: quem está no meio dela deixa de receber os próximos passos, e essas execuções aparecem como **Canceladas**.

A exclusão não apaga o histórico: as execuções e as mensagens já enviadas continuam nos relatórios, nos [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md) e no [Dashboard](https://docs.octasend.com.br/plataforma/dashboard.md). Quem abre uma automação excluída por um link salvo vê "Esta automação foi excluída", com os botões **Ver execuções** e **Voltar para automações**. Uma automação excluída não pode ser editada nem ativada de novo.

## Execuções

Abra pelo botão **Ver execuções** do editor ou pelo ícone de histórico na lista. A tela mostra as 200 execuções mais recentes da automação:

| Coluna | Conteúdo |
| - | - |
| Situação | Em andamento, Concluída, Falhou ou Cancelada |
| Pedido | Número do pedido, quando a execução começou por um pedido ou evento de pedido |
| Cliente | Nome de quem disparou a execução |
| Início | Quando a execução começou |
| Fim | Quando terminou |

As colunas Pedido e Cliente mostram "—" quando a execução não tem essa informação, como num segmento sem pedido.

| Situação | O que significa |
| - | - |
| Em andamento | A execução ainda tem passos a fazer, inclusive esperas |
| Concluída | Chegou ao fim do caminho |
| Falhou | Foi interrompida por um problema; o motivo aparece nos passos |
| Cancelada | A automação estava pausada ou tinha sido excluída quando chegou a hora do próximo passo |

Clique numa execução para abrir **Passos da execução**: cada passo aparece com o nome, o resultado (**concluído com sucesso**, **ignorado** ou **falhou**), o horário e uma explicação. Os nomes dos passos são **Início**, **Espera**, **Condição**, **Envio**, **Aguardar evento**, **Marcar contato**, **Atualizar contato**, **Chamar webhook**, **Dividir A/B**, **Conteúdo do produto** e **Texto por IA**. Alguns exemplos de explicação:

| Passo | Explicação |
| - | - |
| Envio ignorado | "Nenhum canal ativo era compatível com os dados deste destinatário." |
| Envio ignorado | "Os canais deste envio não tinham modelo de mensagem para este destinatário." |
| Envio ignorado | "Limite de 1 mensagem(ns) em 30 dia(s) já atingido para este contato." |
| Envio ignorado | "O contato se descadastrou deste canal, então a mensagem não foi enviada." |
| Envio com falha | "O canal recusou esta mensagem. A automação seguiu para o próximo passo." |
| Envio com falha | "A conta atingiu o limite diário de envios, então esta mensagem não foi enviada." |
| Envio com falha | "Nenhum canal conseguiu entregar esta mensagem." |
| Condição | O campo avaliado e o ramo tomado (verdadeiro ou falso) |
| Dividir A/B | O ramo sorteado |
| Conteúdo do produto | Quantos produtos tinham conteúdo e quais estavam sem |
| Texto por IA | Se o texto foi escrito pela IA ou por que saiu sem IA |

### Quando uma execução é interrompida

| Motivo | O que acontece |
| - | - |
| Falha temporária (rede, envio indisponível) | A OctaSend tenta de novo com intervalos crescentes, por 8 tentativas (cerca de 2 horas). Se todas falharem, a execução termina como Falhou |
| Mais de 50 passos numa execução | A execução é interrompida. Revise o desenho |
| Desenho com problema na versão publicada | A execução é interrompida. Corrija no editor e publique de novo |
| Passo que o sistema não reconhece | A automação não é executada; tente de novo em alguns minutos |
| Automação pausada ou excluída | A execução é cancelada no próximo passo |

## Acompanhar os resultados

* **Dashboard:** a seção **Automações** mostra Total de execuções, Concluídas, Falharam, Em andamento, o gráfico **Execuções por dia** e as **Últimas execuções** de todas as automações, no período escolhido no topo. Veja [Dashboard](https://docs.octasend.com.br/plataforma/dashboard.md).
* **Logs:** em **Comunicações → Logs**, a aba **Automações** lista as mensagens enviadas pelas automações. Veja [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md).
* **Tags:** toda mensagem enviada por automação leva como tag o e-mail do destinatário e, nas automações com o gatilho **Chegou um pedido**, o identificador do pedido na loja. Assim você filtra os envios de um cliente ou pedido pela [API de consulta de logs](https://docs.octasend.com.br/api-reference/consultar-logs.md) e acompanha a jornada em [Fluxo](https://docs.octasend.com.br/plataforma/fluxos.md).

## Automações e outras funcionalidades

* **Fluxo** (**Comunicações → Fluxo**) só mostra a linha do tempo das mensagens enviadas com uma tag. Ele não envia nada. As automações são o que dispara as mensagens.
* **Mapeamento de eventos da integração** ([Nuvem Shop](https://docs.octasend.com.br/integracoes/nuvemshop.md)) envia uma comunicação por evento, sem passos. Ele funciona de forma independente das automações: se um evento tiver comunicação mapeada e também uma automação, as duas saem.
* **Campanhas** ([Campanhas](https://docs.octasend.com.br/plataforma/campanhas.md)) são envios em massa, feitos uma vez. Automações disparam para cada pessoa no momento certo, continuamente.

## Limites

| Item | Limite |
| - | - |
| Execuções exibidas na tela de execuções | As 200 mais recentes |
| Passos por execução | 50 |
| Novas execuções por automação de segmento, por varredura | 500 |
| Deslocamento no gatilho por data | Até 365 dias antes ou depois |
| Rodar agora | Cerca de 40 segundos por clique |
| Produtos por passo Conteúdo do produto (origem pedido) | 50 produtos diferentes |
| Texto de WhatsApp do conteúdo do produto | 3.800 caracteres |
| Resposta da IA no passo Texto por IA | 20 segundos |
| Descrição no Criar com IA | Mínimo de 10 caracteres |
| Passos gerados pelo Criar com IA | 40 |
| Ditado por voz | 2 minutos por gravação |
| Chamar webhook | 10 segundos por tentativa, até 3 tentativas |
| Novas tentativas em falha temporária | 8, ao longo de cerca de 2 horas |

> [card] [Comunicações](https://docs.octasend.com.br/plataforma/comunicacoes.md)
>
> Crie as mensagens que as automações enviam

> [card] [Conteúdo rico](https://docs.octasend.com.br/plataforma/conteudo-rico.md)
>
> Cadastre o conteúdo dos produtos usado nas mensagens

> [card] [Nuvem Shop](https://docs.octasend.com.br/integracoes/nuvemshop.md)
>
> Conecte a loja e veja as variáveis dos eventos

> [card] [Autenticação da API](https://docs.octasend.com.br/api-reference/autenticacao.md)
>
> Gere o token para disparar automações pela API


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.