Integrações

A AGGU não precisa trabalhar sozinha.

A plataforma foi desenhada para trocar informações com outras ferramentas e serviços por meio de integrações, APIs, webhooks e mecanismos de importação/exportação conforme cada capacidade disponível.

Developer API

Anatomia de uma conexão

  1. AGGU
  2. ContratoO que pode ser trocado, em que formato e com qual escopo.
  3. ContextoDe qual organização, por quem e sobre qual cliente.
  4. RegistroO que foi trocado, quando e com qual resultado.
  5. Outro sistema

Mecanismos

Cada caminho tem um papel diferente.

API, webhooks, MCP e arquivos não são a mesma coisa com nomes diferentes. Muda quem começa a conversa e o que atravessa a conexão.

MecanismoQuem iniciaSentidoPara quê
APIDeveloper API Seu sistema SistemaAGGU Consultar e registrar informações quando o seu sistema precisa.
WebhooksEventos A AGGU AGGUSistema Avisar outro sistema quando algo muda.
MCPIA externa Uma ferramenta de IA IAAGGU Usar capacidades autorizadas, com o escopo de quem conectou.
ArquivosImportação/exportação Uma pessoa da equipe ArquivoAGGU Trazer ou levar dados em lote, com conferência.

Tipos de integração

Categorias, não um catálogo de logos.

Cada categoria usa os mecanismos que fazem sentido para ela. O que está disponível depende de cada capacidade e de cada serviço.

Escolha uma categoria

Representação de arquitetura. Não indica parceiros nem integrações prontas.

API

Quando o seu sistema precisa pedir, a API responde.

A Developer API foi especificada para expor capacidades da plataforma com autenticação, escopos e rastreabilidade. A resposta fica dentro do escopo: cada credencial enxerga só o que foi liberado para ela.

Ver a Developer API
Pedido Listar clientes da carteira
Credencial
Integração do escritório
Escopo
clients:read
Resposta Clientes da organização
Limite
Somente o que o escopo permite
Registro
Pedido identificado e registrado

Exemplo ilustrativo — endpoint final conforme documentação da API.

Webhooks

Quando algo muda, outro sistema pode precisar saber.

Um webhook leva o evento até o destino, assinado, com novas tentativas quando a entrega falha e histórico de cada tentativa.

Demonstração

  1. Evento
  2. Assinatura
  3. Entrega
  4. Retry
  5. Histórico
Entregas · solicitacao.concluidaDestino: sistema do escritório
Evento gerado
Solicitação #184 concluída · Comercial Lima
10:42:03
Assinado pela AGGU
O destino pode verificar a origem antes de aceitar
Assinado
Tentativa 1
O destino não respondeu a tempo
Falhou
Nova tentativa agendada
Espera crescente entre tentativas
Agendada
Tentativa 2
Recebido pelo destino
Entregue
Histórico
Tentativas, horários e respostas ficam registrados
2 tentativas

Dados ilustrativos. Detalhes de assinatura e política de novas tentativas conforme documentação da API.

Importação e exportação

Nem toda integração precisa ser em tempo real.

Planilhas, extratos e documentos podem entrar e sair em lote, com conferência antes de gravar. Os formatos aceitos dependem de cada área do produto.

Importar clientes · clientes.csv48 linhas
  1. Arquivo
  2. Mapeamento
  3. Prévia
  4. Confirmação
Coluna do arquivorazao_socialCampo AGGUNome do cliente Coluna do arquivocnpjCampo AGGUCNPJ
Padaria Horizonte Ltda
Linha 2 · pronta
OK
Oficina Avenida ME
Linha 3 · pronta
OK
Linha 14
CNPJ com dígito inválido · não será importada
Revisar
47 prontas · 1 para revisar · nada foi gravado aindaCancelarImportar 47 linhas

Dados ilustrativos. CSV, OFX e documentos aparecem onde cada área do produto os suporta.

Segurança

Conectar sistemas é fácil de demonstrar. Difícil é manter segurança, repetição segura e rastreabilidade.

  • AutenticaçãoToda chamada identifica quem está chamando.
  • EscoposCada credencial só alcança o que foi liberado.
  • IdempotênciaRepetir um pedido não duplica o resultado.
  • Limites de usoO volume é controlado para proteger a plataforma.
  • AuditoriaQuem fez, quando, com qual escopo e qual resultado.

MCP

Uma IA externa só alcança o que foi autorizado.

A arquitetura prevê acesso de ferramentas de IA externas via MCP, com autenticação e escopo consentido. Diferente da API, quem chama é uma IA agindo em nome de uma pessoa, com as permissões dessa pessoa.

IA e Automação
  1. 1IA externaFerramenta escolhida pela pessoa
  2. 2OAuthA pessoa se autentica
  3. 3EscopoConsentido pela pessoa
  4. 4MCP AGGUAplica escopo e permissões
  5. 5Capacidade autorizadaSomente o que passou

Mude o escopo consentido

  • Consultar clientes da carteira
  • Consultar documentos
  • Consultar obrigações e prazos
  • Criar solicitação ao cliente
  • Alterar cadastro do cliente
  • Excluir dados

Exemplo ilustrativo. Capacidades e escopos conforme disponibilidade da plataforma.

Conectada por dentro.Preparada para se conectar por fora.

Developer API
Demonstração

Solicitar demonstração

Ao enviar, você concorda com os Termos de Uso e declara que leu a Política de Privacidade.