--- title: "Ce que vous pouvez connecter à NexiAgent." description: "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." url: "https://nexiagent.com/fr/developers" canonical: "https://nexiagent.com/fr/developers" lang: fr site: "NexiAgent" updated: "2026-11-02" --- # 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. ## La surface publique - **Widget de chat** — Une ligne de code sur votre site. La clé commence par pk_live_ et n'est pas secrète : ce qui décide qui peut utiliser le chat, c'est la liste des domaines autorisés dans le tableau de bord. - **API du chat** — Le point d'accès qu'utilise le widget. Vous pouvez l'appeler depuis votre propre site sans notre widget : envoyez le message, recevez la réponse en flux (SSE). - **Webhooks signés** — À partir du forfait Pro, chaque rendez-vous, message, contact et transfert à une personne est envoyé à une adresse à vous, signé en HMAC-SHA256. - **État de la plateforme** — Un JSON public avec l'état de chaque composant, pour une surveillance externe. ## Démarrer en trois étapes 1. Souscrivez 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. Dans le tableau de bord, autorisez le domaine de votre site. Sans cela, le widget n'apparaît pas — volontairement. 3. Collez le code ci-dessous avant . Pour votre propre intégration, appelez l'API du chat avec la même clé. ```html ``` | Method | Path | Purpose | |---|---|---| | GET | `https://nexiagent.com/api/chat/hello?k=pk_live_…` | Origin check + appearance (JSON) | | POST | `https://nexiagent.com/api/chat` | `{ siteKey, visitorId, message, locale? }` → Server-Sent Events `start`, `delta`, `done`, `error` | | GET | `https://status.nexiagent.com/api/status.json` | Platform status (JSON) | | POST | *your endpoint* | Webhook: `x-nexiagent-event`, `x-nexiagent-timestamp`, `x-nexiagent-signature` (HMAC-SHA256 of `timestamp.body`, hex) | ```json { "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." } } ``` Headers on every API response: `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset`; on 429 also `Retry-After`. Errors: `{ "error": "

", "message": "", "docs": "" }`.

- OpenAPI 3.1: https://nexiagent.com/openapi.json
- llms.txt: https://nexiagent.com/llms.txt
- Sitemap: https://nexiagent.com/sitemap.xml
- Webhook guide: https://docs.nexiagent.com/en/agentes/integracoes

## 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.

## 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.

## 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.

## 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.

## Pour les machines

- **OpenAPI 3.1** — La description complète des points d'accès publics et des webhooks, avec operationId et schémas.
- **llms.txt** — Ce que fait NexiAgent, quand c'est le bon outil et où se trouve chaque chose — pour les agents et les modèles de langage.
- **Markdown** — Chaque page du site répond en Markdown à une requête avec Accept: text/markdown.
- **Sitemap** — Toutes les pages indexables, avec leur date de modification.

## 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](https://nexiagent.com/fr/contact?interest=integration)

---

[Standard téléphonique](https://nexiagent.com/fr/solutions/scheduler) · [Chat de support 24/7](https://nexiagent.com/fr/solutions/support) · [Tarifs](https://nexiagent.com/fr/pricing) · [À propos](https://nexiagent.com/fr/about) · [Contact](https://nexiagent.com/fr/contact) · [Questions fréquentes](https://nexiagent.com/fr/faq) · [Documentation](https://docs.nexiagent.com) · [API](https://nexiagent.com/fr/developers) · [Confidentialité](https://nexiagent.com/fr/privacy)

© 2026 ISEGTEC, LDA · NIF 519472144 · Rua D. João IV, 340, 4000-298 Porto. Une marque d'ISEGTEC, LDA, comme NexiChat.