Référence de l'API

Créez des agents commerciaux IA par programmation avec l'API REST AutoManus.

URL de base

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

POST

/agents

Créez un nouvel agent commercial IA à partir de l'URL d'un site web ou d'un contexte de code structuré.

Corps de la requête

Champ	Type	Requis	Description
email	string	Oui	Adresse e-mail du compte propriétaire de l'agent.
company_name	string	Oui	Nom de l'entreprise représentée par l'agent.
website_url	string	Non	Site web à analyser pour la base de connaissances. Utilisez ce champ ou codebase_context.
codebase_context	object	Non	Informations structurées sur le produit et l'entreprise. Utilisez ce champ ou website_url.
agent_name	string	Non	Nom personnalisé de l'agent. Un nom est généré par défaut.
source	string	Non	Origine de la requête, par exemple cursor ou claude_code.

Exemple : mode site 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"
  }'

Exemple : mode code

Transmettez directement un contexte structuré lorsque vous n'avez pas de site web public à analyser.

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

Réponse

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

Champs de la réponse

Champ	Description
webchat_embed_code	Balise de script prête à coller qui charge le widget de chat sur votre site.
whatsapp_link	Lien WhatsApp de discussion, pré-rempli avec un message d'accueil.
claim_url	Lien que l'utilisateur ouvre pour récupérer et gérer le nouvel agent.
trial_info.message_limit	Nombre de messages autorisés pendant la période d'essai.
knowledge_base_count	Nombre d'éléments de la base de connaissances créés pour l'agent.

Authentification

Il existe deux façons d'authentifier les requêtes.

Basée sur l'e-mail (par défaut)

Fournissez un e-mail et un nom d'entreprise. Un agent de démonstration est créé et un lien de récupération est renvoyé.

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

Clé d'API (utilisateurs existants)

Incluez l'en-tête Authorization. L'agent est créé sous votre compte. Générez des clés sur 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

Ajoutez un élément de base de connaissances à un agent existant. Le contenu est vectorisé pour la recherche.

Corps de la requête

Champ	Type	Requis	Description
agent_id	string	Oui	ID de l'agent auquel ajouter des connaissances.
title	string	Oui	Titre court de l'élément de connaissance.
content	string	Oui	Le contenu textuel à stocker et à vectoriser.
item_type	string	Non	faq, product, policy, or document
category	string	Non	Étiquette de catégorie facultative pour organiser les éléments.

Exemple

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

Réponse

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

Authentification : Nécessite une clé d'API. L'agent doit appartenir à votre compte. Pour les agents de démonstration créés via le flux par e-mail, aucune authentification n'est requise.

Limites de débit

Limite	Valeur
Agents par e-mail et par jour	10
Requêtes par minute	60

Codes d'erreur

Statut	Erreur	Description
400	email and company_name are required	Des champs obligatoires sont manquants.
400	Invalid email format	Le format de l'e-mail est invalide.
401	Invalid API key	La clé d'API est absente ou invalide.
409	An agent already exists for this website	Un agent existe déjà pour ce site web.
429	Rate limit exceeded	Trop de requêtes. Vous avez atteint la limite de débit.

Exemple d'intégration

Ajoutez le widget de chat web à votre site avec un petit composant 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;
}