Atualizar História de Status do WhatsApp Usando a API

18 de setembro de 2024

Back to Blog

Automatize seu status do WhatsApp para manter seus contatos/clientes atualizados com suas últimas novidades

Atualizar seu status do WhatsApp é mais do que apenas uma funcionalidade divertida; é uma ferramenta poderosa para manter a conexão e engajar seus contatos.

🤩 🤖 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!

Seja compartilhando uma atualização rápida, uma mensagem inspiradora ou um momento descontraído, atualizar seu status regularmente ajuda a manter relacionamentos e manter sua rede informada. Assim como Instagram Stories ou Snapchat, o status do WhatsApp permite compartilhar momentos passageiros que desaparecem após 24 horas, criando uma sensação de imediaticidade e conexão. Para empresas e indivíduos, um status ativo no WhatsApp pode melhorar a comunicação e adicionar um toque pessoal às interações diárias.

Nota: o recurso de API para status do WhatsApp está disponível apenas nos planos Platform. Se você quiser usá-lo, por favor faça upgrade do 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 image caption message that can also include links: https://youtube.com",
  "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 video caption message that can also include links: https://youtube.com",
  "media": {
    "url": "https://download.samplelib.com/mp4/sample-5s.mp4"
  }
}

🖥️ Procurando um exemplo de código? Vá para o testador de API ao vivo e obtenha exemplos de código prontos para uso em 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!

Fazer upload do status usando código

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

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

Publicar uma imagem

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

# 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 uma imagem

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

# 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 uma imagem

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

# 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 uma imagem

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

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

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 do upload de arquivo usando a API

Explore nosso testador de API ao vivo

Perguntas Frequentes

Como funciona o processamento de atualização de status

  • Por padrão, atualizações de status do WhatsApp são processadas em tempo real, a menos que especificadas como agendadas ou com atraso.
  • Quando as atualizações de status são agendadas, elas são armazenadas em uma fila em ordem não estritamente FIFO (first-in-first-out).
  • A ordem estrita pode ser imposta especificando o campo order = true no payload JSON (exemplo).

Posso usar variáveis de template nas mensagens de status?

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

Tenho múltiplos números conectados: como enviar mensagens por um número específico?

Se você tiver vários números conectados à sua conta, é necessário especificar o campo device no corpo JSON com o ID do dispositivo do número do WhatsApp (valor hexadecimal de 24 caracteres) através do qual deseja 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 por 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, deverá enviar 10 requisições HTTPS independentes para a API.

Não há opção para enviar várias mensagens em uma única requisição à API.

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

Você pode validar se um determinado número de telefone 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, por favor consulte 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 (numbers validator API endpoint). Este endpoint apenas valida o formato correto E164 format, mas não verifica se o número de telefone efetivamente existe no WhatsApp.

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

Procurando mais respostas? Confira as FAQs estendidas.

Recursos adicionais úteis

Documentação da API

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

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

More Articles & Tutorials

How Clinics Are Saving Up 25 Hours Weekly With WhatsApp Automation

Como Clínicas Estão Economizando Até 25 Horas Semanais Com Automação WhatsApp

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

Como Corretores de Imóveis Estão Conquistando o Mercado Automatizando o WhatsApp

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

Conecte o WhatsApp com IA em 5 Minutos MCP

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

Como Construir Um Moderador De Grupo Do WhatsApp Com IA

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

Eu Automatizei 50 Grupos do WhatsApp Aqui Está o Código

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

Como Ganhar Dinheiro Com Flows do Wassenger Enquanto Seus Concorrentes Ainda Fazem Tudo Manualmente

October 3, 2025

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger

Get Started Free