Referencia de la API

Crea agentes de ventas con IA mediante programación con la API REST de AutoManus.

URL base

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

POST

/agents

Crea un nuevo agente de ventas con IA a partir de la URL de un sitio web o de un contexto estructurado del código.

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
email	string	Sí	Dirección de correo de la cuenta propietaria del agente.
company_name	string	Sí	Nombre de la empresa que representa el agente.
website_url	string	No	Sitio web del que extraer conocimiento. Usa este campo o codebase_context.
codebase_context	object	No	Datos estructurados del producto y la empresa. Usa este campo o website_url.
agent_name	string	No	Nombre personalizado del agente. De forma predeterminada se genera uno.
source	string	No	Origen de la solicitud, por ejemplo cursor o claude_code.

Ejemplo: modo sitio web

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"
  }'

Ejemplo: modo código

Pasa el contexto estructurado directamente cuando no tengas un sitio web público que 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"
  }'

Respuesta

{
  "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 de la respuesta

Campo	Descripción
webchat_embed_code	Etiqueta de script lista para pegar que carga el widget de chat en tu sitio.
whatsapp_link	Enlace de WhatsApp para chatear, ya rellenado con un saludo.
claim_url	Enlace que abre el usuario para reclamar y gestionar el nuevo agente.
trial_info.message_limit	Número de mensajes permitidos durante el periodo de prueba.
knowledge_base_count	Número de elementos de la base de conocimiento creados para el agente.

Autenticación

Hay dos formas de autenticar las solicitudes.

Basada en correo (predeterminada)

Proporciona un correo y el nombre de la empresa. Se crea un agente de demostración y se devuelve un enlace de reclamación.

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

Clave de API (usuarios existentes)

Incluye el encabezado Authorization. El agente se crea en tu cuenta. Genera claves en 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

Añade un elemento a la base de conocimiento de un agente existente. El contenido se incrusta para su recuperación.

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
agent_id	string	Sí	ID del agente al que añadir conocimiento.
title	string	Sí	Título breve del elemento de conocimiento.
content	string	Sí	El contenido de texto que se va a almacenar e incrustar.
item_type	string	No	faq, product, policy, or document
category	string	No	Etiqueta de categoría opcional para organizar los elementos.

Ejemplo

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"
  }'

Respuesta

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

Autenticación: Requiere una clave de API. El agente debe pertenecer a tu cuenta. Para los agentes de demostración creados mediante el flujo de correo, no se requiere autenticación.

Límites de uso

Límite	Valor
Agentes por correo y día	10
Solicitudes por minuto	60

Códigos de error

Estado	Error	Descripción
400	email and company_name are required	Faltan campos obligatorios.
400	Invalid email format	El formato del correo no es válido.
401	Invalid API key	La clave de API falta o no es válida.
409	An agent already exists for this website	Ya existe un agente para este sitio web.
429	Rate limit exceeded	Demasiadas solicitudes. Has alcanzado el límite de uso.

Ejemplo de integración

Añade el widget de chat web a tu sitio con un pequeño componente de 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;
}