> ## 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.

# Fluxo de comunicações

> Veja numa linha do tempo todas as mensagens enviadas com a mesma tag

A tela **Fluxo** mostra os envios da sua conta agrupados por **tag**, em ordem cronológica. Você escolhe uma tag e vê, num diagrama, cada mensagem enviada com ela: qual comunicação saiu, por qual canal, quando e se deu certo.

Serve para acompanhar uma jornada de ponta a ponta: tudo o que um cliente recebeu desde o cadastro, todas as mensagens de um pedido ou todos os envios de uma ação de marketing.

Fica em **Comunicações → Fluxo** e está disponível para todos os usuários do painel.

> [!NOTE]
>
> O Fluxo é só de consulta: ele não envia nem agenda mensagens. Para montar jornadas que disparam mensagens sozinhas, com gatilho, esperas e condições, use [Automações](https://docs.octasend.com.br/plataforma/automacoes.md).

## Como uma mensagem entra no fluxo

Uma mensagem aparece no Fluxo quando é enviada com pelo menos uma tag. Isso acontece de dois jeitos.

### Pela API

Informe o campo `tag` na chamada de [Enviar mensagens](https://docs.octasend.com.br/api-reference/enviar-mensagens.md). Ele aceita um valor único (`"onboarding"`) ou uma lista (`["onboarding", "cliente-123"]`):

```json theme={null}
{
  "communication_slug": "boas-vindas",
  "recipient": { "email": "cliente@exemplo.com" },
  "tag": ["onboarding"]
}
```

No envio em lote, a tag vai dentro de cada item de `messages`.

Regras das tags:

* Espaços no começo e no fim de cada tag são removidos, e valores vazios são descartados. Um envio sem nenhuma tag válida não aparece no Fluxo.
* Uma mensagem com várias tags aparece na linha do tempo de cada uma delas.
* As tags são comparadas exatamente como foram enviadas: `Onboarding` e `onboarding` viram fluxos diferentes.
* Um envio que sai por mais de um canal gera um registro por canal, então aparece como um card para cada canal.

### Pelas automações

As mensagens enviadas por uma [automação](https://docs.octasend.com.br/plataforma/automacoes.md) recebem automaticamente as tags abaixo, quando esses dados existem:

* o **e-mail do destinatário**, quando ele é conhecido;
* o **identificador do pedido** na plataforma de origem, quando a automação foi disparada por um pedido. Ele pode ser diferente do número do pedido que o cliente vê.

Um envio de automação sem e-mail do destinatário e sem pedido fica sem tag e não aparece no Fluxo. Isso acontece, por exemplo, numa automação disparada por evento, data ou segmento para um contato que só tem telefone.

Assim, digitando o e-mail de um cliente no filtro de tag, você vê tudo o que as automações mandaram para ele.

> [!NOTE]
>
> A tag do envio não é a mesma coisa que a **marcação do contato** (a que o passo *Marcar contato* de uma automação aplica). O Fluxo usa só a tag do envio.

## Ver o fluxo de uma tag

**1. Abra a tela**

No menu, vá em **Comunicações → Fluxo**.

**2. Escolha a tag**

No campo **Tag**, digite parte do nome. A busca não diferencia maiúsculas de minúsculas e mostra até 50 tags por vez, em ordem alfabética; se houver mais, continue digitando para refinar. Quando só uma tag corresponde ao que você digitou, ou quando você digita o nome exato, **Enter** já seleciona.

**3. Leia a linha do tempo**

O diagrama mostra os envios daquela tag, do mais antigo para o mais recente.

**4. Abra um envio**

Clique em um card para ver o detalhe completo daquela mensagem.

Para trocar de tag, digite outra no campo ou limpe a seleção no **X**. O diagrama mostra uma tag por vez.

## O que o diagrama mostra

* **Card da tag** — no topo, com o nome da tag e o total de mensagens dela.
* **Cards de envio** — um por mensagem, ligados em ordem cronológica. A linha quebra a cada 5 envios no computador, a cada 3 em telas médias e a cada 2 no celular.

Cada card de envio traz:

* o nome da comunicação (se a comunicação tiver sido excluída, o card mostra o nome do canal e o detalhe do envio mostra "Comunicação removida");
* o canal;
* a situação do envio;
* a data e hora do envio, ou da criação da mensagem se ela ainda não saiu, no fuso horário da conta (**Configurações → Geral → Fuso horário**).

Use os controles de zoom no canto do diagrama para aproximar ou enquadrar tudo. Os cards não podem ser arrastados nem ligados entre si.

### Situação do envio

O card mostra a situação com o mesmo selo, nome e cor usados em [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md):

| No card | O que significa |
| - | - |
| **Enfileirada** | A mensagem ainda não saiu: está na fila ou sendo enviada. |
| **Enviada** | O canal aceitou a mensagem. |
| **Entregue** | O WhatsApp confirmou a entrega no aparelho (envios pela Evolution, por QR code). |
| **Lida** | O WhatsApp confirmou a leitura (envios pela Evolution, por QR code). |
| **Falhou** | O envio não se completou. O motivo aparece no detalhe do envio. |
| **Ignorada** | Nada foi enviado por uma regra de negócio, por exemplo contato descadastrado do canal. O motivo aparece no detalhe do envio. |

## Detalhe do envio

Clicar num card abre o painel **Detalhe do envio**, o mesmo usado em [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md). Nele você vê a comunicação, a situação exata (*Enfileirada*, *Enviando*, *Enviada*, *Entregue*, *Lida*, *Falhou* ou *Ignorada*), canal, idioma, datas, tags, destinatário, o erro quando houver, as variáveis utilizadas e o conteúdo enviado. Aparece também o rastreamento: entrega, abertura e clique no e-mail; recebimento e clique no web push. As datas do painel seguem o mesmo fuso da conta dos cards.

## Estados da tela

| Mensagem | Quando aparece |
| - | - |
| **Nenhum fluxo encontrado** | Nenhuma mensagem da conta foi enviada com tag ainda. A tela mostra um exemplo de chamada com o campo `tag`. |
| **Selecione uma tag para ver o fluxo** | Existem tags, mas nenhuma foi escolhida no filtro. |
| **Erro ao carregar os fluxos. Tente novamente.** | Não foi possível carregar os envios. Recarregue a página. |

## Limites

* A tela lê os **1.000 envios com tag mais recentes** da conta. Em contas com volume maior, os envios mais antigos (e as tags usadas só neles) ficam fora do diagrama e do filtro. Para consultar todos os envios de uma tag, use a API de [consulta de logs](https://docs.octasend.com.br/api-reference/consultar-logs.md) com o parâmetro `tag`.
* Não há filtro de período: o diagrama considera todo o histórico carregado.

## Fluxo e Automações

São telas diferentes, que se completam:

| | Fluxo | Automações |
| - | - | - |
| Onde fica | **Comunicações → Fluxo** | **Automações** |
| O que faz | Mostra, só para consulta, os envios já feitos, agrupados por tag | Você desenha a jornada: um gatilho de início e passos como *Enviar*, *Esperar*, *Se* e *Aguardar evento* |
| Envia mensagens | Não | Sim |
| Disponibilidade | Todas as contas | Pode não estar liberada para a sua conta — fale com a OctaSend para ativar |

Como as mensagens das automações saem com o e-mail do destinatário e o pedido como tags (quando esses dados existem), o Fluxo é também um jeito rápido de conferir o que uma automação enviou para um cliente ou para um pedido.

> [!TIP]
>
> Use como tag um identificador estável: o ID do cliente no seu sistema, o número do pedido ou o nome da ação (`onboarding`, `black-friday`). Combinando as duas coisas numa lista, como `["onboarding", "cliente-123"]`, você consegue ver tanto a ação inteira quanto a jornada de cada cliente.


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