Guias do produto

Lembretes

Os lembretes enviam a mesma mensagem de WhatsApp para um número ou grupo em uma programação que se repete, como todo dia útil às 9:00 ou no dia 1º de cada mês. Use-os para lembretes de pagamento, check-ins da equipe ou atualizações regulares.

Abra pelo menu Ferramentas → Lembretes Recorrentes na barra lateral ou acesse /reminders/.

Antes de começar#

Um plano que inclua lembretes. Caso contrário, ao salvar aparece "Upgrade your plan to use reminders feature" (faça upgrade do plano para usar lembretes).
Um número de WhatsApp mostrando Conectado nas configurações do WhatsApp.
Créditos no seu plano. Cada vez que um lembrete é executado, ele consome uma mensagem.

Criar um lembrete#

O card Create New Reminder (criar novo lembrete) fica no topo da página. Se estiver recolhido, clique no botão de seta do card para expandi-lo.

Dê um nome
Digite um Reminder Name (nome do lembrete), como Daily Follow-up.
Escolha o tipo de mensagem
Escolha o Message Type (tipo de mensagem): Text Message (mensagem de texto), Image + Text Message (imagem + mensagem de texto) ou File + Text Message (arquivo + mensagem de texto), e preencha Image URL (URL da imagem) ou File URL (URL do arquivo). Os destinatários veem a última parte do link do arquivo como nome do arquivo.
Escolha o número de envio (opcional)
Em WhatsApp Account (conta do WhatsApp), escolha um número conectado, ou deixe Select WhatsApp Account (Optional) (selecionar conta do WhatsApp, opcional) para usar seu primeiro número conectado sempre que o lembrete for executado.
Digite o destinatário
Em Phone Number / Group Name (número de telefone / nome do grupo), digite um número com código do país e apenas dígitos, como 919876543210, ou o nome exato de um grupo de WhatsApp.
Defina a programação
Em Schedule (Cron Expression) (programação, expressão cron), escolha uma opção pronta ou Custom Cron Expression (expressão cron personalizada). Veja Opções de programação.
Escolha o fuso horário
Escolha o Timezone (fuso horário) da sua programação. Sua última escolha é lembrada para a próxima vez.
Escreva a mensagem e salve
Escreva o Message Template (modelo de mensagem), com variáveis se quiser, e clique em Create Reminder (criar lembrete). Você verá "Reminder created successfully" (lembrete criado com sucesso).

Opções de programação#

A programação é uma expressão cron: cinco valores para minute (minuto), hour (hora), day of month (dia do mês), month (mês) e weekday (dia da semana), separados por espaços. Os dias da semana vão de 0 (domingo) a 6 (sábado). Cron Helper (ajuda do cron) na página lista exemplos, e Cron Generator (gerador de cron) abre o crontab.guru para montar uma expressão.

Opção pronta	Expressão
Daily at 9:00 AM (todo dia às 9:00)	`0 9 * * *`
Weekly on Monday at 9:00 AM (toda segunda-feira às 9:00)	`0 9 * * 1`
Monthly on 1st at 9:00 AM (todo dia 1º do mês às 9:00)	`0 9 1 * *`
Every 6 hours (a cada 6 horas)	`0 /6 * *`
Weekdays at 9:00 AM (dias úteis às 9:00)	`0 9 * * 1-5`

Mais exemplos:

Expressão	Executa
`0 0 * * *`	Todo dia à meia-noite
`30 8 * * 1-5`	8:30 nos dias úteis
`0 /3 * *`	A cada 3 horas
`0 12 1,15 * *`	12:00 nos dias 1º e 15

Em uma expressão, * significa qualquer valor, / define um intervalo de repetição, - uma faixa e , uma lista.

Fusos horários#

A programação é executada no fuso horário que você escolher, e o horário de verão é seguido automaticamente. A coluna Next Run (próxima execução) mostra o próximo horário nesse fuso. A lista inclui UTC, fusos dos EUA e do Canadá, Europe/London, Paris e Berlin, Asia/Kolkata, Dubai, Shanghai e Tokyo, Australia/Sydney e America/Sao_Paulo.

Os lembretes são verificados a cada minuto, e uma mensagem entra na fila quando chega o minuto programado. Se uma verificação atrasar, a execução ainda entra na fila até 10 minutos depois do horário programado (1 minuto na primeira execução de um lembrete), e nunca duas vezes. Depois ela é enviada assim que o número de envio estiver livre.

Variáveis da mensagem#

Estes marcadores são substituídos a cada execução do lembrete. Escreva-os com chaves simples, exatamente como mostrado:

Variável	Substituída por	Exemplo
`{reminder_name}`	O nome do lembrete	`Daily Follow-up`
`{to_number}`	O destinatário, como foi digitado	`919876543210`
`{organisation_name}`	O nome do seu espaço de trabalho	`Acme Store`
`{client_name}`	O nome do proprietário do espaço de trabalho	`Aman`
`{current_date}`	Data no fuso horário do lembrete	`2026-09-16`
`{current_date_formatted}`	Data por extenso, com o dia completado com zero	`September 06, 2026`
`{current_time}`	Hora no formato 24 horas	`09:00:00`
`{current_time_12h}`	Hora no formato 12 horas	`09:00 AM`
`{current_datetime}`	Data e hora	`2026-09-16 09:00:00`
`{timezone}`	O nome do fuso horário	`Asia/Kolkata`
`{timezone_short}`	Abreviação do fuso horário	`IST`

Por exemplo, Good morning team, here's the plan for {current_date_formatted}.

Gerenciar lembretes#

Your Reminders (seus lembretes) lista todos os lembretes com Name (nome), To (para), Type (tipo), Schedule (programação), Next Run, Status (Active ou Inactive, ou seja, ativo ou inativo) e a hora de Created (criação, em UTC). Os botões em Actions (ações) são ícones; passe o mouse sobre um deles para ver o nome:

Botão	O que faz
Edit (editar; lápis)	Abre Edit Reminder (editar lembrete) para alterar o nome, o tipo, o destinatário, a URL da imagem ou do arquivo, a programação, o fuso horário ou a mensagem, e para pausá-lo ou retomá-lo com a caixa de seleção Active (ativo). Ali, a programação é uma caixa de texto simples para a expressão cron, sem predefinições. Clique em Update Reminder (atualizar lembrete) para salvar.
Clone (clonar; dois quadrados)	Mostra os detalhes do lembrete. Yes, clone it! (sim, clonar) copia os dados para o formulário de criação com "(Copy)" adicionado ao nome, prontos para ajustar e salvar.
Toggle Status (alternar status; ícone de liga/desliga)	Pausa um lembrete ativo ou retoma um inativo.
Delete (excluir; lixeira)	Pergunta "Are you sure you want to delete this reminder?" (tem certeza de que deseja excluir este lembrete?). Clique em Yes, delete it! (sim, excluir).

Excluir ou pausar um lembrete não cancela uma mensagem que ele já colocou na fila. Cancele-a na página Relatórios.

Importar lembretes de um arquivo#

Prepare o arquivo
Clique em CSV Upload (upload de CSV) e depois em Sample Format (formato de exemplo) para ver as colunas, e baixe o arquivo de exemplo. Preencha um lembrete por linha. Não envie o exemplo como está: os links de imagem e de arquivo dele (example.com) são exemplos que não podem ser baixados, então substitua-os pelos seus próprios links ou exclua essas linhas. O arquivo também não tem a coluna timezone, e os valores de whatsapp_client_id (1, 2) não são seus, então essas linhas usam seu primeiro número conectado.
Faça o upload
Em Upload Reminders CSV (enviar CSV de lembretes), escolha seu arquivo .csv, .xls ou .xlsx e clique em Upload Reminders (enviar lembretes).
Confira o resultado
Você verá "Successfully created N reminders." (N lembretes criados com sucesso) com a quantidade de linhas ignoradas. Os lembretes importados começam como Active.

Coluna	Obrigatória	Valor
`reminder_name`	Sim	Um nome para o lembrete.
`phone`	Sim	Número com código do país ou um nome de grupo. `+`, espaços, traços, parênteses e um 0 à esquerda são removidos.
`message`	Sim	O texto da mensagem. As variáveis também funcionam aqui.
`cron_expression`	Sim	A programação, como `0 9 * * *`.
`timezone`	Não	Um nome de fuso horário, como `Asia/Kolkata`. Vazio significa UTC. Abreviações como `IST` não são aceitas. Veja a Referência de fusos horários.
`msg_type`	Não	`0` texto (padrão), `1` imagem ou `2` arquivo.
`img_url`	Não	Link da imagem, obrigatório quando `msg_type` é `1`.
`file_url`	Não	Link do arquivo de até 100 caracteres, obrigatório quando `msg_type` é `2`.
`whatsapp_client_id`	Não	O ID do Cliente WhatsApp de um número conectado. Vazio, desconhecido ou não conectado no momento significa seu primeiro número conectado a cada execução do lembrete.

Uma linha é ignorada quando a programação ou o fuso horário é inválido, quando msg_type é 1 sem img_url, quando msg_type é 2 sem file_url ou quando file_url tem mais de 100 caracteres. Qualquer outro valor de msg_type é tratado como texto.

Solução de problemas#

Mensagem ou problema	O que fazer
"name is required", "to_whatsapp_number is required", "message_template is required" ou "cron_expression is required" (campo obrigatório)	Preencha o campo que está faltando.
"Invalid cron expression" (expressão cron inválida)	Use cinco valores separados por espaços. Experimente o Cron Generator.
"Image URL is required for image messages" (URL da imagem é obrigatória para mensagens de imagem)	Adicione uma Image URL ou mude para Text Message.
"Invalid WhatsApp client" (cliente WhatsApp inválido)	O número escolhido desconectou. Recarregue a página e escolha um número conectado.
"Invalid timezone" (fuso horário inválido)	Escolha um fuso horário da lista.
"File URL is required for file messages" (URL do arquivo é obrigatória para mensagens com arquivo)	Adicione um File URL ou mude para Text Message.
"Error creating reminder: value too long…" ou "Error updating reminder: value too long…" (erro ao criar/atualizar o lembrete: valor longo demais)	O File URL tem mais de 100 caracteres. Use um link mais curto ou crie o lembrete pela API.
Um lembrete com arquivo criado pela API parou de anexar o arquivo	Ele foi editado ou clonado no painel, o que remove o link do arquivo. Cancele-o e crie-o de novo com a API de criação de lembretes.
"Please select a CSV file to upload." (selecione um arquivo CSV para enviar)	Escolha primeiro um arquivo em Upload Reminders CSV.
"Invalid file format. Only CSV, XLS, and XLSX files are supported." (formato de arquivo inválido)	Salve o arquivo como `.csv`, `.xls` ou `.xlsx`.
"An error occurred while uploading the CSV file" (ocorreu um erro ao enviar o arquivo CSV)	Verifique sua conexão, recarregue a página e faça o upload de novo.
"Missing required columns: …" (colunas obrigatórias ausentes)	Adicione ao arquivo os cabeçalhos de coluna listados, escritos exatamente assim.
"No valid reminders found in the CSV file. Please check the format and data." (nenhum lembrete válido encontrado no CSV)	Confira as programações, os fusos horários, as URLs de imagem e as URLs de arquivo em todas as linhas.
O lembrete não foi enviado	Confira se o status é Active, se Next Run é o esperado, se há um número Conectado e se ainda restam créditos. Uma execução é ignorada quando não há créditos. Se o lembrete não tiver um número de envio escolhido, a execução também é ignorada quando nenhum número está conectado. Se você escolheu um número específico e ele está desconectado, a mensagem ainda entra na fila e fica pendente. Se um lembrete mais antigo mostrar Active mas nunca enviar, clique em Toggle Status duas vezes (pausar e depois retomar).
Enviado no horário errado	Confira o Timezone e a hora na expressão cron.
A mensagem para um grupo falha	Use o nome exato do grupo e verifique se o número de envio é membro.