# Telefone em nuvem para startups

Liga um Cloud Phone.
- **Pré-requisitos**: o telefone precisa estar desligado no momento. É rejeitado quando o SKU foi retirado ou está em manutenção, quando o telefone está reservado por outro membro, enquanto o proxy dele ainda está sendo verificado, quando a conta está em débito ou o telefone está desativado, quando um período mensal expirou, e quando não há minutos gratuitos, vaga de concorrência nem saldo positivo disponíveis. Alguns modelos exigem, além disso, a última versão do cliente para Windows.
- **Efeito**: marca o telefone como inicializando, reserva-o para o membro que chama e reserva uma vaga de concorrência ou começa a consumir tempo. A resposta informa qual das duas foi usada.
- **Conclusão**: **aceito, não concluído.** Consulte `/cloudphone/info` até que `envStatus` seja ligado; uma falha aparece ali como `errorCode` e `errorMsg`. Membros com um host de callback configurado também recebem um webhook.
- **Nova tentativa**: uma segunda chamada simultânea é rejeitada de imediato em vez de entrar na fila. Depois de um timeout, leia `/cloudphone/info`; não reenvie.

Erros de negócio documentados: `33300`, `33309`, `33315`, `33316`, `33317`, `33318`, `33321`, `33322`, `33323`, `33324`, `33325`, `33346`, `33347`, `33367`, `33376`, `33407`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Endpoint: POST /cloudphone/powerOn
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)

  - `disableMoneySavingMode` (boolean)
    Desativar o modo de economia de energia, padrão: falso

## 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