Para trocar a foto do perfil do WhatsApp pela API, faça um PUT para /{key}/instance/profile/picture com o link público de uma imagem no campo url — a API baixa essa imagem e define como foto do número conectado. O grande ganho de fazer isso por código (em vez de pelo app) é a automação: você troca a foto de vários números de uma vez, padroniza a identidade visual da marca e até agenda mudanças, sem mexer celular por celular.

Este guia mostra como atualizar foto, nome e status (recado) pela api-wa.me.

Trocar a foto do perfil

Endpoint: PUT /{key}/instance/profile/picture, com o url da imagem (link público, de preferência quadrado):

curl -X PUT "https://us.api-wa.me/SUA_KEY/instance/profile/picture" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://seusite.com/logo-perfil.png" }'

Em Node.js, usando fetch:

await fetch("https://us.api-wa.me/SUA_KEY/instance/profile/picture", {
  method: "PUT",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://seusite.com/logo-perfil.png" }),
});

A imagem precisa estar acessível por uma URL pública (HTTPS). Use proporção 1:1 (quadrada) para evitar cortes.

Trocar o nome e o status (recado)

Já que você está no perfil, dá para padronizar também o nome de exibição e o status:

# Nome de exibição
curl -X PUT "https://us.api-wa.me/SUA_KEY/instance/profile/name" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Atendimento • Minha Empresa" }'

# Status / recado (aceita emoji)
curl -X PUT "https://us.api-wa.me/SUA_KEY/instance/status" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Atendimento 24h 🚀" }'

Trocar a foto de vários números de uma vez

Como cada número é uma instância com sua própria key, padronizar a marca em todos é só repetir a chamada:

const instancias = ["KEY_VENDAS", "KEY_SUPORTE", "KEY_FINANCEIRO"];
const fotoMarca = "https://seusite.com/logo-perfil.png";

for (const key of instancias) {
  await fetch(`https://us.api-wa.me/${key}/instance/profile/picture`, {
    method: "PUT",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ url: fotoMarca }),
  });
}

Perfeito para empresas com vários atendentes ou setores que precisam da mesma identidade visual.

Remover a foto do perfil

curl -X DELETE "https://us.api-wa.me/SUA_KEY/instance/profile/picture"

E pelo aplicativo (modo manual)?

Se você quer trocar a foto de um número e não precisa automatizar: abra o WhatsApp → Configurações → toque na sua foto → escolha câmera ou galeria. Simples — mas não escala. Para vários números ou troca programada, a API é o caminho.

Próximos passos

• Como criar e integrar uma API de WhatsApp — conectar o número e começar;
• Guia da API do WhatsApp: endpoints essenciais — visão geral;
• Documentação completa.

Perguntas frequentes

Como trocar a foto do perfil do WhatsApp pela API?+

Faça uma requisição PUT para /{key}/instance/profile/picture com o corpo JSON contendo 'url', que deve ser o link público de uma imagem. A API baixa a imagem e define como foto do perfil do número conectado.

Posso trocar a foto de vários números do WhatsApp de uma vez?+

Sim. Como cada número é uma instância identificada por uma 'key', basta repetir a chamada para cada instância. É ideal para padronizar a foto/marca em vários atendentes ou setores automaticamente.

Que tipo de imagem usar na foto de perfil pela API?+

Use uma imagem acessível por uma URL pública (HTTPS), preferencialmente quadrada (proporção 1:1) para não cortar. A API busca essa URL e aplica como foto do perfil.

Dá para mudar também o nome e o status (recado) pela API?+

Sim. Use PUT /{key}/instance/profile/name para o nome de exibição e PUT /{key}/instance/status para o texto de status (o 'Recado'). Ambos aceitam emojis.

Como remover a foto do perfil pela API?+

Faça uma requisição DELETE para /{key}/instance/profile/picture. A foto atual é removida e o perfil volta ao avatar padrão.