Resumen

Auth: TokenAccount o TokenInstance en cada ruta. Cada llamada valida la propiedad de la instancia. Esta sección cubre las rutas /api/profile/* para actualizar tu propio perfil, consultar perfiles de terceros y leer o actualizar la configuración de privacidad de WhatsApp.

Endpoints

Method	Path	Función
POST	`/api/profile/account/:instance`	Actualizar foto / nombre / estado
GET	`/api/profile/getAccount/:instance`	Obtener tu perfil o el de un tercero
GET	`/api/profile/getPrivacy/:instance`	Obtener configuración de privacidad
GET	`/api/profile/privacy/:instance`	Alias de `/getPrivacy`
POST	`/api/profile/privacy/:instance`	Actualizar privacidad

Estructura de privacidad

La API agrupa los ajustes en tres sub-objetos: visibility, privacy y permissions.

{
  "visibility": {
    "lastSeen": "contacts",
    "status": "all",
    "profile": "contacts",
    "online": "match_last_seen"
  },
  "privacy": {
    "readReceipts": "all"
  },
  "permissions": {
    "callAdd": "all",
    "groupAdd": "contacts"
  }
}

Valores aceptados por campo

Campo	Valores
`lastSeen` / `status` / `profile`	`all` / `contacts` / `contact_blacklist` / `none`
`online`	`all` / `match_last_seen`
`readReceipts`	`all` / `none`
`callAdd`	`all` / `known`
`groupAdd`	`all` / `contacts` / `contact_blacklist`

Modelo `AccountProfileData`

Respuesta de GET /getAccount:

{
  "profilePicture": "https://pps.whatsapp.net/...",
  "profileName": "João Silva",
  "profileStatus": "Disponivel",
  "phoneNumber": "5511999999999",
  "jid": "5511999999999@s.whatsapp.net",
  "lid": "199789077627112@lid"
}

Envoltorio de error

{
  "success": false,
  "error": { "message": "At least one field must be provided (profilePicture, profileName, or profileStatus)" }
}

Referencia de errores (resumen)

Categoría	Mensaje
Validación	`At least one field must be provided (profilePicture, profileName, or profileStatus)`
Validación	`At least one privacy setting must be provided`
Validación	`Invalid <field> value: <value>. Valid values: ...`
Estado	`Instance is not connected to WhatsApp`
Número	`Number not found or not registered on WhatsApp`
Número	`invalid LID format`
Falla	`failed to update <field> privacy: <reason>`

Actualizar cuenta

Cambia foto, nombre visible o estado.

Actualizar privacidad

Ajusta quién ve qué.

Introducción

Instancia

Eventos

Mensajes

Llamadas

Grupos

Comunidades

Newsletter

Perfil

Chat

Chatwoot

Typebot

Observabilidad

Endpoints

Estructura de privacidad

Valores aceptados por campo

Modelo `AccountProfileData`

Envoltorio de error

Referencia de errores (resumen)

Siguiente

Actualizar cuenta

Actualizar privacidad

​Endpoints

​Estructura de privacidad

​Valores aceptados por campo

​Modelo AccountProfileData

​Envoltorio de error

​Referencia de errores (resumen)

​Siguiente

Actualizar cuenta

Actualizar privacidad

Endpoints

Estructura de privacidad

Valores aceptados por campo

Modelo `AccountProfileData`

Envoltorio de error

Referencia de errores (resumen)

Siguiente