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.
| Coluna | O que mostra |
|---|---|
| Nome | O nome interno, quem criou e quando. |
| Conteúdo | O 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íodo | Datas de início e fim, horário e dias da semana. |
| Onde | Os números de WhatsApp em que a peça vale (ou Todos os números) e o limite por dia. |
| Hoje e Total enviado | Peças enviadas hoje e no total, com clientes distintos, lidas e erros. |
| Situação | No 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ções | Relatório (já filtrado por esta promoção), Editar, Pausar ou Retomar, Excluir. |
Como funciona
- 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.
- 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).
- 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.
- 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.
- 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
| Campo | O que faz |
|---|---|
| Tipo da peça | Cartõ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). |
| Arquivo | Arraste 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. |
| Texto | Texto 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
| Campo | O que faz |
|---|---|
| Números de WhatsApp | Chip Todos os números ou os números escolhidos. Número com QR e API oficial conta como um só. |
| Pela API oficial | Aparece 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 dia | Teto 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 assistente | Ligada por padrão: técnicos, parceiros e fornecedores cadastrados em Contatos sem assistente não recebem a peça. |
| Não interromper atendimento com atendente | Desligada 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ção | Quem recebe |
|---|---|
| Todos que escreverem | Qualquer cliente que mandar a primeira mensagem do dia. É o padrão. |
| Assinantes com estas condições | Só 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 é assinante | Captaçã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
| Filtro | Como funciona |
|---|---|
| Planos | Chips 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 contrato | Ativo, Velocidade reduzida, Bloqueado, Suspenso, Cancelado, Pendente. Vazio = qualquer situação (um cancelado ainda conta como assinante). |
| Cidades e Bairro contém | Chips 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ão | Aparece quando há mais de um conectado: restringe a promoção aos assinantes daquele sistema. |
| Telefone fora do cadastro recebe mesmo assim | Desligada 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úmero | Como a peça sai | Custo |
|---|---|---|
| Só QR code | O conteúdo (foto, vídeo, nota de voz, documento ou texto) como qualquer mensagem do atendimento. | Sem custo. |
| QR e API oficial | Pela 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 oficial | Mesmo 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ão | O que mostra |
|---|---|
| Situação agora | No 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íodo | Peç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 dia | Colunas por dia: enviadas em verde e erros em vermelho. Passe o mouse para ver clientes e lidas do dia. |
| Por hora do dia | Em que horário os clientes mais escrevem e recebem a peça (útil para escolher a janela). |
| Por promoção e Por número | Enviadas, clientes, entregues, lidas, QR / API e erros de cada peça e de cada número de WhatsApp. |
| O que aconteceu depois | Quem 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 motivo | Conexã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 recebeu | Cada 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
| Sintoma | O que olhar |
|---|---|
| O cliente escreveu e não recebeu a peça | A 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ível | O 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 servidor | A 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 salvar | O servidor não conseguiu converter. Tente MP3, M4A ou OGG, ou grave direto pelo botão Gravar agora. |
| A assistente comentou a promoção | Ela 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. |