Démarrer
Démarrer
De rien à un premier message envoyé et répondu, en trois appels.
Avant le premier appel
- Créez un compte, un espace, et branchez un numéro WhatsApp dans la console. Le numéro appartient à votre client : Nodium ne fournit pas de numéro.
- Au branchement, choisissez qui répond : le collaborateur Nodium, ou votre logiciel. Avec « mon logiciel répond », aucune IA ne parle sur ce numéro : les messages arrivent, vous les recevez par webhook, vous répondez par l'API.
- Créez une clé d'API dans la console, rubrique Développeurs. Une clé ne se crée qu'en session — jamais par l'API — pour qu'une clé qui fuit ne puisse pas en fabriquer d'autres.
- Déclarez une adresse de webhook (console, ou
POST /webhooks) pour que Nodium vous prévienne quand un client écrit.
Trois appels
# 1. Which numbers can I send from?curl https://nodium.io/api/v1/inbox/channels \ -H "Authorization: Bearer $NODIUM_KEY"# 2. Write first to a customer: on WhatsApp, an approved templatecurl https://nodium.io/api/v1/inbox/conversations \ -H "Authorization: Bearer $NODIUM_KEY" \ -H "Content-Type: application/json" \ -d '{ "channelId": "<channel id>", "to": "+33612345678", "templateId": "<approved template id>", "variables": { "1": "Karim" }, "idempotencyKey": "order-1042-confirmation" }'# 3. The customer answers: you receive message.received on your webhook.# Reply in free text, within 24 hours:curl https://nodium.io/api/v1/inbox/conversations/<conversation id>/messages \ -H "Authorization: Bearer $NODIUM_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Yes, it is ready.", "idempotencyKey": "order-1042-reply-1" }'C'est toute la boucle : lister vos canaux, écrire en premier avec un modèle approuvé, recevoir la réponse par webhook, répondre en texte libre. Pour passer le fil au collaborateur — sur un canal qui en a un — POST /inbox/conversations/{id}/ai avec { "enabled": true }.
La suite
- Authentification — ce qu'une clé peut faire, et ce qu'elle ne peut pas.
- Réponses et erreurs — l'enveloppe
data/error, la pagination, les limites. - La fenêtre de 24 h — la règle de WhatsApp qui décide de ce que vous pouvez envoyer.
- Envoyer — la clé anti-doublon et l'envoi en nombre.
- Webhooks — les événements, la signature, les reprises.