For the complete documentation index, see llms.txt. This page is also available as Markdown.

📣Transmissões (Novo)

Na Hyperflow, existe uma maneira de enviar mensagens em massa, separadas por lotes e com datas e horários específicos. Neste artigo, você vai aprender mais sobre as Transmissões.

📣 Transmissões

Na tela de Transmissões do Hyperflow Integrações, você envia uma mesma mensagem para muitos contatos de uma vez, em lotes, com data e horário definidos por você. Também é nela que você acompanha tudo o que já foi enviado.

Transmissão é um disparo automatizado de conteúdo para uma lista de contatos. É muito usada em campanhas promocionais, avisos e lembretes de consulta, por exemplo.

Cada transmissão pode ser enviada de duas formas:

  • Envio por fluxo: os contatos entram em um fluxo que você já criou, e o fluxo envia as mensagens.

  • Envio direto: a plataforma dispara um template aprovado pela Meta (também chamado de HSM) direto para os contatos, sem precisar montar um fluxo só para enviar a mensagem. Você ainda escolhe um fluxo de resposta, que cuida do que o contato responder. Esse modo está disponível para canais de WhatsApp.

Procurando as listas de transmissão do Hyperflow Conversas? Elas ficam em outra tela e têm outro funcionamento. Veja o guia de Mensagens agendadas.

Imagem 1 - Visão geral da tela de Transmissões com a lista de transmissões preenchida

🚪 Como acessar

  1. Selecione o aplicativo em que a transmissão será feita.

  2. No menu lateral esquerdo, clique em Transmissões.

  3. Você será direcionado para a tela Lista de transmissões.


🗺️ Conhecendo a tela

🔎 Barra superior e filtros

No topo da tela você encontra:

  • Título e subtítulo: "Lista de transmissões", com a explicação de que ali você cria listas para notificar vários usuários de uma vez.

  • Botão de atualizar: recarrega a lista, útil para acompanhar uma transmissão que está sendo enviada.

  • Pesquisar por nome: digite parte do nome e a lista mostra só as transmissões correspondentes.

  • Filtro de status: escolha Todos os status ou um status específico (veja a seção Entendendo status e situação de envio, mais abaixo).

  • Criar transmissão: abre o passo a passo para montar uma nova transmissão.

📋 Tabela de transmissões

Cada linha é uma transmissão. As colunas são:

Coluna
O que mostra

Nome

Nome da transmissão. Um ícone de informação mostra a descrição ao passar o mouse. Abaixo do nome aparece quem criou.

Status

Em que etapa a transmissão está (rascunho, agendada, processando, enviada e assim por diante).

Situação de envio

Um resumo simples para você saber se a transmissão está salva, pronta, enviando, enviada ou com erro.

Entrega

Quantos contatos já receberam, no formato "Enviado X de Y". Em contas com acompanhamento de entrega, também aparece quantas mensagens foram entregues e o percentual, com cor verde (80% ou mais), amarela (50% ou mais) ou vermelha (abaixo de 50%).

Cadência

Quantos usuários são enviados por lote e de quantos em quantos minutos.

Criado em

Data e hora em que a transmissão foi criada.

Enviado em

Data e hora em que os envios começaram.

Finalizado em

Data e hora em que terminou.

Ações

Botões para trabalhar com a transmissão (veja abaixo).

Clique no título de uma coluna ordenável (Status, Criado em, Enviado em, Finalizado em) para ordenar a lista. No rodapé você escolhe quantas transmissões ver por página e navega entre as páginas.

Se você ainda não tem nenhuma transmissão, a tela mostra a mensagem Nenhuma transmissão encontrada e convida você a criar a primeira.

🛠️ Ações de cada linha

Na coluna Ações de cada transmissão você encontra:

  • Resultado: abre o resultado por contato (veja a seção Acompanhando os resultados).

  • Editar: aparece para transmissões em rascunho. Abre o formulário para você continuar a configuração.

  • Visualizar: aparece para as demais transmissões. Abre o formulário em modo leitura.

  • Arquivar: cancela e guarda a transmissão no histórico.

  • Clonar: cria uma cópia em rascunho para você reaproveitar a configuração.

Imagem 2 - Linha da tabela com os botões Resultado, Editar, Arquivar e Clonar à direita

🏷️ Entendendo status e situação de envio

A tela mostra dois indicadores diferentes. Eles se complementam: o status conta em que etapa a transmissão está, e a situação de envio resume se ela pode, está ou já foi enviada.

📌 Status

Status
O que significa

Rascunho

A transmissão foi salva, mas ainda não foi enviada. Pode ser editada.

Aguardando aprovação

Você pediu o envio, mas o template ainda está em análise pela Meta. O envio sai sozinho assim que o template for aprovado.

Pendente

Envio solicitado. A transmissão está na fila para começar.

Agendado

O envio está marcado para uma data e hora futuras.

Processando

Os lotes estão sendo enviados agora.

Enviado

Todos os contatos da planilha foram processados.

Interrompido

A transmissão foi parada, por exemplo porque o template foi reprovado. Não retoma sozinha: clone a transmissão para tentar de novo.

Arquivado

A transmissão foi arquivada e fica só no histórico.

🚦 Situação de envio

Situação
Quando aparece

Salvo

A transmissão está salva e ainda não foi liberada para envio.

Aguardando aprovação

O envio foi pedido e está esperando a Meta aprovar o template.

Pronto para envio

O envio foi pedido ou agendado e nada impede que ele aconteça.

Enviando

Os lotes estão sendo disparados.

Enviado

O envio terminou.

Erro

Algo impediu o envio. Passe o mouse sobre a situação para ver o motivo.

Quando a situação é Erro por causa do template, o motivo pode ser:

  • Template reprovado pela Meta: a Meta analisou e recusou o template. O texto que a Meta enviou sobre a recusa aparece junto, quando ela informa.

  • Expirou aguardando aprovação da Meta: o template ficou em análise por mais tempo que o limite de espera (por padrão, 3 dias) e a transmissão foi encerrada.

  • Template indisponível na Meta: o template foi excluído, desativado ou pausado.

Transmissões arquivadas não exibem situação de envio, só o status Arquivado.

Imagem 3 - Lista com transmissões em situações diferentes e o balão de motivo aberto em uma situação Erro

➕ Criando uma transmissão

🎯 Propósito

Montar o disparo em massa: escolher o canal, importar quem vai receber, definir a mensagem e configurar quando e em que ritmo os envios acontecem.

✅ Como fazer na tela

  1. Na tela de Transmissões, clique em Criar transmissão.

  2. Se sua conta tem SMS disponível, aparece uma janela para escolher o tipo: Fluxo ou envio direto ou SMS. Selecione o tipo e confirme. Se a conta não tem SMS, você vai direto para o formulário.

  3. Preencha o nome, o canal e, se quiser, a descrição.

  4. Importe a planilha de usuários.

  5. Escolha como a mensagem será enviada (fluxo, envio direto ou, no SMS, o texto da mensagem).

  6. Defina o início, o tamanho dos lotes, o intervalo e, se quiser, o período de envio.

  7. Clique em Salvar para guardar como rascunho ou em Enviar para disparar (veja a seção Salvando e enviando).

Cada bloco do formulário é explicado em detalhes na seção Conhecendo o formulário, logo a seguir.

Imagem 4 - Janela de escolha do tipo de transmissão com as opções Fluxo ou envio direto e SMS

📌 Resultado esperado

Ao clicar em Salvar, a tela mostra a mensagem Transmissão criada com sucesso e você volta para a lista, onde a nova transmissão aparece com o status Rascunho.


🧩 Conhecendo o formulário

No alto do formulário há um botão de seta para Voltar à lista. Ao lado do título ("Criar transmissão" ou "Editar transmissão") aparece o status da transmissão e, depois de salva, a indicação Salvo.

📝 Dados gerais

Campo
O que preencher

Nome da transmissão

Obrigatório. Dê um nome que ajude a reconhecer a campanha depois.

Selecionar canal

Obrigatório. Escolha o canal que fará o envio. Só aparecem canais publicados e com transmissão permitida. No SMS, no lugar do canal você escolhe a Chave de API.

Descrição

Opcional. Observações sobre a transmissão. Aparece como dica na lista.

Tag de custo

Opcional. Texto livre (por exemplo, "Black Friday") para agrupar o custo desta transmissão nos relatórios de custos.

Imagem 5 - Campos de nome, canal, descrição e tag de custo preenchidos

👥 Usuários (planilha de contatos)

Aqui você importa a lista de quem vai receber a mensagem.

  1. Clique em Baixar planilha modelo se quiser partir de um arquivo pronto, com as colunas de identificação, nome e telefone.

  2. Abra o bloco Como montar a planilha para ver as regras de preenchimento (resumidas abaixo).

  3. Clique na área Clique para selecionar e escolha o arquivo .xlsx ou .csv. Cabem até 10 mil linhas por transmissão.

  4. Na janela de importação, confira os cabeçalhos, combine as colunas do arquivo com os campos esperados e corrija o que a janela indicar.

  5. Confirme. O nome do arquivo aparece na tela e você vê uma prévia com as 6 primeiras linhas, seguida de "+ Outros N..." com o restante.

Regras da planilha:

  • ID é o único campo obrigatório. É o identificador do contato no canal escolhido. Em transmissões por WhatsApp, preencha essa coluna com o número de telefone.

  • Números nacionais: o +55 é opcional. A transmissão funciona com ou sem ele.

  • Números internacionais: informe sempre o +DDI antes do telefone.

  • Usando Excel? Importe em .xlsx (e não .csv) para evitar problemas de compatibilidade.

  • Os demais campos são opcionais e podem ser usados no conteúdo da mensagem. Uma coluna chamada nome, por exemplo, fica disponível como {{input.nome}} no envio por fluxo, como {{contact.nome}} nos parâmetros do template no envio direto e como {{nome}} no texto do SMS.

Imagem 6 - Bloco Usuários com a área de seleção, o link de planilha modelo e o aviso "Como montar a planilha" aberto

💬 Mensagem: como o envio será feito

Para canais de WhatsApp, você escolhe o Tipo de envio entre dois cartões. Para os demais canais, aparece apenas a escolha do fluxo.

🔀 Envio por fluxo

  1. Selecione o cartão Envio por fluxo.

  2. No campo Selecionar fluxo, escolha o fluxo publicado que vai conversar com os contatos.

As mensagens seguem o fluxo da plataforma, e as colunas da planilha ficam disponíveis dentro dele como variáveis de entrada.

📨 Envio direto

  1. Selecione o cartão Envio direto.

  2. Em Selecionar template, escolha o template do canal. A lista mostra o nome, o idioma e uma etiqueta com a situação na Meta (Aprovado ou Em análise). Templates reprovados, excluídos ou pausados não aparecem. Você precisa ter escolhido o canal antes, senão o campo avisa para selecionar um canal primeiro.

  3. Quando disponível para sua conta, a lista traz no final a opção Criar novo template, que abre a criação de template sem você sair da transmissão. O template novo entra em análise na Meta.

  4. Em Fluxo de resposta, escolha o fluxo que será executado quando o contato responder à mensagem. Esse campo é obrigatório.

  5. Confira a Prévia do template, que mostra como a mensagem vai chegar.

  6. Se o template tem variáveis (campos entre chaves duplas), aparece a seção Parâmetros, dividida em Cabeçalho, Corpo, Botões e Carrossel, conforme o template. Preencha cada parâmetro. Para usar dados da planilha, escreva a coluna entre chaves, como {{contact.nome}}. Abaixo dos campos aparece a lista de Colunas disponíveis vindas da planilha.

No envio direto, o template envia a primeira mensagem. O fluxo de resposta só trata o que o contato responder depois.

Imagem 7 - Cartões Envio por fluxo e Envio direto lado a lado
Imagem 8 - Envio direto com template, fluxo de resposta, e prévia preenchidos
Imagem 9 - Lista de templates com as etiquetas Aprovado e Em análise e a opção Criar novo template

🧾 Template em análise, reprovado ou indisponível

Ao escolher um template, a tela avisa o que isso significa para o envio:

  • Em análise: aparece o aviso "Este template ainda está em análise. Enviar agora consulta a Meta e, se ainda não estiver aprovado, aguarda a aprovação." Você consegue salvar e enviar. Ao enviar, a transmissão fica em Aguardando aprovação e sai sozinha quando a Meta aprovar, respeitando o lote, o intervalo e o período de envio que você configurou. Enquanto o template está em análise, o início Agendar envio fica indisponível, porque a data poderia passar antes da aprovação.

  • Reprovado, excluído, desativado ou pausado: aparece o aviso "O template selecionado não está disponível para envio." Os botões Salvar e Enviar ficam desativados. Escolha outro template.

  • Status ainda não carregado: o botão Enviar fica desativado e mostra "O status de aprovação do template ainda não está disponível". Aguarde alguns instantes.

💬 SMS

No SMS, em vez de fluxo ou template, você escreve o texto da mensagem, com até 160 caracteres (a tela mostra o contador). O texto pode usar as colunas da planilha, como {{nome}}. Nesse tipo, a Chave de API e a mensagem são obrigatórias, no lugar do canal e do fluxo. As transmissões por SMS podem ter até 5.000 usuários por lote.

🧪 Distribuição entre templates (teste A/B)

No envio direto, você pode dividir os contatos entre mais de um template para comparar resultados.

  1. Ative a chave Distribuição entre templates.

  2. Cada template vira uma variante (A, B, C...). Em cada uma, escolha o template e o percentual de contatos que vai receber.

  3. Use Adicionar template para incluir mais variantes. O mínimo é 2 e o máximo é 5.

  4. A soma dos percentuais precisa ser 100%. O indicador Soma fica verde quando está certo. Se precisar, clique em Distribuir igualmente.

  5. Cada variante tem sua própria prévia e seus próprios parâmetros. Para remover uma variante, use o botão de lixeira (sempre restam ao menos 2).

  6. Escolha o Fluxo de resposta, que é um só para todas as variantes.

Os contatos são sorteados entre as variantes de acordo com os percentuais. Cada variante precisa de um template diferente.

Imagem 10 - Chave de distribuição ativada com barra colorida de percentuais e três variantes

⏱️ Lotes, início e período de envio

▶️ Início da transmissão

Escolha um dos dois cartões:

  • Enviar imediatamente: a transmissão começa assim que você enviar.

  • Agendar envio: defina a Data de início da transmissão. Não é possível escolher uma data e hora no passado.

Se a data agendada cair fora do período de envio, a tela avisa: "O horário agendado está fora da janela configurada. A transmissão será iniciada no próximo horário permitido."

📦 Lotes

Campo
O que preencher

Usuários por lote

Obrigatório. Quantos contatos recebem a mensagem por vez. O padrão é 5. O máximo é 100 por lote (algumas contas têm um limite maior) e, em canais RCS, 500. Lotes maiores enviam mais rápido, mas aumentam o risco de bloqueio pelo canal.

Intervalo entre lotes (em minutos)

Obrigatório, no mínimo 1. O padrão é 1. É o tempo de espera entre um lote e o próximo. Intervalos maiores reduzem o risco de bloqueio, mas alongam o envio total.

🕗 Período de envio da transmissão

Esta chave restringe os envios a uma janela de horário.

  • Desativado: envia sem parar até concluir toda a planilha, respeitando o lote e o intervalo.

  • Ativado: envia apenas dentro da janela definida em Início e Fim. O padrão é das 08:00 às 18:00. O que não terminar no dia continua no dia seguinte, dentro da janela.

O horário final precisa ser posterior ao inicial. Caso contrário, a tela mostra "O horário final deve ser posterior ao horário inicial."

Exemplo: uma transmissão para 100 usuários, com lotes de 10 e intervalo de 5 minutos, envia 10 lotes. O último lote sai cerca de 45 minutos depois do primeiro.


📤 Salvando e enviando

🎯 Propósito

Guardar sua configuração para continuar depois ou liberar o disparo para os contatos.

✅ Como fazer na tela

Na parte de baixo do formulário há dois botões:

  1. Salvar: guarda a transmissão como rascunho, sem enviar nada. Você pode voltar e editar quando quiser.

  2. Enviar: abre a janela Enviar transmissão com a pergunta "Você realmente deseja salvar as alterações e enviar essa transmissão para os usuários?". Clique em Enviar para confirmar ou em Cancelar para voltar.

Os botões só ficam ativos quando todos os campos obrigatórios estão preenchidos e corretos, inclusive a planilha importada.

Cada transmissão é configurada uma vez e enviada uma vez. Depois que ela é enviada, não é possível reenviá-la nem alterar a configuração. Para disparar de novo, use Clonar.

📌 Resultado esperado

Após confirmar, a tela mostra Transmissão enviada com sucesso e você volta para a lista. A transmissão passa para Agendado, Pendente ou Aguardando aprovação, conforme o caso, e depois para Processando e Enviado.


✏️ Editando ou visualizando uma transmissão

🎯 Propósito

Continuar a configuração de um rascunho ou consultar como uma transmissão foi enviada.

✅ Como fazer na tela

  1. Na lista, localize a transmissão.

  2. Clique em Editar (rascunho) ou em Visualizar (demais status).

  3. Em um rascunho, ajuste o que precisar e clique em Salvar ou Enviar.

  4. Nas demais transmissões, o formulário abre em modo leitura. Se houve planilha importada, há um botão para baixar o arquivo original.

📌 Resultado esperado

Em um rascunho, ao salvar, a tela mostra Transmissão atualizada com sucesso e o indicador Salvo volta a aparecer ao lado do título. Em transmissões já enviadas, agendadas ou aguardando aprovação, os campos ficam bloqueados para que o que foi combinado não mude.


📊 Acompanhando os resultados

🎯 Propósito

Ver o que aconteceu com cada contato: quem recebeu, quem leu e onde houve falha.

✅ Como fazer na tela

  1. Na linha da transmissão, clique em Resultado.

  2. Na janela que abre, use as abas de filtro:

    • Todos

    • Mensagens agendadas (não aparece em transmissões já enviadas)

    • Lidos (no SMS, Mensagens respondidas)

    • Mensagens entregues

    • Mensagens enviadas

    • Mensagens com erro

  3. Cada aba mostra a quantidade de contatos ao lado do nome.

  4. Na tabela, veja Status, ID, Nome, Enviado em, Entregue em e Lido em (no SMS, Respondido em e Resposta).

  5. Na aba Mensagens com erro, a coluna Detalhamento mostra o motivo da falha. Quando o texto é longo, clique em Ver mais detalhes.

  6. Clique em Exportar para baixar tudo em uma planilha .xlsx.

📌 Resultado esperado

Você enxerga o status individual de cada contato e consegue exportar o resultado para analisar fora da plataforma ou compartilhar com a equipe.

Imagem 11 - Janela de resultados com as abas de filtro e a tabela de contatos
Imagem 12 - Aba Mensagens com erro mostrando o detalhamento

📑 Clonando uma transmissão

🎯 Propósito

Reaproveitar a configuração de uma transmissão (por exemplo, uma campanha que deu certo ou uma que foi interrompida) sem preencher tudo de novo.

✅ Como fazer na tela

  1. Na linha da transmissão, clique em Clonar.

  2. Na janela Clonar transmissão, digite o Novo nome.

  3. Clique em Clonar.

📌 Resultado esperado

A plataforma cria uma cópia em Rascunho e abre o formulário dela para você revisar. A cópia leva as configurações, mas não leva a data de início agendada, os números de envio nem o histórico. Em envios diretos, a situação do template é conferida de novo na Meta. Se o template da transmissão original estiver incompleto, a clonagem é recusada e a tela mostra o motivo.

Imagem 13 - Janela Clonar transmissão com o campo Novo nome

🗃️ Arquivando uma transmissão

🎯 Propósito

Cancelar uma transmissão que não deve mais acontecer, mantendo o registro dela no histórico. Por segurança, não é possível excluir uma transmissão de forma definitiva: assim toda a equipe consegue consultar o que foi criado, agendado, enviado ou interrompido.

✅ Como fazer na tela

  1. Na linha da transmissão, clique em Arquivar.

  2. Confirme a pergunta "Deseja realmente arquivar a transmissão" clicando novamente em Arquivar.

📌 Resultado esperado

A tela mostra Transmissão arquivada com sucesso e a transmissão passa a aparecer com o status Arquivado. Para ver as arquivadas na lista, use o filtro de status.

Imagem 14 - Janela de confirmação Arquivar transmissão

💡 Dicas úteis

  • Confira os contatos duas vezes antes de enviar. É a causa mais comum de falhas.

  • Comece com lotes pequenos em uma campanha nova e aumente aos poucos. Lotes grandes aumentam o risco de bloqueio pelo canal. Veja as boas práticas para evitar bloqueio e suspensão de conta no WhatsApp.

  • Use o período de envio para que as mensagens só cheguem em horário comercial.

  • Prepare o envio antes da aprovação. Com o template em análise, você já pode configurar tudo e clicar em Enviar. A transmissão fica aguardando e sai sozinha quando a Meta aprovar.

  • Template reprovado ou expirado? A transmissão não retoma sozinha. Crie ou escolha outro template em uma cópia, usando Clonar.

  • A lista não atualizou? Clique no botão de atualizar no topo da tela.


🧭 Exemplo prático

Objetivo: avisar 2.000 clientes sobre uma promoção de fim de semana, usando um template de WhatsApp que ainda está em análise.

  1. Clique em Criar transmissão e escolha Fluxo ou envio direto.

  2. Dê o nome "Promoção fim de semana", escolha o canal de WhatsApp e importe a planilha com as colunas id e nome.

  3. Em Tipo de envio, escolha Envio direto, selecione o template (etiqueta Em análise) e preencha o parâmetro do corpo com {{contact.nome}}.

  4. Em Fluxo de resposta, selecione o fluxo de atendimento que vai tratar as respostas.

  5. Em Lotes, deixe o início em Enviar imediatamente, use 50 usuários por lote, intervalo de 2 minutos e período de envio das 09:00 às 18:00.

  6. Clique em Enviar e confirme.

Resultado esperado: a transmissão fica em Aguardando aprovação. Quando a Meta aprovar o template, os envios começam sozinhos dentro do período definido, e você acompanha tudo pelo botão Resultado.


✅ Resumo

  • A tela de Transmissões cria, agenda e acompanha disparos em massa em lotes, com início imediato ou agendado e período de envio opcional.

  • Você escolhe entre envio por fluxo e envio direto de template (WhatsApp), com opção de dividir os contatos entre até 5 templates.

  • O status mostra a etapa da transmissão e a situação de envio resume se ela está salva, pronta, enviando, enviada ou com erro.

  • Com template em análise, a transmissão aguarda a aprovação da Meta e sai sozinha. Se for reprovado ou expirar, a situação vira Erro e você clona a transmissão para tentar de novo.

  • Use Resultado para ver cada contato e exportar, Clonar para reaproveitar e Arquivar para cancelar sem perder o histórico.

Last updated