Ferramentas de desenvolvimento
Make no seu produto e nos seus agentes de IA, por uma API
O toolkit do Make cobre organizações, times, cenários, logs de execução e execuções incompletas de uma zona do Make. Seu cliente conecta uma vez com uma API key, e seu produto ou agente de IA chama cada operação pelo Connect, que guarda a credencial e registra cada execução.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/make_activate_scenario/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"scenarioId": 1
}
}Como funciona
Do cliente conectado à primeira chamada no Make.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Make. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Make.
Disparar automações pelo seu produto
Execute o cenário de um cliente quando algo acontece no seu SaaS e aguarde o status e as saídas com responsive true.
Controlar cenários em uma tela de ajustes
Mostre os cenários de um cliente, renomeie e ligue ou desligue, para o usuário gerenciar automações sem abrir o Make.
Recuperar execuções com falha por agente
Deixe um agente de IA listar os logs e as execuções incompletas de um cenário, ler o erro e o módulo que o causou e tentar a execução de novo.
Tools
12 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.
- Listar logs do cenárioGETLista os logs de execução de um cenário, do mais novo ao mais antigo, cada um com o id da execução, status, duração, operações e transferência.
- Obter execução do cenárioGETRetorna o status de uma execução de um cenário, com as saídas do cenário, ou o erro e o módulo que o causou.
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.
Perguntas sobre o toolkit do Make
Preciso implementar a API do Make?
Não. O Connect já traz 12 tools do Make descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Make?
Pelo modo que o toolkit aceita: Chave de API. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
