Listar execuções incompletas no Make, por uma API
Lista as execuções incompletas de um cenário, as que pararam por um erro e foram guardadas para nova tentativa, cada uma com id, motivo, data de criação, tentativas e se foi resolvida.
- Identificador
- make_list_incomplete_executions
A chamada
POST https://connect.reportei.com/api/tools/make_list_incomplete_executions/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"scenarioId": 1
}
}Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.
Parâmetros
As descrições dos parâmetros seguem a documentação oficial do app, em inglês.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| scenarioId | integer | Sim | Id of the scenario, from List scenarios. |
| status | string | Não | Returns only the incomplete executions with this status. scheduled means Make retries it on its own later.Valores: resolved, scheduled, inprogress, unresolved |
| createdFrom | integer | Não | Returns only those created at or after this Unix timestamp in milliseconds. |
| createdTo | integer | Não | Returns only those created at or before this Unix timestamp in milliseconds. |
Conexões possíveis
O seu cliente conecta a conta do Make uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.
Chave de API
O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.
Na conexão, o cliente informa também {zone}: o endereço da conta dele na API do app.
A resposta
Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.
Pronta para agentes de IA
O input desta tool é um JSON Schema, disponível em GET /api/tools/make_list_incomplete_executions. Ele vira a definição de tool do seu agente sem conversão.
Outras tools do Make
- Listar organizaçõesGETLista as organizações do usuário, cada uma com id e name. O id é o organizationId que as outras ferramentas pedem.
- Listar timesGETLista os times de uma organização, cada um com id e name. O id é o teamId de List scenarios.
- Listar cenáriosGETLista os cenários de um time ou de uma organização inteira: envie teamId ou organizationId, nunca os dois. Cada item traz o id e o name do cenário.
- Obter cenárioGETRetorna os detalhes de um cenário, como nome, time, agendamento e se está ativo.
- Atualizar cenárioPATCHRenomeia um cenário. O nome não precisa ser único.
- Ativar cenárioPOSTAtiva um cenário para que rode no seu agendamento. Um cenário agendado em intervalos regulares também roda na hora.
- Desativar cenárioPOSTDesativa um cenário, o que interrompe seu agendamento e a execução em andamento, se houver.
- Executar cenárioPOSTExecuta um cenário ativo agora, o que consome operações da organização. Retorna o executionId; com responsive true aguarda até 40 segundos e retorna também o status e as saídas do cenário. Uma organização ou time pausado responde 429 com o código IM310.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
