Promoções no chat

Uma peça publicitária (foto, vídeo, áudio, documento ou só texto, com ou sem legenda) que o cliente recebe assim que manda a primeira mensagem do dia, antes de qualquer resposta. Uma vez por dia por cliente, dentro do período e do horário que você escolher; depois o fluxo e a assistente seguem como se a peça não tivesse saído. Tudo fica registrado para o relatório: quem recebeu, quando, por onde, entregue, lida e o que aconteceu depois.

Visão geral

A página Promoções fica no menu lateral, logo depois de Automação de envios, com o subtítulo Peças publicitárias entregues na primeira mensagem do dia de cada cliente. Diferente das campanhas, que disparam para uma lista, a promoção não procura ninguém: ela espera o cliente escrever. Quem entra em contato com o provedor dentro da janela recebe a peça na hora, como primeira resposta, e segue sendo atendido normalmente.

No topo da página três passos resumem a ideia: O cliente escreve, A peça sai na frente e Uma vez por dia. Abaixo, o cartão Promoções no chat com os botões Relatório completo e Nova promoção, uma faixa de resumo (quantas estão no ar agora, a próxima janela, enviadas e clientes de hoje, erros, os últimos 7 dias) e a tabela das promoções.

ColunaO que mostra
NomeO nome interno, quem criou e quando.
ConteúdoO tipo da peça (Só texto, Foto, Vídeo, Áudio, Documento), um trecho do texto, o arquivo e, quando houver, a pílula Modelo pela API.
PeríodoDatas de início e fim, horário e dias da semana.
OndeOs números de WhatsApp em que a peça vale (ou Todos os números) e o limite por dia.
Hoje e Total enviadoPeças enviadas hoje e no total, com clientes distintos, lidas e erros.
SituaçãoNo ar (enviando agora), Fora do horário (dia válido, hora fora), Agendada (ainda não começou), Encerrada (passou do fim), Pausada (desativada por você) ou Sem dia da semana. O último erro de envio aparece aqui.
AçõesRelatório (já filtrado por esta promoção), Editar, Pausar ou Retomar, Excluir.

Como funciona

  1. O cliente escreve. Qualquer mensagem (texto, áudio, foto) que chega a um número em que a promoção vale, dentro do período, do horário e dos dias da semana marcados. O número precisa ter atendimento ligado: número só de divulgação não entra.
  2. O ChatISP confere se cabe. O cliente ainda não recebeu nenhuma peça hoje (com ou sem o nono dígito é o mesmo cliente), o limite diário da promoção não foi atingido, o contato não está na lista de Contatos sem assistente (se a regra estiver ligada) e a conversa não está com um atendente (se a outra regra estiver ligada).
  3. A peça sai na frente. Antes do fluxo, da assistente e de qualquer aviso, pela conexão do número. Foto, vídeo e documento levam o texto como legenda; áudio sai como nota de voz e o texto vai em uma segunda mensagem. As variáveis {nome} e {primeiro_nome} viram o nome do cliente.
  4. O atendimento segue normalmente. O fluxo entrega o menu, a assistente responde, a fila distribui. A peça fica no histórico da conversa (o atendente vê que ela foi enviada), mas a assistente não a leva em conta para responder nem para resumir o atendimento. A linha do tempo da conversa registra o evento Promoção.
  5. Uma vez por dia. Se o chamado for encerrado e o mesmo cliente escrever de novo no mesmo dia, ele não recebe a peça outra vez. No dia seguinte, dentro da janela, recebe. Com mais de uma promoção no ar para o mesmo número, o cliente recebe só a primeira da lista por dia.

A peça é uma resposta à mensagem do cliente, não um disparo. Por isso ela sai de graça pela conexão QR e, pela API oficial, dentro da janela de 24 horas que o próprio cliente abriu ao escrever. Veja Por onde a peça sai.


Criar uma promoção

Clique em Nova promoção. O formulário tem o nome, quatro seções numeradas, a faixa Na prática e, ao lado, a prévia Como o cliente vê, que acompanha tudo o que você preenche.

1. Conteúdo

CampoO que faz
Tipo da peçaCartões Só texto, Foto (JPEG ou PNG até 5 MB), Vídeo (MP4 até 16 MB), Áudio (vira nota de voz) e Documento (PDF, Word, Excel, PowerPoint, TXT ou ZIP até 45 MB).
ArquivoArraste para a área ou clique para escolher. No áudio você também pode Gravar agora pelo microfone do navegador e Parar gravação; o servidor converte qualquer áudio para o formato da nota de voz do WhatsApp. Ao editar, o arquivo atual aparece com o botão Trocar.
TextoTexto da mensagem (só texto), Legenda (opcional) (foto, vídeo, documento) ou Texto enviado depois do áudio (opcional). Aceita a formatação do WhatsApp (*negrito*, _itálico_, ~tachado~) pela barra de ferramentas e as variáveis {nome} e {primeiro_nome} pelos chips.

2. Quando

Começa em e Termina em (datas), Das e Até (horário no fuso do painel; para a madrugada use, por exemplo, 22:00 às 02:00) e os chips dos dias da semana. Fora disso o atendimento segue sem a peça.

3. Onde e regras

CampoO que faz
Números de WhatsAppChip Todos os números ou os números escolhidos. Número com QR e API oficial conta como um só.
Pela API oficialAparece quando algum número escolhido tem a perna da API oficial. Mesmo conteúdo (a foto, o vídeo, o áudio ou o texto saem como mensagem comum dentro da janela de 24 horas) ou Modelo aprovado (quando a vez é da API, sai o modelo aprovado pela Meta no lugar do conteúdo, com as variáveis preenchidas por Nome do cliente, Primeiro nome ou Texto fixo e a imagem do cabeçalho quando o modelo tem).
Limite por diaTeto de clientes que recebem a peça por dia (0 = sem limite). Atingido o teto, o atendimento segue sem ela.
Não enviar a contatos sem assistenteLigada por padrão: técnicos, parceiros e fornecedores cadastrados em Contatos sem assistente não recebem a peça.
Não interromper atendimento com atendenteDesligada por padrão. Ligada, conversa que já está com um atendente não recebe a peça; só conversas novas, no fluxo ou com a assistente.

4. Público

Quem recebe a peça: todos, só assinantes que atendem às condições (plano, situação, cidade, bairro, velocidade, sistema de gestão) ou só quem não é assinante. Veja Público-alvo.

A faixa Na prática resume a promoção em uma frase ("De 19/10/2026 a 25/10/2026, das 08:00 às 20:00, dias úteis, em Atendimento: a peça sai na primeira mensagem do dia de cada cliente, uma vez por dia"). Ao salvar, a promoção já nasce ativa; se a data de início for hoje e a hora estiver dentro da janela, ela entra No ar na mesma hora.


Público-alvo

A seção 4. Público do formulário decide quem recebe a peça. As condições usam o cadastro de assinantes que o ChatISP espelha dos sistemas de gestão (o mesmo do cartão do cliente, renovado a cada 6 horas), sem consulta nova na hora da entrega.

OpçãoQuem recebe
Todos que escreveremQualquer cliente que mandar a primeira mensagem do dia. É o padrão.
Assinantes com estas condiçõesSó quem está no cadastro do sistema de gestão e atende aos filtros marcados. Cliente com mais de um contrato entra se algum contrato atender.
Quem não é assinanteCaptação: só telefones que não aparecem no cadastro de nenhum sistema de gestão conectado. Não dá para estimar o alcance antes.

Os filtros de assinante

FiltroComo funciona
PlanosChips com os planos reais do cadastro (com a contagem de contratos). Marque um ou vários: vale "plano X ou plano Y". Vazio = qualquer plano.
Situação do contratoAtivo, Velocidade reduzida, Bloqueado, Suspenso, Cancelado, Pendente. Vazio = qualquer situação (um cancelado ainda conta como assinante).
Cidades e Bairro contémChips com as cidades do cadastro; o bairro é por trecho de texto.
Velocidade de / até (Mbps)Faixa pela velocidade de download do plano. Contrato sem velocidade no cadastro fica fora quando a faixa está preenchida.
Sistema de gestãoAparece quando há mais de um conectado: restringe a promoção aos assinantes daquele sistema.
Telefone fora do cadastro recebe mesmo assimDesligada por padrão: quem escrever de um número que não está no cadastro fica fora desta promoção (outra promoção da fila ainda pode atendê-lo).

O botão Prévia do alcance conta quantos assinantes com telefone no cadastro atendem às condições hoje, no total e por sistema de gestão, e avisa quantos contratos atendem mas estão sem telefone. É uma estimativa pelo espelho: recebe quem escrever dentro da janela.

Fila de prioridade

O cliente continua recebendo uma peça por dia. Com mais de uma promoção no ar, vale a fila: a primeira da lista que aceitar o cliente envia, e as demais ficam para outro dia. As setas Prioridade N na fila do dia, na coluna Nome, sobem e descem cada promoção. Ponha a mais específica em cima: quem é do plano X recebe a peça do plano X, e os demais caem na promoção geral logo abaixo.

Quem escreveu mas não atende às condições aparece no relatório como Fora do público, com a promoção que o recusou, e não consome o limite diário nem a regra de uma peça por dia.

Filtros por tempo de contrato e por fidelidade expirada dependem de dados que nem todo sistema de gestão entrega pela API; estão em estudo por sistema. Hoje a aproximação é combinar plano e situação do contrato.


Por onde a peça sai

A peça usa a mesma regra de canais do atendimento (política de canais): no número com QR e API oficial sai pela conexão da vez, o QR por padrão.

NúmeroComo a peça saiCusto
Só QR codeO conteúdo (foto, vídeo, nota de voz, documento ou texto) como qualquer mensagem do atendimento.Sem custo.
QR e API oficialPela conexão da vez, QR de preferência. Com Modelo aprovado escolhido, o modelo só sai quando a vez é da API.Sem custo pelo QR; pela API conta na franquia do mês.
Só API oficialMesmo conteúdo: a mensagem sai dentro da janela de 24 horas aberta pelo cliente. Modelo aprovado: sai o modelo da Meta.Mensagem de serviço na franquia; modelo pago por mensagem.

O modelo aprovado vale só para o número da API oficial em que foi aprovado. Em outros números da mesma promoção sai o conteúdo da seção 1. Modelos se criam na página Templates Meta.


Regras e limites

  • Uma peça por cliente por dia, contando todas as promoções. Telefone com e sem o nono dígito é o mesmo cliente.
  • Várias promoções no ar para o mesmo número: vale a fila de prioridade, e o cliente recebe a primeira que o aceitar no público. Ficar fora do público de uma não consome a vez: a próxima da fila tenta.
  • Limite por dia conta peças que saíram; erro de envio não consome o limite, e o cliente com erro pode receber de novo no mesmo dia se escrever outra vez.
  • Horário no fuso do painel (Configurações, aba Sistema). Janela que vira a meia-noite é aceita.
  • Número de divulgação (atendimento desligado em Conexões) não recebe promoção: ele já tem a própria resposta automática.
  • Encerrar ou excluir não apaga nada das conversas: as peças já entregues continuam no histórico e no relatório. Excluir apaga só o arquivo da peça.

Relatório

O botão Relatório completo (ou Relatório na linha, já filtrado) abre o Relatório de promoções. No topo, o seletor de promoção (Todas as promoções ou uma), o período (Hoje, Últimos 7 dias, 30 ou 90) e Exportar CSV. A página se atualiza sozinha a cada minuto.

CartãoO que mostra
Situação agoraNo ar agora, Enviadas hoje, Clientes hoje, Erros hoje e, por promoção, a situação, o período, o horário, os números, a próxima janela ("Enviando agora (janela até 20:00)" ou "Próxima janela: 20/10 08:00"), o que saiu hoje, o total e o último erro.
Indicadores do períodoPeças enviadas (com a média por dia), Clientes alcançados (telefones distintos; quantos receberam em mais de um dia), Entregues e Lidas (com a porcentagem das enviadas), Com erro, Fora do público (escreveram, mas não atendem às condições) e QR / API oficial (por onde a peça saiu, com quantas foram por modelo aprovado).
Peças por diaColunas por dia: enviadas em verde e erros em vermelho. Passe o mouse para ver clientes e lidas do dia.
Por hora do diaEm que horário os clientes mais escrevem e recebem a peça (útil para escolher a janela).
Por promoção e Por númeroEnviadas, clientes, entregues, lidas, QR / API e erros de cada peça e de cada número de WhatsApp.
O que aconteceu depoisQuem cuidou do cliente depois da peça: Assistente de IA, Atendente, Só a automação (o fluxo, sem IA nem atendente) ou Ninguém ainda, e quantos clientes continuaram a conversa.
Erros por motivoConexão indisponível, número sem WhatsApp, Meta segurou a mensagem de marketing, limite de envio da Meta, arquivo da peça não encontrado e os Fora do público. O botão Ver filtra a lista completa pelo motivo.
Quem recebeuCada peça entregue no período: cliente e telefone, promoção, número e canal, situação (Enviada, Entregue, Lida, Erro com o motivo, Fora do público), quando saiu, quem cuidou depois e Abrir conversa. Filtros Todas, Enviadas, Lidas, Erro e Fora do público e busca por cliente, telefone ou promoção. A tela mostra as 500 mais recentes; o CSV traz todas.

O CSV sai com promoção, cliente, telefone, conexão, canal, via (conteúdo ou modelo aprovado), situação, motivo, data e hora, quem cuidou depois, atendente, se o cliente continuou, protocolo e o número da conversa.


Permissão

A página e o relatório exigem a permissão Promoções no chat (grupo Atendimento na tela de perfis: Cria, agenda e acompanha as promoções entregues na primeira mensagem do dia do cliente.). O Administrador já tem; para outros perfis, ligue na tela de Perfis. Usuário restrito a alguns números na ficha de atendentes só cria promoções nos números em que atua. Criar, editar, pausar e excluir entram na Auditoria.


Boas práticas

  • Arte quadrada ou 4:3, com o preço e a oferta legíveis no celular. Banner largo fica pequeno no WhatsApp.
  • Texto curto e com chamada clara ("Responda PROMO"), para o cliente saber o que fazer. A assistente continua o atendimento normalmente, então combine com a Base de conhecimento o que ela deve responder sobre a oferta.
  • Use {primeiro_nome}: quando o nome do cliente não é conhecido, a variável some e a frase continua correta.
  • Janela de horário comercial para ofertas que dependem de contratação; a peça fora do expediente gera interesse sem ninguém para atender.
  • Veja o relatório no segundo dia: a leitura (Lidas) e o cartão O que aconteceu depois dizem se a peça está ajudando ou atrapalhando.

Problemas comuns

SintomaO que olhar
O cliente escreveu e não recebeu a peçaA promoção está No ar? Confira situação, período, horário e dias da semana. O número dele está na lista da promoção? Ele está no público? O relatório mostra a linha Fora do público quando é isso. Ele já recebeu uma peça hoje (de qualquer promoção)? O limite do dia foi atingido? Ele está em Contatos sem assistente? A conversa já estava com um atendente e a regra está ligada?
Último erro: Conexão indisponívelO número estava desconectado na hora. Reconecte em Conexões; o próximo cliente que escrever recebe.
Arquivo da peça não encontrado no servidorA peça foi restaurada de um backup só de banco ou o arquivo foi removido. Edite a promoção e envie o arquivo de novo.
Áudio recusado ao salvarO servidor não conseguiu converter. Tente MP3, M4A ou OGG, ou grave direto pelo botão Gravar agora.
A assistente comentou a promoçãoEla não lê a peça, mas lê o que o cliente responde. Se o cliente perguntar sobre a oferta, cadastre as condições na Base de conhecimento para a resposta sair certa.