Set a WhatsApp Profile Photo
curl --request PATCH \
--url https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"image_url": "<string>"
}
'import requests
url = "https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo"
payload = { "image_url": "<string>" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({image_url: '<string>'})
};
fetch('https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'image_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo"
payload := strings.NewReader("{\n \"image_url\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"image_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"image_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"profile": {
"updated": true
}
}{
"error": "<unknown>",
"message": "<unknown>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<unknown>",
"message": "<unknown>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<unknown>",
"message": "<unknown>"
}Configurar la foto de perfil de WhatsApp
Esta operación permite configurar la foto de perfil de WhatsApp en la cuenta autenticada de Nexor. Esta referencia documenta campos verificados de ruta, consulta y cuerpo JSON de nivel superior, códigos de estado observados y campos de respuesta de nivel superior. Las respuestas del proveedor o con estructuras anidadas profundas pueden permanecer abiertas.
PATCH
/
whatsapp-numbers
/
{id}
/
photo
Set a WhatsApp Profile Photo
curl --request PATCH \
--url https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"image_url": "<string>"
}
'import requests
url = "https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo"
payload = { "image_url": "<string>" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({image_url: '<string>'})
};
fetch('https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'image_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo"
payload := strings.NewReader("{\n \"image_url\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"image_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getnexor.ai/api/public/whatsapp-numbers/{id}/photo")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"image_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"profile": {
"updated": true
}
}{
"error": "<unknown>",
"message": "<unknown>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<unknown>",
"message": "<unknown>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<unknown>",
"message": "<unknown>"
}Notas de seguridad y comportamiento
- Solo se valida localmente el esquema de la URL; la descarga del proveedor no tiene validación local de IP pública ni de redirecciones de salida.
- La operación reemplaza la foto de perfil existente.
- La ruta no valida id como UUID.
Autorizaciones
API key for authentication. Keys are prefixed with nxr_live_.
Parámetros de ruta
WhatsApp-number row id.
Cuerpo
application/json
Public HTTPS image URL.
Pattern:
^https:Última modificación el 8 de septiembre de 2026
⌘I