Skip to main content
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.
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.

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. Ele aceita um valor único ("onboarding") ou uma lista (["onboarding", "cliente-123"]):
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 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.
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:

Detalhe do envio

Clicar num card abre o painel Detalhe do envio, o mesmo usado em Logs de mensagens. 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

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