Foto de perfil
Last update: 4 days ago by Irais Aguirre
Resumen para integración
- URL base:
https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services- Token: de administración, en el encabezado
Authorization: Bearer {{admin-token}}(cómo generarlo)- Endpoints en esta página:
POST /v1/profile/photo: Actualizar foto de perfil
Cambia la foto de perfil de un número de teléfono. La imagen se envía como bytes en el cuerpo de la petición.
Actualizar foto de perfil
Petición
Petición de Actualizar foto de perfil:
| URL | https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/profile/photo |
| Método | POST |
| Tipo | image/jpeg, image/jpg, image/png |
Encabezados
Encabezados de Actualizar foto de perfil:
| Nombre | Descripción | Tipo | Requerimientos |
|---|---|---|---|
| Content-Type | Tipo de la imagen. Los valores pueden ser:
| String | Obligatorio |
| Authorization | Token de administración. Consulta Generar Token de Autenticación. | String | Obligatorio |
| phone_number_id | Número de teléfono de la empresa, con código de país. Ejemplo: 5215500000000. | String | Obligatorio |
Cuerpo
Campos del cuerpo de Actualizar foto de perfil:
| Nombre | Descripción | Tipo | Requerimientos |
|---|---|---|---|
| Archivo de imagen | Bytes del archivo de imagen, enviados tal cual en el cuerpo de la petición. WhatsApp recorta y escala la foto a un cuadrado de máximo 640 px por lado y 5 MB. Las imágenes de menos de 192 px de alto o ancho pueden verse mal al redimensionarse, por lo que se recomienda una imagen de 640 x 640 px. | Binario | Obligatorio |
Ejemplo
Ejemplo completo de Actualizar foto de perfil:
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/profile/photo' \--header 'phone_number_id: 5215500000000' \--header 'Content-Type: image/jpeg' \--header 'Authorization: Bearer {{admin-token}}' \--data-binary '@/ruta/a/logo.jpg'
Respuesta
Respuesta de Actualizar foto de perfil:
| Nombre | Descripción | Tipo |
|---|---|---|
| code | Código de respuesta. Si la petición es correcta, el valor es 0. | Integer |
| detail | Detalle de la respuesta. Si la petición es correcta, el valor es "Success". | String |
{"code": 0,"detail": "Success"}
Nota: si Meta rechaza la imagen, el servicio responde con HTTP 200 y el cuerpo contiene code 15 ("Image is not valid, permitted formats are: JPEG, JPG and PNG"). Los clientes deben validar el campo code de la respuesta, no solo el código HTTP.