Neste tutorial, você aprenderá como agendar a entrega de mensagens usando a API.
Existem duas maneiras de agendar a entrega de uma mensagem para um horário e/ou dia posterior: especificando a data e hora exatas em que deseja que ela seja enviada ou indicando quantos minutos, horas ou dias você gostaria de adiar a entrega.
🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Cadastre-se para um teste gratuito de 7 dias e comece em minutos!
Se você quiser enviar mensagens a partir de código, pode usar qualquer linguagem de programação para realizar requisições HTTPS à API. Abaixo está o testador de API ao vivo com exemplos de código prontos para uso em várias linguagens de programação.
Requisitos
- Ter um número do WhatsApp já vinculado à plataforma e online.
- Número de telefone do destinatário com prefixo internacional no formato E164. Exemplo:
+393517224449. Você pode validar o número de telefone aqui.
Endpoint da API
Neste tutorial usaremos o seguinte endpoint da API:
Preparar a requisição
URL alvo da API (POST)
https://api.wassenger.com/v1/messages
Cabeçalhos HTTPS obrigatórios
Content-Type: application/json
Token: ENTER API KEY HERE
Enviar uma mensagem em uma data específica no formato ISO8601
Exemplo de corpo da requisição
// This code requires you to have installed RestSharp package. // Documentation: https://restsharp.dev // Installation: https://www.nuget.org/packages/RestSharp
var client = new RestClient("https://api.wassenger.com/v1/messages"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Token", "API TOKEN GOES HERE"); request.AddParameter("application/json", "{\"phone\":\"+12345678909\",\"message\":\"This is a scheduled message to be sent to a phone number in 10 minutes\",\"deliverAt\":\"2025-01-07T12:29:03.131Z\"}", ParameterType.RequestBody); IRestResponse response = client.Execute(request);
Você também pode enviar mensagens agendadas para um chat em grupo:
// This code requires you to have installed RestSharp package. // Documentation: https://restsharp.dev // Installation: https://www.nuget.org/packages/RestSharp
var client = new RestClient("https://api.wassenger.com/v1/messages"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Token", "API TOKEN GOES HERE"); request.AddParameter("application/json", "{\"group\":\"${group_id}@g.us\",\"message\":\"This is a scheduled message to be sent tomorrow to a group chat. Date format is based on ISO 8601 format with default UTC time zone\",\"deliverAt\":\"2025-01-08T12:19:03.131Z\"}", ParameterType.RequestBody); IRestResponse response = client.Execute(request);
Adiar a entrega da mensagem por minutos, horas ou dias
Exemplo de corpo da requisição em formato JSON
Valores válidos seriam: 1m = em 1 minuto, 2h = em 2 horas, 15d = em 15 dias.
Os valores devem ser números inteiros, então se você precisar agendar uma mensagem para 1,5 horas, por exemplo, deve especificar 90m = em 90 minutos
// This code requires you to have installed RestSharp package. // Documentation: https://restsharp.dev // Installation: https://www.nuget.org/packages/RestSharp
var client = new RestClient("https://api.wassenger.com/v1/messages"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Token", "API TOKEN GOES HERE"); request.AddParameter("application/json", "{\"phone\":\"+12345678909\",\"message\":\"This is a scheduled message to be sent to a phone number in 10 minutes\",\"delayTo\":\"8h"}", ParameterType.RequestBody); IRestResponse response = client.Execute(request);
Alternativamente, você pode adiar a entrega da mensagem por uma determinada quantidade de segundos:
// This code requires you to have installed RestSharp package. // Documentation: https://restsharp.dev // Installation: https://www.nuget.org/packages/RestSharp
var client = new RestClient("https://api.wassenger.com/v1/messages"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Token", "API TOKEN GOES HERE"); request.AddParameter("application/json", "{\"phone\":\"+12345678909\",\"message\":\"This is a scheduled message to be sent to a phone number in 10 minutes\",\"delayTo\":\"180"}", ParameterType.RequestBody); IRestResponse response = client.Execute(request);
🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Cadastre-se para um teste gratuito de 7 dias e comece em minutos!
Teste de API ao vivo
Agora você pode testar, depurar e executar a API diretamente do seu navegador, explorar e experimentar mais exemplos de API e obter, com um clique, trechos de código prontos para uso disponíveis em mais de 15 linguagens de programação 😎
Experimente o testador de API ao vivo do Wassenger
Tem dúvidas? Confira as perguntas frequentes abaixo.
Perguntas frequentes
Como enviar mensagens para vários números de telefone
Você só precisa enviar várias requisições à API, uma por número de telefone destino.
Por exemplo, se você quiser enviar uma mensagem para 10 números de telefone, deve enviar 10 requisições HTTPS independentes para a API.
Não há opção para enviar múltiplas mensagens em uma única requisição de API.
Que tipo de mensagens podem ser enviadas?
Você pode enviar diferentes tipos de mensagens, incluindo texto, imagens, vídeos, emojis, áudio, gifs, localizações geográficas e documentos via API.
Confira outros tutoriais para mais informações.
Como validar se um número de telefone pode receber mensagens do WhatsApp
Você pode validar se um determinado número de telefone está vinculado a uma conta do WhatsApp e pode receber mensagens.
A API fornece um endpoint que pode validar se um número de telefone existe no WhatsApp ou não.
O único requisito é ter pelo menos um número do WhatsApp conectado à plataforma na sua conta atual.
Para mais detalhes, por favor verifique a documentação do endpoint da API aqui.
Antes de verificar se um número de telefone existe no WhatsApp, você também pode validar e normalizar o formato de uma lista de números de telefone usando o endpoint de validação de números. Este endpoint apenas valida o formato correto E164, mas não verifica se o número de telefone efetivamente existe no WhatsApp ou não.
Observação: O número de validações de verificação do WhatsApp é limitado por mês com base no seu plano de assinatura. Por favor, verifique a tabela de preços para mais detalhes sobre os limites.
Procurando mais respostas? Confira as FAQs estendidas.
🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Cadastre-se para um teste gratuito de 7 dias e comece em minutos!
Recursos úteis adicionais
Documentação da API
Para mais detalhes sobre o endpoint da API, por favor confira o documento onde você encontrará todos os detalhes sobre os parâmetros de requisição aceitos, possíveis respostas de sucesso ou erro e exemplos de código prontos para uso em múltiplas linguagens de programação.
