Vue d'ensemble de l'API
Ce que vous pouvez brancher sur Nudge par programme, où se trouve chaque interface et laquelle choisir.
Ce qui est disponible
Nudge offre quatre points d'entrée aux développeurs. Chacun répond à un besoin différent : commencez par choisir le bon.
| Interface | URL de base | Authentification | Pour |
|---|---|---|---|
| Serveur MCP | https://mcp.asknudge.ai | OAuth (votre compte Nudge) | Laisser un assistant IA (Claude, ChatGPT, Cursor…) consulter et gérer votre espace avec vos propres droits |
| API de réservation IA | https://app.asknudge.ai/api/ai | Aucune, limitée par IP | Permettre à un agent ou à un script de lire les disponibilités, puis de réserver, annuler ou déplacer un rendez-vous sur l'un de vos formulaires |
| Gestion d'un rendez-vous | https://app.asknudge.ai/api/booking/{bookingId} | Le jeton de gestion du rendez-vous | Lire, déplacer, annuler ou télécharger (.ics) un rendez-vous existant |
| Endpoints publics des formulaires | https://app.asknudge.ai/api/public/{orgSlug}/{formSlug} | Aucune | Lire la définition publique d'un formulaire et ses hôtes |
| Webhooks sortants | Votre propre URL HTTPS | Signature HMAC-SHA256 | Recevoir les nouveaux leads dans Zapier, Make, votre CRM ou votre backend |
Tout le trafic passe en HTTPS. Requêtes et réponses sont en JSON (UTF-8), sauf le téléchargement .ics.
Vous cherchez une API REST avec clés d'API ?
Nudge ne propose pas aujourd'hui de clés d'API pour les données de l'espace. Pour lire ou modifier contacts, rendez-vous, formulaires, agents ou réglages depuis du code ou un assistant IA, utilisez le serveur MCP : il exécute chaque action avec les mêmes contrôles de permissions que l'application.
Laquelle utiliser ?
- Vous voulez qu'un assistant travaille dans Nudge pour vous (lister les rendez-vous du jour, qualifier un lead, modifier un formulaire, ajouter un webhook) : connectez le serveur MCP. La référence des outils liste ses 224 outils.
- Vous voulez qu'un agent IA externe prenne des rendez-vous avec votre équipe (une action ChatGPT, un bot vocal, un site partenaire) : utilisez l'API de réservation IA. Aucune clé n'est nécessaire : le slug du formulaire et des créneaux signés suffisent, et vous pouvez la couper formulaire par formulaire.
- Vous voulez pousser les leads vers un autre outil dès leur arrivée : créez un webhook et consultez la référence des événements.
- Vous construisez votre propre page autour d'un rendez-vous (une page « gérer mon rendez-vous » sur mesure) : utilisez les endpoints de gestion d'un rendez-vous.
Identifiants
Nudge n'expose jamais les identifiants internes de sa base sur les endpoints publics. Les objets circulent sous des identifiants publics préfixés par leur type :
| Préfixe | Objet | Exemple |
|---|---|---|
frm_ | Formulaire | frm_8k2m9q4t7v1x3z6c |
bk_ | Rendez-vous | bk_4n7q2w9e5r1t8y3a |
cnt_ | Contact | cnt_6h3j8k1m4n7p2q5r |
tm_ | Membre de l'équipe (hôte) | tm_2v5b8n1m4k7j3h6g |
Les espaces et les formulaires sont aussi désignés par leurs slugs, les deux parties de l'URL publique d'un formulaire : dans https://app.asknudge.ai/acme/demo-request, acme est le slug de l'espace (orgSlug) et demo-request celui du formulaire (formSlug).
CORS
L'API de réservation IA et les endpoints publics des formulaires répondent avec Access-Control-Allow-Origin: * : vous pouvez les appeler depuis n'importe quelle page web. Le serveur MCP n'accepte les requêtes de navigateur que depuis l'application Nudge, claude.ai et chatgpt.com ; les clients de bureau et côté serveur, qui n'envoient pas d'en-tête Origin, ne sont pas concernés.
Limites et erreurs
Chaque endpoint public est limité par adresse IP et répond 429 Too Many Requests avec un en-tête Retry-After en cas de dépassement. Voir Limites de débit pour les chiffres et Erreurs pour les formats d'erreur.