Como Agendar Uma Atualização de Status do WhatsApp Stories

20 de setembro de 2024

Aqui está tudo o que você precisa saber sobre o recurso Status do WhatsApp e como publicar atualizações automaticamente no seu número do WhatsApp para engajar melhor com seus clientes.

🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso de API e automatize qualquer coisa no WhatsApp inscrevendo-se para um teste gratuito e começando em minutos!

O que é o Status do WhatsApp?

WhatsApp Status, também conhecido como WhatsApp Stories (semelhante aos Instagram Stories) é um recurso que permite publicar atualizações de status no perfil que desaparecem após 24 horas. Você pode publicar fotos, vídeos, texto, links e GIFs.

Se você sabe usar os Instagram Stories, vai se sentir em casa. Você aprenderá rapidamente como ver o status do WhatsApp de um amigo e atualizar o seu.

Por padrão, o Status do WhatsApp só é ativado entre dois usuários que tenham os detalhes de contato um do outro salvos em suas respectivas agendas. Se você não tiver o número de alguém nos seus contatos, essa pessoa não poderá ver sua mensagem de status.

Dito isso, hoje apresentamos a maneira mais eficaz de agendar seus stories do WhatsApp para que você possa manter seus clientes/contatos informados de todas as novidades da sua marca. Descubra como é fácil com Wassenger

Veja como enviar um novo status (story) do WhatsApp em minutos aqui

Observação: o recurso de API de status do WhatsApp está disponível apenas nos planos Platform. Se quiser usar, por favor atualize seu plano.

Requisitos

Endpoint da API

Usaremos o seguinte endpoint da API para atualizar o status do WhatsApp:

Preparar a requisição

URL alvo da API usando o método POST

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

Cabeçalhos HTTPS obrigatórios > Obtenha sua chave de API aqui

Content-Type: application/json
Token: $API_TOKEN

Use o corpo em formato JSON para uma atualização de imagem

{
  "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"
  }
}

Use o corpo em formato JSON para uma atualização de vídeo

{
  "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"
  }
}

Use o corpo em formato JSON com parâmetros extras como fonte do texto ou cor de fundo

Observação: Ao enviar imagens, o parâmetro colour não pode ser adicionado

{
"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", 
}

🖥️ Procurando um exemplo de código? Vá para o testador ao vivo da API e obtenha exemplos de código prontos para uso em mais de 15 linguagens de programação, incluindo Python, JavaScript, PHP, C#, Java, Ruby, Go, Powershell, cURL e mais.

🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Inscreva-se para um teste gratuito de 7 dias e comece em minutos!

Faça o upload do status usando código

Explore como usar o código no seu navegador sem instalar qualquer software.

Além disso, você pode encontrar diferentes linguagens que pode testar em Replit.com:

Python

Publicar uma imagem agendada

# 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 um vídeo agendado

# 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 é uma solução completa de API para WhatsApp. Inscreva-se para um teste gratuito de 7 dias e comece em minutos!

Publicar uma imagem agendada

<?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 um vídeo agendado

<?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 uma imagem agendada

// 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 um vídeo agendado

// 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 uma imagem agendada

// 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 um vídeo agendado

// 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();

Precisa de mais? Explore todos os nossos exemplos de status do WhatsApp e vá com tudo!

🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso de API e automatize qualquer coisa no WhatsApp inscrevendo-se para um teste gratuito e começando em minutos!

Teste ao vivo usando a API

Explore nosso testador ao vivo da API

Perguntas Frequentes

Como o processamento de atualizações de status funciona

  • Por padrão, as atualizações de status do WhatsApp são processadas em tempo real, a menos que sejam especificadas como agendadas ou atrasadas.
  • Quando as atualizações de status são agendadas, elas são armazenadas em uma fila em ordem não estrita primeiro a entrar, primeiro a sair (FIFO).
  • A ordem estrita pode ser aplicada especificando o campo order = true no payload JSON (exemplo).

É possível usar variáveis de template em mensagens de status?

Não, a sintaxe de variáveis de template não é suportada em mensagens de status de usuário.

Tenho vários números conectados: como enviar mensagens por um número específico?

Se você tiver vários números conectados à sua conta, precisa especificar o campo device no corpo JSON com o ID do dispositivo do número do WhatsApp (valor hexadecimal de 24 caracteres) que deseja usar para enviar as mensagens.

Se o campo device não for especificado, as mensagens serão enviadas pelo primeiro número do WhatsApp conectado na sua conta.

Aqui está um exemplo de como enviar uma mensagem através de um número específico do WhatsApp

Como enviar mensagens para vários números de telefone

Você 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 há opção para enviar múltiplas mensagens em uma única requisição de API.

Como validar se um número de telefone pode receber mensagens do WhatsApp

Você pode validar se um número de telefone informado 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 na sua conta atual.

Para mais detalhes, verifique 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 formato correto E164, mas não verifica se o número de telefone efetivamente existe no WhatsApp.

Observação: o número de validações de verificação do WhatsApp é limitado por mês com base no seu plano de assinatura. Consulte a tabela de preços para mais detalhes sobre os limites.

Recursos úteis adicionais

Documentação da API

Para mais detalhes sobre o endpoint da API, consulte a documentação onde você encontrará todos os detalhes sobre os parâmetros aceitos na requisição, possíveis respostas de sucesso ou erro e exemplos de código prontos para uso em múltiplas linguagens de programação:

Documentação da API - Wassenger Editar descriçãoapp.wassenger.com

🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Inscreva-se para um teste gratuito de 7 dias e comece em minutos!

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger

Get Started Free