Como gerenciar telefones Android em nuvem com Multilogin API
Você pode usar Multilogin API para gerenciar telefones Android em nuvem automaticamente. Crie, atualize, inicie, pare, organize e verifique telefones em nuvem sem realizar essas ações manualmente no painel. Isso é útil para equipes e desenvolvedores que gerenciam muitos telefones em nuvem ou conectam Multilogin com seus próprios fluxos de automação.
➡️ Para usar requisições de API para telefones em nuvem, abra coleção do Postman relacionada à Mobile Profile Management → Encontre a requisição que você precisa → Execute-a em seu script ou no Postman.
O que API pode gerenciar: configuração de telefone em nuvem, status, arquivos, aplicativos, tags, grupos e ações em massa.
O que API não faz: controlar ações dentro de aplicativos Android. Para automação de aplicativos, use ADB ou ferramentas como Appium.
Lembre-se de que esta é uma visão geral dos recursos e as explicações sobre sua configuração serão breves. Pressupõe-se que você já saiba usar o Postman em um nível básico. Recomendamos a leitura dos artigos abaixo antes de prosseguir.
- Como configurar a automação Multilogin com o Postman
- Como navegar na documentação API Multilogin com o Postman
Na documentação da Multilogin API, telefones Android em nuvem são chamados de perfis móveis.
As requisições estão agrupadas por tarefa, para que você possa encontrar rapidamente o que precisa. Todas estão disponíveis na pasta “Gestão de Perfis Móveis” na coleção da “Multilogin API”.
Quem pode usar essas API requisições?
- 👨💻 Proprietário da conta e todos os membros da equipe
- 💰 Disponível em planos Pro 10, Pro 50, Business 100 e todos os planos Business
Como gerenciar telefones em nuvem
Essas requisições cobrem as principais ações de telefones em nuvem.
Criar
Endpoint: Mobile Profile Create
Crie um ou mais telefones em nuvem sem configurá-los manualmente.
Você pode configurar valores como:
- Nome do telefone
- Versão do Android
- Marca e modelo do telefone
- Proxy
- Notas e tags
- Configurações de rede e localização
Um proxy é necessário ao criar um telefone em nuvem.
💡 Por que ajuda: cria muitos telefones em nuvem com a mesma configuração sem repetir a mesma configuração no painel.

Iniciar
Endpoint: Mobile Profile Start
A requisição inicia um ou mais telefones em nuvem sem uma interface gráfica. Isso é útil para fluxos de trabalho automatizados que não precisam da tela do telefone ao vivo.

Parar
Endpoint: Mobile Profile Stop
A requisição para um ou mais telefones em nuvem. Também útil para fluxos de trabalho de automação.

Atualizar
Endpoint: Mobile Profile Update
Você pode atualizar a configuração de um telefone em nuvem, incluindo sua marca e modelo, título, proxy, notas, tags e tipo de rede. Você precisará do ID do telefone em nuvem, que você pode obter no painel da Multilogin ou com GET Mobile Profile List.
💡 Por que ajuda: economiza tempo em atualizações em massa, para que você não precise editar cada telefone em nuvem manualmente no painel.

Excluir
Endpoint: Mobile Profile Delete
Remova telefones em nuvem pelos seus IDs. Use isso com cuidado se você automatizar fluxos de trabalho de limpeza.
💡 Por que ajuda: permite remover múltiplos telefones em nuvem como parte de um fluxo de trabalho de limpeza automatizado. Isso pode ajudar a liberar espaço em seu plano quando você precisa criar novos telefones em nuvem.

Como organizar telefones em nuvem
Essas requisições ajudam quando seu workspace começa a crescer.
Listar
Endpoint: Mobile Profile List
Use esta requisição para obter os telefones em nuvem no seu workspace.
A resposta fornece o ID do telefone em nuvem e detalhes de configuração, como dispositivo, localização, rede, proxy e informações de workspace.
💡 Por que ajuda: muitas outras requisições precisam de um ID de telefone em nuvem. Comece aqui quando você ainda não o tiver.
Bearer (ou token de automação) é suficiente para executar a requisição.

Verificar status
Endpoint: Mobile Profile Statuses
Exibe vários valores de status do telefone em nuvem, incluindo status de lançamento, tempo de execução, timestamp de auto-parada e status de ADB.
💡 Por que ajuda: permite monitorar o status do telefone em nuvem durante a automação, especialmente quando os perfis são iniciados sem a GUI.

Obter/criar grupo
Endpoint: Mobile Profile Group Get or Create
O ponto final retorna o grupo de telefones em nuvem (workspace) ou cria um novo.
💡 Por que ajuda: confirma que você está conectado ao workspace correto antes de continuar.

Atribuir tags
Endpoint: Mobile File Tag Assign
Você pode aplicar até 10 tags de uma vez. As tags são compartilhadas entre perfis de navegador e telefones em nuvem. Para encontrar uma tag, use POST Tag Search ponto final. Você também precisará do ID do telefone em nuvem.
💡 Por que ajuda: facilita a organização automática de telefones em nuvem e mantém conjuntos de perfis maiores mais fáceis de gerenciar.

Remover tags
Endpoint: Mobile File Tag Unassign
Assim como na atribuição de tags, você pode remover até 10 tags de uma vez. As tags são compartilhadas entre perfis de navegador e telefones em nuvem. Você pode se referir às requisições da API relacionadas a tags na pasta de gerenciamento de perfis, por exemplo, POST Tag Search. O ID do telefone em nuvem também é necessário.
💡 Por que ajuda: ajuda a manter sua organização de telefones em nuvem atualizada, removendo tags que você não precisa mais.

Como gerenciar aplicativos em telefones
Você também pode usar a API para encontrar e instalar aplicativos Android disponíveis.
Listar aplicativos
Endpoint: Mobile App List
Retorna a lista de aplicativos do marketplace de aplicativos. A resposta fornece o ID do aplicativo e os ID da versão. Você precisará desses valores para a instalação do aplicativo.
💡 Por que ajuda: fornece os ID do aplicativo e da versão necessários para a instalação automatizada do aplicativo.

Instalar aplicativos
Endpoint: Mobile App Install
O ponto final instala um aplicativo em lote em um grupo de telefones em nuvem. Use o ID do aplicativo e o ID da versão. Ele instala o aplicativo na pasta padrão. Você também pode usar o ponto final GET Mobile Profile Group Get or Create.
💡 Por que ajuda: permite instalar o mesmo aplicativo em vários telefones em nuvem sem configurar cada telefone manualmente.

Como usar a biblioteca de telefones
A biblioteca é um armazenamento em nuvem compartilhado para seus telefones em nuvem.
Use essas requisições para fazer upload, encontrar, organizar e remover arquivos.
Listar arquivos
Endpoint: Mobile File List
Obtenha arquivos armazenados na biblioteca. A resposta inclui ID de arquivos, que você precisa para requisições relacionadas a arquivos.

Fazer upload de um arquivo
Endpoint: Mobile File Upload
Faça upload de um arquivo para a biblioteca do telefone em nuvem. Você pode então usar o arquivo enviado em seus fluxos de trabalho móveis.
Nota: você pode procurar arquivos no Postman.
💡 Por que ajuda: permite adicionar arquivos à Biblioteca automaticamente para que seus telefones em nuvem possam acessá-los durante os fluxos de trabalho.

Excluir arquivos
Endpoint: Mobile File Delete
Exclua um ou mais arquivos da Biblioteca pelos seus ID. Obtenha os ID primeiro com POST Mobile File List.
💡 Por que ajuda: facilita a limpeza automática de arquivos da Biblioteca quando não são mais necessários.

Nota: a exclusão é imediata e não pode ser desfeita.
Tag arquivos
Endpoint: Mobile File Tag Assign
Você pode aplicar até 10 tags de uma vez. As tags são as mesmas para perfis de navegador e telefones em nuvem. Você pode se referir às requisições da API relacionadas a tags na pasta de gerenciamento de perfis, por exemplo, POST Tag Search. O ID do arquivo também é necessário (POST Mobile File List).
💡 Por que ajuda: ajuda a organizar arquivos da Biblioteca automaticamente, especialmente quando você gerencia muitos arquivos enviados.

Remover tags
Endpoint: Mobile File Tag Assign
Remova tags de um arquivo da Biblioteca. As tags são as mesmas para perfis de navegador e telefones em nuvem. Você pode consultar as solicitações relacionadas a tags na pasta de gerenciamento de perfis, por exemplo, POST Tag Search. O ID do arquivo também é necessário (POST Mobile File List).
💡 Por que isso ajuda: Ajuda a manter os arquivos da Biblioteca organizados, removendo tags que não são mais relevantes.

Como gerenciar telefones em massa
Essas solicitações ajudam quando você trabalha com conjuntos maiores de telefones em nuvem.
Exportar
Endpoint: Mobile Profile Export
A solicitação exporta dados de telefones em nuvem para um arquivo .xlsx. Você pode exportar até 200 telefones em nuvem de uma vez.
Nota: O resultado é apresentado como um arquivo. Se você usar o Postman, clique no menu de três pontos (próximo ao botão “Save Response”) e clique em “Save response to file”.
💡 Por que isso ajuda: Economiza tempo quando você precisa de dados de telefones em nuvem para relatórios, backup ou fluxos de trabalho em massa.

Importar
Baixar um modelo de importação
Endpoint: Import Template Download
Baixa um modelo .xlsx para importação em massa de telefones em nuvem. Preencha os dados e, em seguida, valide o arquivo usando o seguinte ponto final: POST Import Template Download
Nota: O resultado é apresentado como um arquivo. Se você usar o Postman, clique no menu de três pontos (próximo ao botão “Save Response”) e clique em “Save response to file”.
💡 Por que isso ajuda: Ele fornece a estrutura correta do arquivo para importação em massa de telefones em nuvem, o que ajuda a reduzir erros de formatação.

Validar um arquivo de importação
Endpoint: Import Template Download
Verifique seu .xlsx arquivo de importação antes de usá-lo.
Você pode construir o arquivo a partir de:
💡 Por que isso ajuda: A validação ajuda a evitar erros durante a importação em massa.

Transferir
Endpoint: Mobile Profile Transfer
Esta solicitação permite transferir perfis para outro membro da equipe em seu espaço de trabalho. Você pode transferir até 200 perfis de uma vez (os limites do seu plano atual também se aplicam).
Nota: a transferência é permanente e não pode ser desfeita.
💡 Por que isso ajuda: útil quando você move telefones em nuvem entre membros da equipe ou reorganiza a propriedade.

Como verificar limites e valores de configuração
Essas solicitações auxiliares fornecem os valores necessários para a configuração de telefones em nuvem.
Limite de uso do telefone
Endpoint: Mobile Profile Limit
Verifique a cota de minutos de telefones em nuvem do seu espaço de trabalho.
A resposta mostra seus minutos totais disponíveis, quantos minutos você já usou e quantos ainda restam.

Verificar proxy
Endpoint: Mobile Proxy Check
A solicitação testa a disponibilidade de um proxy e fornece informações adicionais, como IP, geolocalização, fuso horário e ISP.
💡 Por que isso ajuda: Permite testar um proxy antes de usá-lo com um telefone em nuvem, o que ajuda a identificar problemas de conexão ou localização precocemente.

Listar estados por país
Endpoint: States by Country
Use o código do país para obter a lista de estados. Você pode usá-los para a criação de telefones em nuvem.
💡 Por que isso ajuda: Fornece valores válidos de estados ou regiões para usar ao configurar os dados de localização do telefone em nuvem.

Listar cidades por estado
Endpoint: Cities by State
A solicitação retorna uma lista de cidades por estado ou região. Você pode usar os valores de estado desse ponto final: GET Estados por País.
💡 Por que isso ajuda: Fornece valores válidos de cidades para usar ao configurar os dados de localização do telefone em nuvem.

Listar marcas e modelos de telefones
Endpoint: Phone Brand List
Obtenha marcas e modelos de telefones suportados para uma versão do Android. Use os valores retornados ao personalizar a criação de telefones em nuvem.
💡 Por que isso ajuda: Fornece valores de marca e modelo suportados, para que você possa usar configurações de dispositivo válidas ao criar telefones em nuvem.

FAQ
O que significa “perfil móvel” na API?
Um perfil móvel é um telefone em nuvem Android no Multilogin.
A API usa “perfil móvel” em muitos nomes de solicitações e parâmetros.
Preciso do Postman para usar essas solicitações?
Não. Postman é útil para testar solicitações e verificar respostas sem construir um script completo.
Você também pode chamar as solicitações da Multilogin API a partir de sua própria automação.
Qual token devo usar?
Um token bearer regular funciona para API e expira após 30 minutos.
Para fluxos de trabalho de automação mais longos, você pode criar um token de automação com o período de expiração desejado.
Essas API solicitações podem automatizar ações dentro de aplicativos Android?
Essas solicitações ajudam principalmente a gerenciar os próprios telefones em nuvem.
Para automação de aplicativos Android nativos, conecte seus telefones em nuvem através do ADB e use ferramentas como Appium.
Posso criar vários telefones em nuvem Android com a API?
Sim, a solicitação Criar Perfil Móvel suporta a criação de telefones em nuvem sem configuração manual.
A API substitui o ADB ou Appium?
Não. A API gerencia telefones em nuvem. Use ADB e Appium para ações dentro de aplicativos Android.
Onde encontro meu ID do telefone em nuvem?
Use a GET Mobile Profile List ou copie-a do painel do Multilogin.