Saltar para o conteúdo
RPA
/
/
Chamar Modelo via HTTP
Last updated

1. Obter Autorização (Token OAuth2)

Antes de chamar qualquer API funcional, você deve trocar suas credenciais por um Token de Acesso JWT.

Requisição (cURL)

curl -i -X POST \
  https://api.morelogin.com/oauth2/token \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": 1672940217990530,
    "client_secret": "your_client_secret",
    "grant_type": "client_credentials"
  }'
```### Exemplo de Resposta


### Exemplo de Resposta```json
{
    "code": 0,
    "data": {
        "access_token": "eyJhbGciOiJIUzI1NiIsIn...",
        "token_type": "Bearer",
        "expires_in": 3600
    }
}

2. Executar Modelo do Cloud Phone

Use o access_token obtido na Etapa 1 para acionar um modelo RPA específico.

Requisição (cURL)

curl -i -X POST \
  https://api.morelogin.com/cloudphone/rpa/onceTask/save \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "cloudPhoneId": 16783319661123,
    "scheduleName": "test_automation",
    "templateId": 1678347487160256,
    "templateParameter": "{\"Video Caption\": \"Hello World\", \"AI Label\": true}",
    "description": "schedule description"
  }'

3. Detalhamento dos Parâmetros

Como obter os IDs?

  • Authorization: Obtido através do endpoint /oauth2/token.

  • cloudPhoneId: Encontrado no painel do MoreLogin Cloud Phone (ID numérico).

  • templateId: Encontrado no marketplace de modelos de automação ou na lista de modelos pessoais.

Entendendo o parâmetro templateParameter

Este é um objeto JSON em formato de string. Você deve definir as chaves com base nos requisitos do modelo e, em seguida, escapá-las como uma string.

Exemplo de Definição de Modelo:

{
    "Video Caption": "string",
    "AI Label": "boolean",
    "Product Id": "number",
    "Get Leads": "boolean",
    "Comment": "string"
}
```**Como mapear isso em sua solicitação:**

Para passar valores para a definição acima, o valor do seu parâmetro de modelo deve ser semelhante a este:

**```json
{
    "templateParameter": "{\"Video Caption\": \"My Title\", \"AI Label\": true, \"Product Id\": 12345}"
}

4. Tratamento de Erros

| Status | Possível Motivo |

| ---------------- | ------------------------------------------------------------ |

| 401 Não Autorizado | Token expirado ou credenciais do cliente inválidas. |

| 400 Requisição Inválida | cloudPhoneId inválido ou JSON malformado no parâmetro do modelo. |

| 404 Não Encontrado | O templateId não existe. |

Início Rápido em Python

import requests
import json

def run_morelogin_task():
    # 1. Auth
    auth_res = requests.post(
        "https://api.morelogin.com/oauth2/token",
        json={
            "client_id": 1672940217990530,
            "client_secret": "your_secret",
            "grant_type": "client_credentials"
        }
    )
    token = auth_res.json()['data']['access_token']

    # 2. Execute
    task_payload = {
        "cloudPhoneId": 16783319661123,
        "templateId": 1678347487160256,
        "templateParameter": json.dumps({
            "Video Caption": "My Post",
            "AI Label": True
        })
    }
    
    headers = {"Authorization": f"Bearer {token}"}
    response = requests.post(
        "https://api.morelogin.com/cloudphone/rpa/onceTask/save",
        json=task_payload,
        headers=headers
    )
    return response.json()

print(run_morelogin_task())

HTTP Request

Make