# Modificar o perfil do telefone na nuvem

Atualiza a configuração de um ou mais Cloud Phones.
- **Pré-requisitos**: os telefones precisam pertencer à equipe. Os valores de região, idioma e coordenadas são validados por serviço, exatamente como na criação. Mover um telefone para um grupo ao qual você não tem autorização é rejeitado.
- **Efeito**: sobrescreve as configurações do telefone e reaplica a configuração de GPS; pode criar vínculos de etiquetas. Nada é cobrado e a concorrência não é afetada.
- **Conclusão**: sincrônica e idempotente para o mesmo corpo.

Endpoint: POST /api/cloudphone/edit/batch
Version: 2026-09-05

## Request fields (application/json):

  - `id` (array, required)
    IDs dos Cloud Phones

  - `envName` (string)
    Nome do Cloud Phone (no máximo 64 caracteres)

  - `phoneNumber` (string)
    Número de telefone personalizado. Requisitos de formato: precisa começar com um sinal +, o código do país precisa ter de 1 a 3 dígitos (excluindo 86), o comprimento total precisa ter de 8 a 14 dígitos e só pode conter + e números.

  - `powerOnBillingStrategy` (integer)
    Método de cobrança de Cloud Phones não mensais (0: padrão, 1: apenas pacote paralelo)
    Enum: "0", "1"

  - `proxyId` (string)
    ID do proxy

  - `groupId` (string)
    ID do grupo de ambientes

  - `groupName` (string)
    Nome de um grupo existente, ou o nome de um novo grupo a ser criado quando nenhum corresponder.

  - `tags` (array)
    Nomes de etiquetas de substituição. Valores vazios são ignorados.

  - `envRemark` (string)
    Observação do ambiente (no máximo 1500 caracteres, aceita quebras de linha)

  - `automaticGeo` (boolean)
    Geolocalização automática

  - `automaticLanguage` (boolean)
    Idioma automático

  - `automaticLocation` (boolean)
    Localização automática (fuso horário e país)

  - `country` (string)
    País

  - `timezone` (string)
    Fuso horário

  - `language` (string)
    Idioma

  - `latitude` (number)
    Latitude

  - `longitude` (number)
    Longitude

  - `enableRoot` (boolean)
    Ativar ROOT global

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado retornado: 0, Normal. Outros códigos são exceções.

  - `msg` (string | null, required)
    Mensagem de erro

  - `requestId` (string, required)
    ID da solicitação de operação