Premiers pas
Configurez votre première intégration Plus ou Pro en quelques minutes.
Prérequis
| Plan | Condition | Accès intégration |
|---|---|---|
| Free | Calendrier actif Free | Calendrier public, billetterie, newsletters · pas d'intégrations |
| Starter (12 €/mois) | Calendrier actif Starter | Frais réduits, quotas étendus et MCP Njanggo (Cursor, Claude…) |
| Plus (29 €/mois) | Calendrier actif Plus | Onglet Développeur · webhooks, embed, URLs publiques (pas de clé API) |
| Pro (79 €/mois) | Calendrier actif Pro | Plus + clés API nj_live_… + /api/v1/… |
| Enterprise | Contrat signé | Extensions SSO, sandbox, SLA |
Un calendrier = un périmètre
Parcours Plus (sans clé API)
- 1
Ouvrir le panneau Développeur
njanggo.com → calendrier → Paramètres → Développeur (Plus ou Pro requis).
- 2
Configurer un webhook (aujourd’hui par événement)
Gérer l'événement → Webhooks. Collez l'URL Zapier/Make, cochez
guest.registered, copiez le secretwhsec_…(une fois). - 3
Tester la réception
Bouton Tester ou inscription test. Vérifiez le JSON et la signature HMAC (
X-Njanggo-Webhook-Signature). - 4
Widget sur votre site
Onglet Intégrer · copiez le code iframe du calendrier (aucune authentification).
Parcours Pro (API REST)
- 1
Générer une clé API
Panneau Développeur → Clés API → Créer. Nommez la clé (ex. « CRM prod »). Sélectionnez les scopes minimums nécessaires.
- 2
Stocker la clé
Exportez
nj_live_…dans vos secrets (Vercel, Railway, .env serveur). Jamais dans le code front-end ou une app mobile distribuée. - 3
Valider l'authentification
Appelez
GET /v1/calendars/:slug· vous devez recevoir les infos du calendrier. - 4
Intégrer vos workflows
Consultez les guides Événements, Invités, Check-in selon votre cas d'usage (CMS, kiosque, sync ventes).
Tester un webhook (Plus)
Création webhook aujourd’hui · par événement, Bearer organisateur :
curl -X POST "https://api.njanggo.com/api/events/evt_abc123/webhooks" \
-H "Authorization: Bearer $NJANGGO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"url":"https://hooks.zapier.com/hooks/catch/123456/abcdef/","events":["guest.registered"]}'POST /api/calendars/:slug/webhooks · voir Webhooks calendrier.Tester l'API Pro
Test d'authentification · récupérez les informations de votre calendrier :
curl -X GET "https://api.njanggo.com/api/v1/calendars/mon-collectif" \
-H "x-njanggo-api-key: $NJANGGO_API_KEY"{
"data": {
"slug": "mon-collectif",
"name": "Mon Collectif",
"billingPlanCode": "PRO",
"subscriberCount": 842
}
}