Skip to main content
GET
/
api
/
contacts
/
profile-picture
Obter URL da foto de perfil do contato
curl --request GET \
  --url https://{host}/api/contacts/profile-picture \
  --header 'apikey: <api-key>'
{
  "url": "https://pps.whatsapp.net/v/t61.24694-24/...",
  "id": "1234567890",
  "type": "image"
}

Descrição

Este endpoint retorna a URL da foto de perfil de um contato específico no WhatsApp. A URL retornada pode ser usada para baixar ou exibir a imagem de perfil.

Query Parameters

sessionId
string
required
ID da sessão autenticada
jid
string
required
Identificador do contato (JID do WhatsApp). Formato: 5511999999999@s.whatsapp.net
{
  "url": "https://pps.whatsapp.net/v/t61.24694-24/...",
  "id": "1234567890",
  "type": "image"
}

Códigos de Status

  • 200 - URL da foto retornada com sucesso
  • 400 - Parâmetros inválidos
  • 401 - Sessão não autorizada
  • 404 - Sessão, contato não encontrado ou contato sem foto de perfil

Exemplo de Uso

curl -X GET "https://api.wappfy.com.br/api/contacts/profile-picture?sessionId=my-session&jid=5511999999999@s.whatsapp.net"

Authorizations

apikey
string
header
required

Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)

Query Parameters

contactId
string
required
refresh
boolean
default:false

Atualizar a foto do servidor (cache de 24h por padrão). Não atualize se não for necessário, você pode ter erro de limite de taxa (Refresh the picture from the server (24h cache by default). Do not refresh if not needed, you can get rate limit error)

I