Referência da API

Crie agentes de vendas com IA de forma programática usando a API REST da AutoManus.

URL base

https://automanus.io/api/v1/public

POST

/agents

Crie um novo agente de vendas com IA a partir da URL de um site ou de um contexto estruturado do código.

Corpo da requisição

Campo	Tipo	Obrigatório	Descrição
email	string	Sim	Endereço de e-mail da conta proprietária do agente.
company_name	string	Sim	Nome da empresa que o agente representa.
website_url	string	Não	Site do qual extrair conhecimento. Use este campo ou codebase_context.
codebase_context	object	Não	Dados estruturados do produto e da empresa. Use este campo ou website_url.
agent_name	string	Não	Nome personalizado do agente. Por padrão, um nome é gerado.
source	string	Não	Origem da requisição, por exemplo cursor ou claude_code.

Exemplo: modo site

curl -X POST https://automanus.io/api/v1/public/agents \
  -H "Content-Type: application/json" \
  -d '{
    "email": "founder@startup.com",
    "company_name": "TechStartup",
    "website_url": "https://techstartup.com",
    "source": "cursor"
  }'

Exemplo: modo código

Passe o contexto estruturado diretamente quando não houver um site público para rastrear.

curl -X POST https://automanus.io/api/v1/public/agents \
  -H "Content-Type: application/json" \
  -d '{
    "email": "dev@startup.com",
    "company_name": "TechStartup",
    "codebase_context": {
      "company_description": "AI-powered platform for workflow automation",
      "value_proposition": "10x your productivity with AI",
      "products": [
        {
          "name": "Pro Plan",
          "description": "Full access to all AI features",
          "price": "$99/month"
        }
      ]
    },
    "source": "claude_code"
  }'

Resposta

{
  "success": true,
  "agent_id": "uuid-here",
  "agent_name": "TechStartup Assistant",
  "company_name": "TechStartup",
  "webchat_embed_code": "<script src=\"https://automanus.io/widget/automanus-chat.js\" data-widget-key=\"wc_abc123\"></script>",
  "webchat_widget_key": "wc_abc123",
  "whatsapp_link": "https://wa.me/16506053956?text=Hi!%20I'd%20like%20to%20talk%20to%20TechStartup",
  "is_new_user": true,
  "claim_url": "https://automanus.io/login?invite=token-here",
  "dashboard_url": "https://automanus.io/dashboard/ai-agent",
  "trial_info": {
    "expires_in_days": null,
    "message_limit": 100
  },
  "knowledge_base_count": 5
}

Campos da resposta

Campo	Descrição
webchat_embed_code	Tag de script pronta para colar que carrega o widget de chat no seu site.
whatsapp_link	Link de WhatsApp para conversar, já preenchido com uma saudação.
claim_url	Link que o usuário abre para reivindicar e gerenciar o novo agente.
trial_info.message_limit	Número de mensagens permitidas durante o período de teste.
knowledge_base_count	Número de itens da base de conhecimento criados para o agente.

Autenticação

Há duas formas de autenticar as requisições.

Baseada em e-mail (padrão)

Forneça um e-mail e o nome da empresa. Um agente de demonstração é criado e um link de reivindicação é retornado.

{
  "email": "you@company.com",
  "company_name": "Acme Corp"
}

Chave de API (usuários existentes)

Inclua o cabeçalho Authorization. O agente é criado na sua conta. Gere chaves em automanus.io/dashboard/settings/api.

curl -X POST https://automanus.io/api/v1/public/agents \
  -H "Authorization: Bearer ak_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"company_name": "Acme Corp", "website_url": "https://acme.com"}'

POST

/knowledge

Adicione um item à base de conhecimento de um agente existente. O conteúdo é incorporado para recuperação.

Corpo da requisição

Campo	Tipo	Obrigatório	Descrição
agent_id	string	Sim	ID do agente ao qual adicionar conhecimento.
title	string	Sim	Título curto do item de conhecimento.
content	string	Sim	O conteúdo de texto a ser armazenado e incorporado.
item_type	string	Não	faq, product, policy, or document
category	string	Não	Rótulo de categoria opcional para organizar os itens.

Exemplo

curl -X POST https://automanus.io/api/v1/public/knowledge \
  -H "Authorization: Bearer ak_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "uuid-from-create-agent",
    "title": "Pricing FAQ",
    "content": "Our Pro plan starts at $99/month with unlimited users.",
    "item_type": "faq",
    "category": "Pricing"
  }'

Resposta

{
  "success": true,
  "knowledge_item_id": "uuid-here",
  "agent_id": "uuid-here",
  "agent_name": "Company Assistant",
  "embedding_generated": true
}

Autenticação: Requer uma chave de API. O agente deve pertencer à sua conta. Para agentes de demonstração criados pelo fluxo de e-mail, não é necessária autenticação.

Limites de taxa

Limite	Valor
Agentes por e-mail por dia	10
Requisições por minuto	60

Códigos de erro

Status	Erro	Descrição
400	email and company_name are required	Campos obrigatórios estão faltando.
400	Invalid email format	O formato do e-mail é inválido.
401	Invalid API key	A chave de API está ausente ou é inválida.
409	An agent already exists for this website	Já existe um agente para este site.
429	Rate limit exceeded	Muitas requisições. Você atingiu o limite de taxa.

Exemplo de integração

Adicione o widget de chat na web ao seu site com um pequeno componente React.

// React component
import { useEffect } from 'react';

export function SalesChat({ widgetKey }) {
  useEffect(() => {
    const script = document.createElement('script');
    script.src = 'https://automanus.io/widget/automanus-chat.js';
    script.setAttribute('data-widget-key', widgetKey);
    script.async = true;
    document.body.appendChild(script);
    return () => document.body.removeChild(script);
  }, [widgetKey]);
  return null;
}