# Como trocar a foto do perfil do WhatsApp pela API (automaticamente)

> Aprenda a trocar a foto do perfil do WhatsApp pela API, de forma automática e em vários números. Veja como atualizar foto, nome e status (recado) por código, com exemplos em cURL e Node.js.

**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):

```bash
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:

```ts
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**:

```bash
# 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:

```ts
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

```bash
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](/blog/como-criar-api-whatsapp) — conectar o número e começar;
- [Guia da API do WhatsApp: endpoints essenciais](/blog/guia-api-whatsapp-endpoints) — visão geral;
- [Documentação completa](/docs).

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