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 o dia e a hora exatos em que você deseja que ela seja enviada ou indicando quantos minutos, horas ou dias você gostaria de adiar a entrega.
Se você quiser enviar mensagens a partir do 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 E.164. 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 da API de destino (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 em formato JSON
# Examples requires to have installed requests Python package. # Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/messages"
payload = { "phone": "+12345678909", "message": "This is a scheduled message to be sent to a phone number in 10 minutes", "deliverAt": "2025-01-07T11:50:41.608Z" } headers = { "Content-Type": "application/json", "Token": "API KEY GOES HERE" }
response = requests.post(url, json=payload, headers=headers)
print(response.json())
Você também pode enviar mensagens agendadas para um grupo:
# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/messages"
payload = {
"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-08T11:40:41.608Z"
}
headers = {
"Content-Type": "application/json",
"Token": "API KEY GOES HERE"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
Adiar a entrega da mensagem por minutos, horas ou dias
Exemplo de corpo da requisição em formato JSON
Valores de exemplo 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, você deve especificar 90m = em 90 minutos
# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/messages"
payload = {
"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",
"schedule": { "delayTo": "1h" }
}
headers = {
"Content-Type": "application/json",
"Token": "API KEY GOES HERE"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
Alternativamente, você pode atrasar a entrega da mensagem por uma quantidade dada de segundos:
# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/messages"
payload = {
"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",
"schedule": { "delayTo": "180" }
}
headers = {
"Content-Type": "application/json",
"Token": "API KEY GOES HERE"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
Teste da API ao vivo
Agora você pode brincar, depurar e testar a API em tempo real 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 da Wassenger
Tem dúvidas? Por favor, consulte as perguntas frequentes abaixo.
Perguntas frequentes
Como enviar mensagens para vários números de telefone
Você só precisa enviar múltiplas requisições à API, uma por número de telefone alvo.
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 existe opção para enviar múltiplas mensagens em uma única requisição à 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 determinado número de telefone existe no WhatsApp ou não.
O único requisito é ter pelo menos um número do WhatsApp conectado à plataforma em sua conta atual.
Para mais detalhes, por favor consulte 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 validador de números. Este endpoint apenas valida o correto formato E.164, mas não verifica se o número de telefone efetivamente existe no WhatsApp ou não.
Nota: O número de validações de checagem no WhatsApp é limitado por mês com base no seu plano de assinatura. Por favor, consulte a tabela de preços para mais detalhes sobre os limites.
Procurando mais respostas? Confira as FAQs estendidas.
Recursos adicionais úteis
Documentação da API
Para mais detalhes sobre o endpoint da API, por favor verifique 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.
