La personne doit d’abord avoir créé un compte Ndahunu (dans l’app ou sur ce site) avec cet e-mail. Les agents de terrain retrouvent leurs tâches dans l’app (Paramètres → Mon organisation).
Membres ({{ board.members.length }})
Nom
E-mail
Téléphone
Rôle
En cours
{{ m.full_name || '—' }}
{{ m.email }}
{{ m.phone || '—' }}
{{ m.role === 'chef' ? 'Chef' : 'Agent' }}
{{ m.active_tasks }}
Comptes bloqués ({{ blocked.length }})
Aucun compte bloqué.
{{ b.full_name || '—' }} · {{ b.email }}
Intégration automatique
Reliez votre logiciel à Ndahunu : ce que vous y enregistrez ({{ integrationScope }}) arrive automatiquement dans cet espace, et votre logiciel est prévenu de chaque changement fait sur le terrain. À transmettre à votre informaticien.
1. Clés d’API
Une clé par système (site, logiciel). Elle donne accès aux données de {{ currentOrg.name }} uniquement. Ne la publiez jamais, ne l’envoyez pas par message : donnez-la directement à votre informaticien.
Adresse (https) que Ndahunu appelle à chaque changement : livraison, mission commencée ou terminée par un agent, signalement d’un habitant reçu. Chaque appel est signé avec le secret ci-dessous (en-tête X-Ndahunu-Signature, HMAC-SHA256 du corps).
Secret de signature : {{ integration.webhookSecret }}
3. Documentation pour l’informaticien
Adresse de base : {{ apiBase }}. Chaque appel est un POST avec les en-têtes apikey: {{ anonKeyShort }} (clé publique du projet, ci-dessous) et Content-Type: application/json, et la clé secrète de l’organisation dans le corps (api_key).
Créer une livraison (à appeler à chaque commande)
{{ curlCreate }}
Champs : address_code (obligatoire : code Ndahunu du client, avec ou sans le dernier caractère), external_id (n° de commande : une commande envoyée deux fois ne crée qu’une livraison), reference, recipient_name, recipient_phone, notes, scheduled_for (AAAA-MM-JJ). La réponse contient l’état et un lien de suivi (tracking_url) à envoyer au client.
Connaître l’état d’une livraison
{{ curlStatus }}
Annuler une livraison
{{ curlCancel }}
Notification reçue par votre système
{{ webhookExample }}
États : a_livrer, en_route, livre, echec, annule. Erreurs : code d’adresse introuvable ou incorrect, clé invalide ou révoquée.
Lieu : pour chaque élément, mission ou zone, un code Ndahunu (address_code) ou des coordonnées GPS (latitude, longitude). external_id est votre propre identifiant : renvoyer le même identifiant met à jour l’élément au lieu d’en créer un autre.
Créer une mission de terrain
{{ curlTask }}
Champs : title (obligatoire), kind (contrôle, réparation, intervention…), details, priority (basse, normale, haute, urgente), due_date, asset_external_id (élément de l’inventaire concerné : la mission est alors placée au même endroit). Le chef l’attribue ensuite à un agent, qui la reçoit dans l’app.
Connaître l’état d’une mission, l’annuler
{{ curlTaskStatus }}
{{ curlCancelTask }}
Notification quand l’agent termine
{{ webhookTaskExample }}
Évènements : task.created, task.en_cours, task.termine (avec le compte rendu), task.annule.
Ajouter ou mettre à jour un élément de l’inventaire
{{ curlAsset }}
Champs : category et name (obligatoires), status (actif, travaux, hors_service, projet), notes, attributes (vos champs libres), path (tracé d’une rue ou d’une route : [[latitude, longitude], …]). Envoyez tous les champs à chaque fois.
Retirer un élément
{{ curlDeleteAsset }}
Publier ou mettre à jour une zone
{{ curlZone }}
geometry : tracé {"type":"line","points":[…]}, surface {"type":"polygon","points":[…]} ou cercle {"type":"circle","center":[lat, lng],"radius":mètres}. severity : info, moyenne, haute. Avec is_public: true, la zone s’affiche pour tous sur la carte et dans les itinéraires de l’app.
Lever une zone (route rouverte, alerte terminée)
{{ curlEndZone }}
Récupérer les signalements des habitants
{{ curlReports }}
Renvoie jusqu’à 500 signalements modifiés depuis since (lieu, thème, description, nom et téléphone de l’auteur). Chaque nouveau signalement est aussi envoyé à votre adresse de notification (report.received).
Mettre à jour un signalement
{{ curlReportStatus }}
États : recu, en_cours, resolu, rejete. L’habitant est prévenu dans l’app.
Ndahunu