Actualizar la historia de estado de WhatsApp usando la API

18 de septiembre de 2024

Back to Blog

Automatiza tu estado de WhatsApp para mantener a tus contactos/clientes informados sobre tus últimas novedades

Actualizar tu estado de WhatsApp es más que una función divertida, es una herramienta potente para mantenerte conectado y generar interacción con tus contactos.

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

Ya sea que compartas una actualización rápida, un mensaje inspirador o un momento divertido, actualizar tu estado con regularidad ayuda a mantener relaciones y a mantener a tu red informada. Al igual que las historias de Instagram o Snapchat, el estado de WhatsApp te permite compartir momentos efímeros que desaparecen después de 24 horas, creando una sensación de inmediatez y conexión. Para empresas e individuos, un estado activo en WhatsApp puede mejorar la comunicación y añadir un toque personal a las interacciones diarias.

Nota: la función de API para el estado de WhatsApp solo está disponible en los planes Platform. Si deseas usarla, 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 de imagen

{
  "message": "This is a image caption message that can also include links: https://youtube.com",
  "media": {
    "url": "https://picsum.photos/seed/picsum/600/400"
  }
}

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

{
  "message": "This is a video caption message that can also include links: https://youtube.com",
  "media": {
    "url": "https://download.samplelib.com/mp4/sample-5s.mp4"
  }
}

🖥️ ¿Buscas un ejemplo de código? Ve al probador en vivo de la API y obtén ejemplos 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 API completa 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 ningún software.

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

Publicar una imagen

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/chat/66d1a54430541033/status"
payload = {
"message": "This is a image caption message that can also include links: https://youtube.com", 
"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

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/chat/66d1a54430541033/status"
payload = {
"message": "This is a image caption message that can also include links: https://youtube.com", 
"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())

Publicar una imagen

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/chat/66d1a544305410/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 image caption message that can also include links: https://youtube.com',
    '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

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/chat/66d1a5443054103/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 video caption message that can also include links: https://youtube.com',
    '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

// 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 video caption message that can also include links: https://youtube.com',
    'media' => [
      'url' => 'https://picsum.photos/seed/picsum/600/400',
    ],
  ])
);
$request->setRequestUrl(
  'https://api.wassenger.com/v1/chat/66d1a54430541033/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

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
// 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 video caption message that can also include links: https://youtube.com',
    'media' => [
      'url' => 'https://download.samplelib.com/mp4/sample-5s.mp4',
    ],
  ])
);
$request->setRequestUrl(
  'https://api.wassenger.com/v1/chat/66d1a54430541033/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

// 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/66d1a54430541033/status")
.header("Content-Type", "application/json")
.header("Token", "API TOKEN GOES HERE")
.body("{\"message\":\"This is a image caption message that can also include links: https://youtube.com\", \"media\":{\"url\":\"https://picsum.photos/seed/picsum/600/400\"}}")
.asString();

Publicar un video

// 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/66d1a5443054103/status")
.header("Content-Type", "application/json")
.header("Token", "API TOKEN GOES HERE")
.body("{\"message\":\"This is a video caption message that can also include links: https://youtube.com\", \"media\":{\"url\":\"https://download.samplelib.com/mp4/sample-5s.mp4\"}}")
.asString();

¿Necesitas más? ¡Explora todos nuestros ejemplos de estado de WhatsApp y dale con todo!

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

Prueba en vivo de la carga de archivos 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 demora.
  • Cuando las actualizaciones de estado están programadas, se almacenan en una cola en un orden no estricto primero en entrar, primero en salir (FIFO).
  • Se puede imponer 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 objetivo (valor hexadecimal de 24 caracteres) por el que deseas 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 específico de WhatsApp

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 deseas 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.

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 revisa la documentación del endpoint de la API aquí.

Antes de verificar 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 E.164, pero no comprueba si el número de teléfono existe efectivamente en WhatsApp.

Nota: El número de validaciones de comprobación de WhatsApp está limitado por mes según tu plan de suscripción. Por favor revisa 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 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:

https://app.wassenger.com/docs/#tag/User-Status/operation/getUserStatus

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