---
title: "Como trocar a foto do perfil do WhatsApp pela API (automaticamente) | api-wa.me"
description: "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."
url: "https://api-wa.me/blog/trocar-foto-perfil-whatsapp-api"
language: "pt-BR"
og:type: "article"
og:site_name: "WAME API"
---

[Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Como trocar a foto do perfil do WhatsApp pela API (automaticamente)

Raphael Serafim· Publicado em 14 de junho de 2026· 5 min de leitura

Compartilhar

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

Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/trocar-foto-perfil-whatsapp-api.md)

**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](https://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

Copiar

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

typescript

Copiar

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

Copiar

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

typescript

Copiar

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

Copiar

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

### Pronto para automatizar seu WhatsApp?

Crie sua conta gratuita e comece a enviar mensagens pela API em minutos.

[Começar grátis](https://portal.api-wa.me/sign-up)

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

## Continue lendo

[### Como criar um chatbot de IA com a API da OpenAI para responder no WhatsApp

Um webhook, uma chamada à API da OpenAI e uma resposta pela WAME API: o código completo de um chatbot de IA que atende no WhatsApp, Instagram e Messenger. Com memória por contato, controle de custo e o que fazer quando a IA não deve responder.](https://api-wa.me/blog/chatbot-ia-openai-whatsapp)[### Cobrança por Pix dentro do WhatsApp pela API: como enviar e o que muda na conversão

Mandar o código Pix no WhatsApp resolve o pior ponto da cobrança digital: o cliente não precisa sair do app. Como enviar a cobrança pela API, tratar a confirmação e evitar os erros que transformam a facilidade em suporte.](https://api-wa.me/blog/cobrar-pix-whatsapp-api)[### Erros da API do WhatsApp: o que cada um significa e como tratar

A mensagem não saiu e o log diz apenas 'erro ao enviar'. Os erros que você vai encontrar de verdade — janela fechada, número inválido, template não aprovado, limite atingido, instância caída — e o tratamento certo para cada um.](https://api-wa.me/blog/erros-api-whatsapp-como-tratar)

[Voltar ao blog](https://api-wa.me/blog)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "WAME API",
  "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram e Messenger",
  "url": "https://api-wa.me",
  "inLanguage": "pt-BR",
  "publisher": {
    "@id": "https://api-wa.me/#organization",
    "@type": "Organization",
    "name": "WAME API",
    "url": "https://api-wa.me"
  }
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://api-wa.me/#organization",
  "name": "WAME API",
  "alternateName": [
    "WAME",
    "Wame API",
    "wame.api.br",
    "api-wa.me"
  ],
  "url": "https://api-wa.me",
  "logo": {
    "@type": "ImageObject",
    "url": "https://api-wa.me/images/web-app-manifest-512x512.png",
    "width": 512,
    "height": 512
  },
  "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.",
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "INPI-BR",
    "name": "Pedido de registro de marca (INPI, classe NCL 42)",
    "value": "944724159"
  },
  "foundingDate": "2017",
  "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram e Messenger numa instância só. Desde 2017.",
  "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.",
  "knowsAbout": [
    "WhatsApp Cloud API oficial (Meta)",
    "API oficial de Instagram (Direct)",
    "API oficial de Messenger",
    "API multicanal Meta",
    "Meta Business Partner",
    "WhatsApp API",
    "API não oficial de WhatsApp",
    "automação de WhatsApp",
    "números virtuais",
    "webhooks"
  ],
  "sameAs": [
    "https://github.com/wame-api",
    "https://www.linkedin.com/company/wameapi",
    "https://www.instagram.com/wame.api/",
    "https://www.youtube.com/@wameapi"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "url": "https://api-wa.me/contact",
    "availableLanguage": [
      "Portuguese"
    ]
  }
}
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Como trocar a foto do perfil do WhatsApp pela API (automaticamente)",
  "description": "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.",
  "image": "https://api-wa.me/blog/trocar-foto-perfil-whatsapp-api/opengraph-image",
  "datePublished": "2026-06-14",
  "dateModified": "2026-06-14",
  "author": {
    "@type": "Person",
    "name": "Raphael Serafim",
    "url": "https://github.com/raphaelvserafim",
    "sameAs": [
      "https://github.com/raphaelvserafim"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "api-wa.me",
    "logo": {
      "@type": "ImageObject",
      "url": "https://api-wa.me/images/screenshot.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://api-wa.me/blog/trocar-foto-perfil-whatsapp-api"
  },
  "keywords": "como trocar a foto do perfil do whatsapp, trocar foto perfil whatsapp api, mudar foto de perfil whatsapp, atualizar foto perfil whatsapp automático, alterar perfil whatsapp api, trocar nome whatsapp api",
  "inLanguage": "pt-BR"
}
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://api-wa.me"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog da API do WhatsApp",
      "item": "https://api-wa.me/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Como trocar a foto do perfil do WhatsApp pela API (automaticamente)",
      "item": "https://api-wa.me/blog/trocar-foto-perfil-whatsapp-api"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Como trocar a foto do perfil do WhatsApp pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "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."
      }
    },
    {
      "@type": "Question",
      "name": "Posso trocar a foto de vários números do WhatsApp de uma vez?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "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."
      }
    },
    {
      "@type": "Question",
      "name": "Que tipo de imagem usar na foto de perfil pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "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."
      }
    },
    {
      "@type": "Question",
      "name": "Dá para mudar também o nome e o status (recado) pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "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."
      }
    },
    {
      "@type": "Question",
      "name": "Como remover a foto do perfil pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Faça uma requisição DELETE para /{key}/instance/profile/picture. A foto atual é removida e o perfil volta ao avatar padrão."
      }
    }
  ]
}
```