Cómo programar una actualización de estado de WhatsApp Historias de WhatsApp

20 de septiembre de 2024

Back to Blog

Todo lo que necesitas saber sobre la función Estado de WhatsApp y cómo publicar actualizaciones automáticamente en tu número de WhatsApp para captar mejor a los clientes.

🤩 🤖 Wassenger es una plataforma completa de comunicación y solución de API para WhatsApp. Explora más de 100+ casos de uso de API y automatiza cualquier cosa en WhatsApp registrándote para una prueba gratuita y empezando en minutos!

¿Qué es el Estado de WhatsApp?

El Estado de WhatsApp, también conocido como Historias de WhatsApp (de forma similar a las Historias de Instagram), es una función que te permite publicar actualizaciones de estado de perfil que desaparecen después de 24 horas. Puedes publicar fotos, videos, texto, enlaces y GIFs.

Si sabes cómo usar las Historias de Instagram, te resultará familiar. Aprenderás rápidamente cómo ver el estado de WhatsApp de un amigo y actualizar el tuyo propio.

Por defecto, el Estado de WhatsApp solo se activa entre dos usuarios que se tienen guardados mutuamente en sus respectivas agendas de contactos. Si no tienes el número de alguien en tus contactos, esa persona no podrá ver tu mensaje de estado.

Dicho esto, hoy te presentamos la forma más efectiva de programar tus historias de WhatsApp para que puedas mantener a tus clientes/contactos informados de todas tus novedades y de tu marca. Descubre lo fácil que es con Wassenger

Consulta cómo subir un nuevo estado de WhatsApp (historia) en minutos aquí

Nota: La función API de estado de WhatsApp solo está disponible en los planes Platform. Si quieres utilizarla, por favor actualiza tu plan.

Requisitos

Endpoint de la API

Usaremos el siguiente endpoint de la API para actualizar el estado de WhatsApp:

Preparar la solicitud

URL objetivo de la API usando el método POST

https://api.wassenger.com/v1/chat/{deviceId}/status

Encabezados HTTPS requeridos > Obtén tu clave API aquí

Content-Type: application/json
Token: $API_TOKEN

Usa el cuerpo en formato JSON para una actualización con imagen

{
  "message": "This is a scheduled WhatsApp status update for tomorrow with an image",
  "schedule": {
    "date": "2024-09-21T10:53:24.998Z"
  },
  "media": {
    "url": "https://picsum.photos/seed/picsum/600/400"
  }
}

Usa el cuerpo en formato JSON para una actualización con video

{
  "message": "This is a scheduled WhatsApp status update for tomorrow with an image",
  "schedule": {
    "date": "2024-09-21T10:53:24.998Z"
  },
  "media": {
    "url": "https://download.samplelib.com/mp4/sample-5s.mp4"
  }
}

Usa el cuerpo en formato JSON con parámetros extra como actualización de fuente de texto o color de fondo

Nota: Al subir imágenes, el parámetro colour no se puede añadir

{
"message": "This is a scheduled WhatsApp status update for tomorrow with an image", 
"schedule": {
"date": "2024-09-21T10:53:24.998Z"
}, 
"font": "helvetica", 
"color": "red_purple", 
}

🖥️ ¿Buscas un ejemplo de código? Ve al probador en vivo de la API y obtén ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos Python, JavaScript, PHP, C#, Java, Ruby, Go, Powershell, cURL y más.

🤩 🤖 Wassenger es una solución completa de API para WhatsApp. Regístrate para una prueba gratuita de 7 días y comienza en minutos!

Subir el estado usando código

Explora cómo usar el código en tu navegador sin instalar software.

Además, puedes encontrar diferentes lenguajes que puedes probar en Replit.com:

Python

Publicar una imagen programada

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/chat/DEVICE_ID/status"
payload = {
"message": "This is a scheduled WhatsApp status update for tomorrow with an image", 
"schedule": { "date": "2024-09-21T10:53:24.998Z" }, 
"media": { "url": "https://picsum.photos/seed/picsum/600/400" }
}
headers = {
"Content-Type": "application/json", 
"Token": "API TOKEN GOES HERE"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

Publicar un video programado

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/chat/DEVICE_ID/status"
payload = {
"message": "This is a scheduled WhatsApp status update for tomorrow with an image", 
"schedule": { "date": "2024-09-21T10:53:24.998Z" }, 
"media": { "url": "https://download.samplelib.com/mp4/sample-5s.mp4" }
}
headers = {
"Content-Type": "application/json", 
"Token": "API TOKEN GOES HERE"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

🤩 🤖 Wassenger es una solución completa de API para WhatsApp. Regístrate para una prueba gratuita de 7 días y comienza en minutos!

Publicar una imagen programada

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/chat/DEVICE_ID/status',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode([
    'message' =>
      'This is a scheduled WhatsApp status update for tomorrow with an image',
    'schedule' => [
      'date' => '2024-09-21T10:53:24.998Z',
    ],
    'media' => [
      'url' => 'https://picsum.photos/seed/picsum/600/400',
    ],
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'Token: API TOKEN GOES HERE',
  ],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo 'cURL Error #:' . $err;
} else {
  echo $response;
}

Publicar un video programado

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/chat/DEVICE_ID/status',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode([
    'message' =>
      'This is a scheduled WhatsApp status update for tomorrow with an image',
    'schedule' => [
      'date' => '2024-09-21T10:53:24.998Z',
    ],
    'media' => [
      'url' => 'https://download.samplelib.com/mp4/sample-5s.mp4',
    ],
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'Token: API TOKEN GOES HERE',
  ],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo 'cURL Error #:' . $err;
} else {
  echo $response;
}

Publicar una imagen programada

// Examples requires to have installed pecl_http package, a simple and elegant HTTP client for PHP.
// Install it by running: pecl install pecl_http
// More information: https://pecl.php.net/package/pecl_http/3.2.0
<?php
$client = new http\Client();
$request = new http\Client\Request();
$body = new http\Message\Body();
$body->append(
  json_encode([
    'message' =>
      'This is a scheduled WhatsApp status update for tomorrow with an image',
    'schedule' => [
      'date' => '2024-09-21T10:53:24.998Z',
    ],
    'media' => [
      'url' => 'https://picsum.photos/seed/picsum/600/400',
    ],
  ])
);
$request->setRequestUrl('https://api.wassenger.com/v1/chat/DEVICE_ID/status');
$request->setRequestMethod('POST');
$request->setBody($body);
$request->setHeaders([
  'Content-Type' => 'application/json',
  'Token' => 'API TOKEN GOES HERE',
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

Publicar un video programado

// Examples requires to have installed pecl_http package, a simple and elegant HTTP client for PHP.
// Install it by running: pecl install pecl_http
// More information: https://pecl.php.net/package/pecl_http/3.2.0
<?php
$client = new http\Client();
$request = new http\Client\Request();
$body = new http\Message\Body();
$body->append(
  json_encode([
    'message' =>
      'This is a scheduled WhatsApp status update for tomorrow with an image',
    'schedule' => [
      'date' => '2024-09-21T10:53:24.998Z',
    ],
    'media' => [
      'url' => 'https://download.samplelib.com/mp4/sample-5s.mp4',
    ],
  ])
);
$request->setRequestUrl('https://api.wassenger.com/v1/chat/DEVICE_ID/status');
$request->setRequestMethod('POST');
$request->setBody($body);
$request->setHeaders([
  'Content-Type' => 'application/json',
  'Token' => 'API TOKEN GOES HERE',
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

Publicar una imagen programada

// This code requires you to have installed Unirest package.
// Documentation: https://kong.github.io/unirest-java/#requests
// Installation: http://kong.github.io/unirest-java/
HttpResponse<String> response = Unirest.post("https://api.wassenger.com/v1/chat/DEVICE_ID/status")
.header("Content-Type", "application/json")
.header("Token", "API TOKEN GOES HERE")
.body("{\"message\":\"This is a scheduled WhatsApp status update for tomorrow with an image\", \"schedule\":{\"date\":\"2024-09-21T10:53:24.998Z\"}, \"media\":{\"url\":\"https://picsum.photos/seed/picsum/600/400\"}}")
.asString();

Publicar un video programado

// This code requires you to have installed Unirest package.
// Documentation: https://kong.github.io/unirest-java/#requests
// Installation: http://kong.github.io/unirest-java/
HttpResponse<String> response = Unirest.post("https://api.wassenger.com/v1/chat/DEVICE_ID/status")
.header("Content-Type", "application/json")
.header("Token", "API TOKEN GOES HERE")
.body("{\"message\":\"This is a scheduled WhatsApp status update for tomorrow with an image\", \"schedule\":{\"date\":\"2024-09-21T10:53:24.998Z\"}, \"media\":{\"url\":\"https://picsum.photos/seed/picsum/600/400\"}}")
.asString();

¿Necesitas más? ¡Explora todos nuestros ejemplos de estado de WhatsApp y aprovecha al máximo!

🤩 🤖 Wassenger es una plataforma completa de comunicación y solución de API para WhatsApp. Explora más de 100+ casos de uso de API y automatiza cualquier cosa en WhatsApp registrándote para una prueba gratuita y empezando en minutos!

Pruebas en vivo usando la API

Explora nuestro probador en vivo de la API

Preguntas frecuentes

Cómo funciona el procesamiento de actualizaciones de estado

  • Por defecto, las actualizaciones de estado de WhatsApp se procesan en tiempo real a menos que se especifiquen como programadas o con retraso.
  • Cuando las actualizaciones de estado están programadas, se almacenan en una cola en orden no estricto primero en entrar, primero en salir (FIFO).
  • Se puede hacer cumplir un orden estricto especificando el campo order = true en el payload JSON (ejemplo).

¿Se pueden usar variables de plantilla en los mensajes de estado?

No, la sintaxis de variables de plantilla no es compatible en los mensajes de estado de usuario.

Tengo varios números conectados: ¿cómo enviar mensajes a través de un número específico?

Si tienes varios números conectados a tu cuenta, necesitas especificar el campo device en el cuerpo JSON con el ID del dispositivo del número de WhatsApp destino (valor hexadecimal de 24 caracteres) a través del cual quieres enviar los mensajes.

Si no se especifica el campo device, los mensajes se enviarán a través del primer número de WhatsApp conectado en tu cuenta.

Aquí tienes un ejemplo de cómo enviar un mensaje a través de un número de WhatsApp específico

Cómo enviar mensajes a varios números de teléfono

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 de la API.

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 formato correcto E164, pero no verifica si el número de teléfono existe efectivamente en WhatsApp.

Nota: El número de validaciones de comprobación en 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.

Otros recursos útiles

Documentación de la API

Para más detalles sobre el endpoint de la API, por favor consulta la documentación 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:

Documentación API - Wassenger Edit descriptionapp.wassenger.com

🤩 🤖 Wassenger es una solución completa de API para WhatsApp. Regístrate para una prueba gratuita de 7 días y comienza en minutos!

More Articles & Tutorials

How Clinics Are Saving Up 25 Hours Weekly With WhatsApp Automation

Cómo Las Clínicas Ahorran Hasta 25 Horas Semanales Con Automatización de WhatsApp

October 21, 2025
How Real Estate Agents Are Conquering The Market By Automating WhatsApp

Cómo los Agentes Inmobiliarios Están Conquistando El Mercado Automatizando WhatsApp

October 17, 2025
Connect WhatsApp With AI In 5 Minutes MCP

Conecta WhatsApp con IA en 5 minutos MCP

October 10, 2025
How To Build A WhatsApp Group Moderator With AI

Cómo construir un moderador de grupo de WhatsApp con IA

October 8, 2025
I Automated 50 WhatsApp Groups Here S The Code

Automatice 50 Grupos de WhatsApp Aquí Está el Código

October 6, 2025
How To Make Money With Wassenger Flows While Your Competitors Are Still Doing Everything Manually

Cómo Ganar Dinero Con Wassenger Flows Mientras Tus Competidores Siguen Haciendo Todo Manualmente

October 3, 2025

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger

Get Started Free