Referência da API

Documentação completa de todos os endpoints REST da plataforma Adalink AI.

Base URL: https://api.adalink.ai

Autenticação

Como autenticar suas requisições

Para falar com a API, você precisa de um token (uma chave de acesso). Faça login, pegue o token e use ele em toda chamada — como se fosse um crachá.

Autenticação

Gerenciamento de sessões, tokens e credenciais de acesso.

9 endpoints

Em uma frase

É como você "entra" na plataforma: criar conta, fazer login (com email, Google, Microsoft ou link mágico) e pegar a chave de acesso (token) para falar com a API.

Agentes

Criação, configuração e execução de agentes de IA.

7 endpoints

Em uma frase

Agentes são assistentes de IA configuráveis. Você dá um nome, escolhe o cérebro (modelo), explica o que ele faz e ele passa a responder do jeito que você quer.

Chat

Sessões de chat e mensagens com agentes.

4 endpoints

Em uma frase

Conversas com seus agentes. Cada conversa é uma "sessão" — você abre, manda mensagens e o agente responde, igual a um chat de mensageiro.

Base de Conhecimento

Bases de conhecimento e documentos para RAG (Retrieval-Augmented Generation).

5 endpoints

Em uma frase

Onde você ensina os agentes com seus próprios documentos. Faz upload de PDFs, manuais ou planilhas e o agente passa a responder com base neles — em vez de só com o conhecimento do modelo.

Workflows

Automações visuais com nós e conexões.

6 endpoints

Em uma frase

Receitas de automação. Você desenha um fluxo (passo 1, passo 2, passo 3...) ligando ações como "buscar dados", "chamar agente", "mandar e-mail" — e a plataforma executa do começo ao fim.

Ferramentas

Ferramentas e integrações disponíveis para agentes.

3 endpoints

Em uma frase

Habilidades extras que o agente pode usar — como buscar na web, ler um PDF, mandar e-mail. Você ativa a ferramenta no agente e ele decide quando usar.

Faturamento

Planos, créditos, faturas e pagamentos.

6 endpoints

Em uma frase

Tudo de cobrança: qual plano você está, quantos créditos restam, faturas anteriores e como mudar de plano.

Conexões

Integrações OAuth e conexões com serviços externos.

5 endpoints

Em uma frase

Onde a Adalink se "liga" às suas contas externas — Google Drive, Slack, GitHub etc. Você autoriza uma vez e os agentes passam a poder ler e escrever nesses serviços por você.

Modelos

Modelos de IA disponíveis na plataforma.

2 endpoints

Em uma frase

Os "cérebros" disponíveis para os seus agentes — Claude, GPT, Gemini etc. Aqui você descobre quais existem e quais habilidades cada um tem (visão, ferramentas, contexto longo).

Criação de Conteúdo

Geração de textos, imagens e outros conteúdos.

5 endpoints

Em uma frase

Pede para a IA criar coisas para você: textos, imagens, áudios. Útil para gerar peças de marketing, posts, narrações etc. sem precisar criar um agente dedicado.

Arquivos

Upload e gerenciamento de arquivos.

3 endpoints

Em uma frase

Onde os arquivos da sua organização ficam guardados. Você gera uma URL temporária para subir um arquivo direto no armazenamento, e depois usa onde quiser (em uma base de conhecimento, num chat, etc).

Notificações

Notificações em tempo real e configurações de alertas.

3 endpoints

Em uma frase

O sininho da plataforma. Lista o que aconteceu (uma execução terminou, um agente precisou de aprovação) e te deixa marcar como lido.

Organizações e Usuários

Gerenciamento de organizações, membros e permissões.

5 endpoints

Em uma frase

Sua empresa na plataforma. Quem está dentro, qual papel cada pessoa tem (admin, membro etc.) e como tirar ou promover gente.

Configurações

Preferências de conta e configurações da plataforma.

2 endpoints

Em uma frase

Suas preferências pessoais — tema (claro/escuro), idioma, e se quer receber e-mail. Cada usuário tem as suas.

Admin

Endpoints exclusivos para administradores da plataforma.

4 endpoints

Em uma frase

Funções restritas a administradores — listar todas as organizações, suspender contas, etc. Se você não é admin, não precisa se preocupar com essa seção.

Marketplace

Templates e agentes pré-configurados do marketplace.

2 endpoints

Em uma frase

Vitrine de agentes prontos. Você acha um template (ex: "Atendente de vendas") e instala na sua organização com um clique — sem precisar configurar do zero.

WhatsApp

Integração com WhatsApp Business API.

3 endpoints

Em uma frase

Conecta um número de WhatsApp Business à plataforma. Depois disso, mensagens recebidas no WhatsApp viram conversas com seus agentes — automaticamente.

Feature Flags

Flags de funcionalidades para controle de acesso a recursos.

1 endpoint

Em uma frase

Liga e desliga funcionalidades por usuário ou organização — útil para liberar uma feature nova só para alguns clientes ou planos antes de abrir para todo mundo.

Tema e Branding

Personalização visual e configurações de marca.

5 endpoints

Em uma frase

Deixa a plataforma com a cara da sua empresa — cor primária, logo, favicon. Útil principalmente para clientes white-label.

Observabilidade

Métricas, logs e saúde do sistema.

3 endpoints

Em uma frase

Como saber se está tudo bem. Métricas de uso, logs de erros e status dos serviços — para você acompanhar a saúde da sua operação na plataforma.