Publicar estados programados de WhatsApp historias de WhatsApp con C NET

Aquí tienes 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 interactuar mejor con los clientes.

🤩 🤖 Wassenger es una plataforma de comunicación completa y una solución de 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!

¿Qué es el Estado de WhatsApp?

El Estado de WhatsApp, también conocido como Historias de WhatsApp (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 tienen los datos de contacto guardados en sus respectivas agendas. 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 de API para estado de WhatsApp solo está disponible en los planes Platform. Si quieres usarla, por favor actualiza tu plan.

Requisitos

Tener un número de WhatsApp ya vinculado a la plataforma y en línea.

Endpoint de la API

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

WhatsApp status

🤩 🤖 Usa el asistente de codificación AI de Wassenger para generar el código por ti! Haz clic aquí para usarlo 👉

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 API key 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 fuente de texto o color de fondo

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

{
"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, incluyendo 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 ningún software.

También, puedes encontrar diferentes lenguajes que puedes probar en Replit.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!

C# (RestClient)

Publicar una imagen programada

// 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/chat/device_id/status");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Token", "API KEY GOES HERE");
request.AddParameter("application/json", "{\"message\":\"This is a scheduled WhatsApp status update for tomorrow with an image\", \"schedule\":{\"date\":\"2025-04-15T09:33:16.137Z\"}, \"media\":{\"url\":\"https://picsum.photos/seed/picsum/600/400\"}}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

Publicar un video programado

// 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/chat/device_id/status");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Token", "API KEY GOES HERE");
request.AddParameter("application/json", "{\"message\":\"This is a scheduled WhatsApp status update for tomorrow with an image\", \"schedule\":{\"date\":\"2025-04-15T09:33:16.137Z\"}, \"media\":{\"url\":\"https://picsum.photos/seed/picsum/600/400\"}}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

C# (HttpClient)

Publicar una imagen programada

// This code uses the built-in HttpClient package in the.NET framework.
// Documentation: https://docs.microsoft.com/en-us/dotnet/api/system.net.http.httpclient?view=net-6.0
using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
Method = HttpMethod.Post, 
RequestUri = new Uri("https://api.wassenger.com/v1/chat/device_id/status"), 
Headers =
{
{ "Token", "API KEY GOES HERE" }, 
}, 
Content = new StringContent("{\"message\":\"This is a scheduled WhatsApp status update for tomorrow with an image\", \"schedule\":{\"date\":\"2025-04-15T09:33:16.137Z\"}, \"media\":{\"url\":\"https://picsum.photos/seed/picsum/600/400\"}}")
{
Headers =
{
ContentType = new MediaTypeHeaderValue("application/json")
}
}
};
using(var response = await client.SendAsync(request))
{
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}

Publicar un video programado

// This code uses the built-in HttpClient package in the.NET framework.
// Documentation: https://docs.microsoft.com/en-us/dotnet/api/system.net.http.httpclient?view=net-6.0
using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
Method = HttpMethod.Post, 
RequestUri = new Uri("https://api.wassenger.com/v1/chat/device_id/status"), 
Headers =
{
{ "Token", "API KEY GOES HERE" }, 
}, 
Content = new StringContent("{\"message\":\"This is a scheduled WhatsApp status update for tomorrow with an image\", \"schedule\":{\"date\":\"2025-04-15T09:33:16.137Z\"}, \"media\":{\"url\":\"https://picsum.photos/seed/picsum/600/400\"}}")
{
Headers =
{
ContentType = new MediaTypeHeaderValue("application/json")
}
}
};
using(var response = await client.SendAsync(request))
{
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}

🤩 🤖 Usa el asistente de codificación AI de Wassenger para generar el código por ti! Haz clic aquí para usarlo 👉

¿Necesitas más? ¡Explora todos nuestros ejemplos de estado de WhatsApp y lánzate!

🤩 🤖 Wassenger es una plataforma de comunicación completa y una solución de 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!

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 un orden FIFO no estricto (primero en entrar, primero en salir).
Se puede aplicar 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 de dispositivo del número de WhatsApp (valor hexadecimal de 24 caracteres) por el cual quieres enviar los mensajes.

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

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

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

Tienes que enviar múltiples solicitudes a la API, una por cada número de teléfono de destino.

Por ejemplo, si quieres enviar un mensaje a 10 números de teléfono, deberías enviar 10 solicitudes HTTPS independientes a la API.

No existe una 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 consulta 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 de validación de números. Este endpoint solo valida el formato correcto E164, 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 consulta la tabla de precios para más detalles sobre los límites.

Recursos útiles adicionales

Documentación de la API

Para más detalles sobre el endpoint de la API, por favor revisa 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!