API de WhatsApp y CRM
PUT/devices/{deviceId}/profile/image

Actualizar imagen de perfil

Actualiza la imagen de avatar del perfil de la cuenta del número de WhatsApp.

API de WhatsApp y CRM
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
PUT https://api.getincloud.ai/v1/devices/{deviceId}/profile/image

Actualiza la imagen de avatar del perfil de la cuenta del número de WhatsApp. La imagen debe estar en formato JPEG o PNG y no superar 1 MB. El tamaño mínimo permitido de la imagen es de 192x192 píxeles. La sesión del dispositivo debe estar autorizada y en línea; de lo contrario, la llamada a la API devolverá un error. Este endpoint acepta cuerpos de solicitud POST en JSON o en binario sin procesar (application/octet-stream, image/*). Para cuerpos JSON, puedes definir la imagen mediante una URL remota (consulta el campo del cuerpo "url") o mediante una cadena Base64 en formato data URI (consulta el campo "image")


Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y juega con el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

CampoTipoObligatorioDescripción
urlstringNoURL de la imagen a descargar. Debe ser una URL http o https válida que apunte a un servidor accesible desde Internet. minLength: 6 · maxLength: 2000
imagestringNoContenido de la imagen como cadena codificada en Base64 en formato Data URI. Consulta el esquema data URI para obtener más información. maxLength: 1300000

Respuestas

CódigoDescripción
200Imagen actualizada correctamente
400Datos de consulta o de cuerpo de la solicitud no válidos
401Acceso no autorizado por token de API no válido o caducado
403Faltan permisos o el token de API
404Número no encontrado
409Conflicto
429Demasiadas solicitudes: inténtalo de nuevo más tarde
500Error inesperado
501No implementado
503Operación o sesión de WhatsApp no disponible: inténtalo de nuevo
// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Update WhatsApp account profile avatar image
curl --request PUT \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/profile/image \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"url":"https://via.placeholder.com/280"}'
AnteriorActualizar grupoSiguienteActualizar imagen del canal
¿Te sirvió esta página?