Aller au contenu
CommencerSe connecter
Pour les développeurs et les agents

Ce que vous pouvez connecter à NexiAgent.

Il n'y a pas d'API de gestion publique : les assistants se configurent dans le tableau de bord, ou nous les installons. Ce qui existe pour le code est ceci — et tout est décrit dans un seul fichier OpenAPI.

Référence de l'APILire la documentation

La surface publique

Démarrer en trois étapes

  1. 1Souscrivez au chat de support sur nexiagent.com/pricing. La clé du widget apparaît dans le tableau de bord dès que le paiement est confirmé.
  2. 2Dans le tableau de bord, autorisez le domaine de votre site. Sans cela, le widget n'apparaît pas — volontairement.
  3. 3Collez le code ci-dessous avant </body>. Pour votre propre intégration, appelez l'API du chat avec la même clé.
<script src="https://nexiagent.com/widget.js" data-site="pk_live_…" defer></script>
MethodPathNotes
GEThttps://nexiagent.com/api/chat/hello?k=pk_live_…Origin check + appearance · JSON
POSThttps://nexiagent.com/api/chat{ siteKey, visitorId, message, locale? } → SSE: start · delta · done · error
GEThttps://status.nexiagent.com/api/status.jsonPlatform status · JSON
POSThttps://your-endpoint.exampleWebhook · x-nexiagent-event · x-nexiagent-timestamp · x-nexiagent-signature

Authentification

Les points d'accès du chat ne portent aucun secret : ils identifient l'abonnement par la clé publique et n'acceptent que les requêtes dont l'en-tête Origin figure dans la liste des domaines autorisés. Les webhooks sont signés avec une clé que seul le tableau de bord affiche. Il n'existe pas de clés d'API de gestion.

Limites de requêtes

Les réponses portent les en-têtes RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset. Au-delà de la limite, la réponse est 429 avec Retry-After en secondes. Par défaut : 30 messages par minute et par IP, 60 par heure et par conversation, 60 chargements de /api/chat/hello par minute et par IP.

RateLimit-Limit: 30
RateLimit-Remaining: 27
RateLimit-Reset: 42
Retry-After: 42   (429 only)

Webhooks

Chaque envoi est un POST JSON avec trois en-têtes : x-nexiagent-event, x-nexiagent-timestamp et x-nexiagent-signature (HMAC-SHA256 de « timestamp.corps », en hexadécimal). Répondez 2xx en moins de 10 secondes ; sinon nous réessayons six fois sur une demi-journée. https uniquement, adresses publiques uniquement.

{
  "event": "booking.created",
  "at": "2026-08-07T10:32:11.204Z",
  "data": {
    "id": "bk_7Kd2",
    "kind": "booking",
    "channel": "voice",
    "contactName": "Ana Silva",
    "contactPhone": "+351910000000",
    "contactEmail": null,
    "scheduledFor": "2026-08-12T15:00:00.000Z",
    "notes": "Primeira consulta."
  }
}

Erreurs

Chaque erreur est un JSON avec un code stable dans « error », une phrase lisible dans « message » et, quand c'est utile, « docs » avec l'adresse de la documentation. Un chemin inconnu sous /api renvoie un 404 en JSON, jamais une page HTML.

{
  "error": "origin_not_allowed",
  "message": "This page's origin is not on the site's allowed-domains list. Add it in the panel.",
  "docs": "https://nexiagent.com/developers",
  "origin": "www.example.pt"
}

Pour les machines

Besoin d'une connexion à votre CRM, agenda ou facturation ?

Nous réalisons la connexion nous-mêmes, à partir de zéro, sur mesure pour votre système — sans services d'automatisation tiers. Elle est chiffrée à part, avant de commencer.

Parler à notre équipe