Sistema próprio da empresa

Ligar um ERP ou CRM interno pela API dele. Esta parte é para o time técnico.

1 min de leitura

Esta página é para quem cuida da parte técnica. Se você não sabe o que é a API do seu sistema, essa configuração é de outra pessoa — o resto da MAG funciona sem ela.

Se a operação vive num sistema feito em casa, dá pra ligar a MAG nele pela API. Ela passa a consultar e agir ali dentro como faz com Gmail ou Drive.

Onde fica

Em Fontes, no bloco Conectar um sistema próprio — que fica recolhido, porque não é caminho para a maioria das pessoas.

O que você precisa ter em mãos

O quêExemplo
Endereço da APIhttps://api.suaempresa.com
Como autenticaChave no cabeçalho, token, ou nenhuma
Operações a liberarConsultar pedido, listar chamados, abrir chamado

Definindo operações

Cada operação recebe um nome em português — é por ele que a MAG entende quando usar:

NomeMétodo e caminho
Consultar pedidoGET /pedidos/{id}
Listar chamados do clienteGET /clientes/{id}/chamados
Abrir chamadoPOST /chamados

Se você não definir nenhuma, ela recebe um acesso genérico e você explica na conversa o que pedir — funciona, mas rende menos.

Recomendação

Comece só com leitura. Depois de ver ela acertando, libere as operações que alteram dado. Alterações passam por Aprovações de qualquer forma.

O que pode dar errado

"Não consegui consultar agora." Quase sempre é a chave que expirou ou o endereço que mudou. Reconecte em Fontes.

Ela chama a operação errada. O nome está ambíguo. Renomeie para algo que descreva a intenção, não o endpoint.