En este tutorial aprenderás a programar la entrega de mensajes usando la API.
Hay dos formas de programar la entrega de un mensaje para un día y/o hora posterior: especificando el día y la hora exacta en que quieres que se envíe o indicando cuántos minutos, horas o días quieres retrasar la entrega diferida.
Si quieres enviar mensajes desde código, puedes usar cualquier lenguaje de programación para realizar solicitudes HTTPS a la API. A continuación está el probador de API en vivo con ejemplos de código listos para usar en varios lenguajes de programación.
Requisitos
- Tener un WhatsApp number ya vinculado a la plataforma y en línea.
- Número de teléfono del destinatario con prefijo internacional en formato E164. Ejemplo:
+393517224449. Puedes validar el número de teléfono aquí.
Endpoint de la API
En este tutorial utilizaremos el siguiente endpoint de la API:
Preparar la solicitud
URL de la API objetivo (POST)
https://api.wassenger.com/v1/messages
Encabezados HTTPS requeridos
Content-Type: application/json
Token: ENTER API KEY HERE
Enviar un mensaje en una fecha específica en formato ISO8601
Ejemplo de cuerpo de la solicitud en 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())
También puedes enviar mensajes programados a un chat grupal:
# 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())
Retrasar la entrega del mensaje por minutos, horas o días
Ejemplo de cuerpo de la solicitud en formato JSON
Valores válidos de ejemplo serían: 1m = en 1 minuto, 2h = en 2 horas, 15d = en 15 días.
Los valores deben ser números enteros, por lo que si necesitas programar un mensaje para 1,5 horas, por ejemplo, debes especificar 90m = en 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, puedes retrasar la entrega del mensaje por una cantidad 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())
Pruebas en vivo de la API
Ahora puedes jugar, depurar y probar la API en vivo directamente desde tu navegador, explorar y probar más ejemplos de la API y obtener con un clic fragmentos de código listos para usar disponibles en más de 15 lenguajes de programación 😎
Prueba el probador en vivo de la API de Wassenger
¿Tienes preguntas? Por favor consulta las preguntas frecuentes a continuación.
Preguntas frecuentes
Cómo enviar mensajes a múltiples números de teléfono
Solo tienes que enviar múltiples solicitudes a la API, una por cada número de teléfono objetivo.
Por ejemplo, si quieres enviar un mensaje a 10 números de teléfono, debes enviar 10 solicitudes HTTPS independientes a la API.
No hay opción para enviar múltiples mensajes en una sola solicitud a la API.
¿Qué tipo de mensajes se pueden enviar?
Puedes enviar diferentes tipos de mensajes, incluyendo texto, imágenes, videos, emojis, audio, gifs, ubicaciones geográficas y documentos de archivo vía API.
Consulta otros tutoriales para más información.
Cómo validar si un número de teléfono puede recibir mensajes de WhatsApp
Puedes validar si un número de teléfono dado está vinculado a una cuenta de WhatsApp y puede recibir mensajes.
La API proporciona un endpoint que puede validar si un número de teléfono dado existe en WhatsApp o no.
El único requisito es tener al menos un número de WhatsApp conectado a la plataforma en tu cuenta actual.
Para más detalles, por favor consulta la documentación del endpoint de la API aquí.
Antes de comprobar si un número de teléfono existe en WhatsApp, también puedes validar y normalizar el formato de una lista de números de teléfono usando el endpoint validador de números. Este endpoint solo valida el correcto formato E164, pero no verifica si el número de teléfono efectivamente existe en WhatsApp o no.
Nota: El número de validaciones de comprobación de WhatsApp está limitado por mes según tu plan de suscripción. Por favor consulta la tabla de precios para más detalles sobre los límites.
¿Buscas más respuestas? Consulta las FAQs extendidas.
Recursos útiles adicionales
Documentación de la API
Para más detalles sobre el endpoint de la API, por favor revisa el documento donde encontrarás todos los detalles sobre los parámetros de solicitud aceptados, posibles respuestas de éxito o error y ejemplos de código listos para usar en múltiples lenguajes de programación.
