Agendar mensagem no Telegram: os 7 intervalos que existem

Todo criador que vende no Telegram chega em algum momento na mesma ideia: se dá para agendar mensagem no Telegram, então dá para deixar a semana inteira pronta e viajar tranquilo. A ideia é boa e funciona bem para metade do trabalho. A outra metade ela não cobre, e o motivo não é opinião: está escrito na documentação da própria plataforma.

Resposta primeiro: o agendamento nativo é uma fila do servidor presa ao relógio. Ele sabe a hora, não sabe quem comprou. A repetição automática existe, mas só para quem tem Premium, só para uma mensagem por vez e apenas em sete intervalos fixos, sendo que nenhum deles corresponde aos momentos que uma operação de venda precisa acertar.

Este artigo lê a página de mensagens agendadas da API, lista os sete intervalos com a conta de quantos disparos cada um entrega por ano, mostra a condição que derruba a opção de "enviar quando ficar online" e separa o que vale agendar do que precisa de automação por evento.

Agendar mensagem no Telegram: como a fila funciona por dentro

Resposta primeiro: agendar não guarda nada no seu celular. A documentação de mensagens agendadas descreve o mecanismo assim: "A mensagem ou mídia especificada será adicionada a uma fila de agendamento do lado do servidor para o chat atual, e será enviada automaticamente no horário especificado."

Três consequências práticas saem daí. A primeira é que o envio não depende de o seu aplicativo estar aberto, nem do seu celular estar ligado. A segunda é que cada conversa tem a sua própria fila: a documentação registra que "cada conversa privada, chat, supergrupo e canal tem a sua própria fila de agendamento e sequência de identificadores". A terceira aparece num detalhe fácil de esbarrar: "se a data agendada estiver a menos de 10 segundos no futuro, a mensagem será enviada imediatamente". Quem agenda "para daqui a pouco" testando o recurso descobre que ele simplesmente enviou.

O recurso é antigo e estável. Ele foi anunciado no blog oficial do Telegram em 5 de setembro de 2019, com a instrução que continua valendo: "Segure o botão 'Enviar' em qualquer conversa e selecione 'Agendar mensagem' para enviar coisas automaticamente em um horário especificado no futuro." O mesmo post registra que o agendamento também funciona na sua conversa de mensagens salvas, virando lembrete.

Os sete intervalos de repetição, e a conta de cada um

Resposta primeiro: a repetição automática não aceita qualquer periodicidade. A documentação diz que "usuários Premium podem enviar mensagens agendadas repetidas" e, na sequência, fecha a lista de valores aceitos.

São sete: um dia, sete dias, quatorze dias, trinta dias, noventa e um dias, cento e oitenta e dois dias e trezentos e sessenta e cinco dias. A página acrescenta dois valores de 60 e de 300 segundos que existem apenas no datacenter de testes, ou seja, fora do que qualquer conta real usa. A tabela abaixo traduz cada um em número de disparos por ano, que é a forma útil de olhar para eles quando o assunto é presença no canal.

Intervalo	Disparos por ano
Todo dia	365
Toda semana	52
A cada duas semanas	26
Todo mês	12
A cada três meses	4
Duas vezes por ano	2
Todo ano	1

Há ainda uma restrição de formato que costuma passar batida: a documentação registra que o campo de repetição "só pode ser usado ao enviar ou encaminhar uma única mensagem", o que exclui álbuns e o encaminhamento de mais de uma mensagem de uma vez. Quem planejava repetir um carrossel de três fotos toda semana precisa repensar o formato, não o horário.

Agora o ponto que decide o uso. Uma operação de venda no Telegram pede envios em momentos que não estão nessa lista: o lembrete alguns dias depois de a pessoa entrar no canal gratuito, o aviso poucos dias antes do vencimento da assinatura, a tentativa de recuperação logo depois de um pagamento não concluído. O gráfico abaixo mostra os quatro intervalos curtos permitidos e onde esses momentos caem.

O "enviar quando ficar online" e a condição que o derruba

Resposta primeiro: existe uma opção que parece resolver a segmentação, e ela tem alcance menor do que promete. A documentação descreve um valor especial de agendamento que só vale "se o destino for uma conversa privada com um usuário". Com ele, a mensagem é enviada "imediatamente (sem passar pela fila de agendamento), se o usuário estiver online" ou, caso contrário, "será enviada automaticamente quando o usuário voltar a ficar online".

A restrição está logo abaixo, e é dupla. Primeiro, o recurso não existe para canal nem para grupo, que é justamente onde mora a audiência de quem vende. Segundo, a página registra que um erro "também pode ser emitido ao agendar com esse valor se o horário de último acesso do usuário de destino estiver oculto pelas configurações de privacidade dele: nesse caso, a mensagem não será agendada nem enviada".

Esse segundo ponto é um caso de borda com consequência real. Ocultar o "visto por último" é uma configuração comum, e ela não avisa ninguém do outro lado. Uma rotina que dependa desse modo de envio falha em silêncio exatamente com o perfil mais reservado da sua base.

O que o agendamento não faz, e por que o bot existe

Resposta primeiro: agendar é uma função da sua conta de usuário, feita no aplicativo. Ela não conhece o estado de ninguém.

Vale ser explícito sobre o que é leitura nossa e o que é citação. A referência de métodos do Bot API descreve os parâmetros aceitos pelo método de envio de mensagens de texto, e, na leitura que fizemos dessa lista, não há entre eles nenhum campo que coloque um envio comum na fila de agendamento. Existe uma exceção estreita, e ela vale registrar para não passar por omissão: o objeto de post sugerido aceita uma data de envio, descrita na página como "data de envio proposta do post", entre 300 segundos e 30 dias no futuro, e essa data só serve para post que um administrador do canal ainda precisa aprovar em conversa de mensagens diretas. Não é agendamento de mensagem para a sua base. A conclusão prática que tiramos disso é simples e vale conferir no seu caso: o disparo agendado sai da sua conta pelo aplicativo, e o disparo condicionado a um evento de compra sai da automação.

A diferença aparece na primeira semana de operação. Uma mensagem agendada para sexta às 19h vai para todo mundo que está no chat naquele instante, inclusive para quem comprou na quinta. A mesma mensagem disparada por automação sai só para quem ainda não comprou, porque a automação lê o estado. O desenho dessa separação por público está em segmentar assinantes com mensagens automáticas, e o intervalo saudável entre um envio e o outro está em cadência de mensagens automáticas no Telegram.

Tarefa	Quem resolve
Post do canal grátis na sexta	Agendamento
Aviso de pausa nas férias	Agendamento
Lembrete antes do vencimento	Automação
Recuperação de compra parada	Automação
Boas-vindas de quem entrou hoje	Automação
Contagem regressiva de oferta	Agendamento

A leitura da tabela é uma pergunta só: essa mensagem depende de o relógio bater ou de alguém ter feito alguma coisa? Se depende do relógio, agende. Se depende de um ato do cliente, não tente agendar, porque você vai acabar enviando para a pessoa errada. O passo a passo de montar a parte automatizada está em como automatizar a venda VIP no Telegram.

As quatro operações da fila que vale conhecer

Resposta primeiro: a fila agendada não é uma caixa preta, e a documentação lista o que dá para fazer com ela depois que a mensagem já está lá.

São quatro operações, descritas na mesma página: consultar todas as mensagens na fila de um chat, consultar informações de mensagens específicas dessa fila, disparar imediatamente mensagens que estão nela e apagar mensagens da fila sem enviá-las. Há ainda um quinto caminho, pelo método de edição, que a página descreve como capaz de "modificar a data agendada de uma mensagem específica em uma fila de agendamento".

Na prática isso significa duas coisas úteis. A primeira é que um erro agendado é reversível: dá para apagar antes de sair, e a fila é por chat, então o estrago se localiza. A segunda é que uma programação inteira pode ser antecipada de uma vez, o que resolve o caso de a oferta precisar sair antes do previsto.

Contra-argumento honesto: nada disso torna o agendamento uma ferramenta ruim. Para publicação no canal gratuito, para manter presença durante uma ausência e para uma contagem regressiva de fim de oferta, ele é a ferramenta certa, mais barata e mais simples do que qualquer automação. O erro não é usar o agendamento, é usá-lo no lugar de uma decisão que depende do cliente. Quem vai se ausentar por mais tempo encontra o desenho completo em tirar férias vendendo no Telegram.

Erros comuns

• Agendar oferta de venda para o canal inteiro. Quem comprou ontem recebe a oferta hoje, porque a fila não lê estado de compra.
• Contar com a repetição sem ter Premium. A documentação condiciona a repetição automática a usuários Premium.
• Planejar repetição a cada três ou cinco dias. A lista de valores aceitos salta de um dia direto para sete.
• Programar repetição de álbum. O campo de repetição vale apenas para o envio de uma única mensagem.
• Confiar no envio quando a pessoa ficar online. Ele só existe em conversa privada e falha quando o último acesso está oculto.
• Testar agendando para dez segundos à frente. Abaixo desse limite, a mensagem é enviada na hora e o teste não testa nada.

Conclusão

Agendar mensagem no Telegram resolve o calendário, e resolve bem: a fila fica no servidor, dispensa o seu aplicativo aberto e permite apagar ou antecipar o que já está programado. O que ele não resolve é qualquer envio que dependa do que o cliente fez, porque a lista fechada de sete intervalos e a ausência de qualquer noção de estado de compra deixam isso fora do alcance por construção.

O próximo passo é separar a sua semana em duas colunas antes de programar qualquer coisa: de um lado, o que sai por relógio, e vai para a fila agendada; do outro, o que sai por evento, e precisa de automação ligada ao pagamento. Depois disso, garanta que o lado da automação esteja realmente ligado à venda, com liberação de acesso e lembrete de vencimento saindo sozinhos: crie sua conta e deixe o relógio cuidar só do que é do relógio.