Connecte SmartChat à tes logiciels.
Avec l'API de SmartChat, tu connectes tes propres logiciels à ton marketing WhatsApp.
Ton système envoie une requête, et le contact est créé.
Ton système envoie de simples requêtes à SmartChat. Chaque requête contient ta clé API, c'est ainsi que SmartChat sait qu'elle vient de toi. La réponse revient tout de suite. Toutes les étapes avec des exemples figurent dans le démarrage rapide de l'API.
curl -X POST https://api.smartchat.marketing/v1/contacts \ -H "Authorization: Bearer DEIN_API_SCHLUESSEL" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: buchung-20481" \ -d '{"name": "Birgit", "phone": "+491701234567"}' # Réponse 201 { "ok": true, "created": true, "contact": { "name": "Birgit", "optin_whatsapp": "none", "source": "api" } }curl -X POST https://api.smartchat.marketing/v1/contacts/KONTAKT_ID/tags \ -H "Authorization: Bearer DEIN_API_SCHLUESSEL" \ -H "Content-Type: application/json" \ -d '{"tags": ["Transporter", "Umzug"]}' # Retirer à nouveau le tag curl -X DELETE https://api.smartchat.marketing/v1/contacts/KONTAKT_ID/tags/Umzug \ -H "Authorization: Bearer DEIN_API_SCHLUESSEL"# 1. Créer le brouillon curl -X POST https://api.smartchat.marketing/v1/newsletters \ -H "Authorization: Bearer DEIN_API_SCHLUESSEL" \ -H "Content-Type: application/json" \ -d '{"subject": "Freie Transporter zum Monatsende", "content": "Zum Monatsende sind noch Transporter mit Hochdach frei, genau richtig für deinen Umzug."}' # 2. Fixer la date curl -X POST https://api.smartchat.marketing/v1/newsletters/NEWSLETTER_ID/schedule \ -H "Authorization: Bearer DEIN_API_SCHLUESSEL" \ -H "Content-Type: application/json" \ -d '{"scheduled_at": "2026-11-23T18:00:00+01:00"}'curl https://api.smartchat.marketing/v1/inbox/conversations \ -H "Authorization: Bearer DEIN_API_SCHLUESSEL" # Messages d'une conversation curl https://api.smartchat.marketing/v1/inbox/conversations/GESPRAECH_ID/messages \ -H "Authorization: Bearer DEIN_API_SCHLUESSEL"Tu décides de ce qu'une clé peut faire.
Chaque logiciel reçoit sa propre clé avec son propre nom. Tu choisis si la clé peut seulement lire ou aussi écrire.
Réservé aux admins
Seuls les admins créent et suppriment des clés. Les collaborateurs ne voient pas cette section.
Dernière utilisation
Pour chaque clé, on voit quand un logiciel l'a utilisée pour la dernière fois.
Régénérer ou supprimer
L'ancienne clé ne fonctionne alors plus immédiatement. Les logiciels qui l'utilisent perdent l'accès jusqu'à ce que tu saisisses la nouvelle.
En quatre étapes, connecté.
Tu crées la clé et tu la saisis dans ton système. Ensuite, les nouveaux contacts arrivent automatiquement.
- 1
Tu crées la clé
Dans SmartChat, tu ouvres Paramètres, Intégrations et tu cliques sur Créer une nouvelle clé sous API.
- 2
Tu saisis la clé dans ton système
Ton système envoie la clé avec chaque requête. Il ne faut rien d'autre pour la connexion.
Authorization: Bearer DEIN_API_SCHLUESSEL - 3
Ton système teste la connexion
La première requête montre à quel compte appartient la clé et ce qu'elle peut faire.
GET https://api.smartchat.marketing/v1/me { "account": { "name": "Technikhaus Zeller" }, "key": { "name": "Kassensystem" }, "auth_type": "api_key" } - 4
Le premier contact arrive
Quand une cliente achète un smartphone et donne son numéro de portable à la caisse, elle apparaît peu après dans tes contacts, avec un tag et le statut Non confirmé.
Plus de contacts à transférer à la main.
Sans connexion, ton équipe tient deux listes. Avec l'API, la seconde se met à jour toute seule.
Sans API
- Les nouveaux clients de ton logiciel sont reportés à la main dans la liste de contacts le soir.
- Qui a acheté ou réservé quoi, quelqu'un l'ajoute comme tag quand il y pense.
- Pour chaque nouvelle offre, quelqu'un reconstruit de zéro la planification de la newsletter dans l'application.
- Les chiffres de WhatsApp et de ton logiciel se trouvent dans deux fenêtres.
Avec l'API de SmartChat
- Chaque nouveau client arrive à l'instant même comme contact dans SmartChat.
- Ton logiciel définit les tags lui-même, selon l'achat ou la réservation.
- Une nouvelle offre dans le logiciel devient une newsletter planifiée avec une date.
- Ton propre tableau de bord récupère les statistiques depuis SmartChat.
Ta liste de contacts reste à jour.
Les contacts que ton logiciel crée apparaissent à côté de tous les autres dans SmartChat. Avec tag, origine et statut de leur consentement.
Aucun contact en double
Si le numéro existe déjà, SmartChat renvoie le contact existant. Si tu le souhaites, ton logiciel le modifie à la place.
Le consentement reste protégé
Si ton logiciel modifie le numéro de portable, le contact doit confirmer de nouveau. Un consentement ne passe jamais à un autre numéro.
Des tags depuis l'extérieur
Ton logiciel définit et supprime des tags. Ensuite, tu adresses tes newsletters précisément à ce groupe.
Ton système planifie la newsletter.
Via l'API, ton logiciel crée une newsletter WhatsApp comme brouillon, la modifie et la planifie pour une date. Tant que l'envoi n'a pas commencé, il peut aussi annuler la planification.
Date issue du planning du projet
Quand une nouvelle date figure dans le logiciel, par exemple l'ouverture de l'appartement témoin, il planifie directement la newsletter avec.
Interroger le statut
Ton logiciel demande si une newsletter est planifiée, en cours d'envoi ou envoyée.
Validation par Meta
Avec l'API, ton logiciel crée aussi des modèles et les soumet à Meta pour validation.
SmartChat contacte ton système.
Avec un abonnement webhook, ton logiciel est informé automatiquement de plusieurs événements, par exemple un nouveau contact ou un nouveau message. Chaque notification est signée, pour que ton logiciel puisse vérifier qu'elle vient bien de SmartChat.
curl -X POST https://api.smartchat.marketing/v1/webhook-subscriptions \ -H "Authorization: Bearer DEIN_API_SCHLUESSEL" \ -H "Content-Type: application/json" \ -d '{"url": "https://technikhaus-zeller.de/smartchat", "event": "contact.created"}' # Réponse 201 : abonnement plus secret pour la signature { "subscription": { … }, "secret": "whsec_…" }POST https://technikhaus-zeller.de/smartchat X-SmartChat-Event: contact.created X-SmartChat-Timestamp: 1792400000 X-SmartChat-Signature: v1=… { "event": "contact.created", "data": { "name": "Jonas", "optin_whatsapp": "none", "tags": ["Heimkino"] } }# Tu peux t'abonner à plusieurs événementsTon logiciel envoie, WhatsApp livre.
Avec l'API, ton logiciel envoie un message WhatsApp à un contact individuel, par exemple un rappel la veille d'un rendez-vous.
Uniquement avec consentement
Celui qui a écrit STOP ne reçoit rien.
Modèle validé
Ton logiciel envoie un modèle validé par Meta, avec un bouton si tu le souhaites.
Réponses dans la boîte de réception
Si ton contact répond, le message arrive dans la boîte de réception. SmartChat AI ou ton équipe y répond.
L'API SmartChat est incluse dans chaque tarif.
Tu ne paies rien de plus pour l'API. Les limites de ton tarif s'appliquent, par exemple le nombre de messages par mois. Tous les prix hors TVA.
| Free | Starter | Basic | Pro | |
|---|---|---|---|---|
| Prix par mois | 0 € | 299 € | 499 € | 999 € |
| clé API | oui | oui | oui | oui |
| Abonnements webhook | oui | oui | oui | oui |
| Messages | 100 une fois | 3 000 par mois | 6 000 par mois | illimité |
| Contacts | illimité | illimité | illimité | illimité |
Questions fréquentes sur l'API.
Ai-je besoin de connaissances techniques pour l'API ?
Oui, l'API connecte ton système à SmartChat, et il faut pour cela quelques lignes de code. Sans code, tu utilises l'AI Chat ou tu connectes une application d'IA comme Claude ou ChatGPT via MCP.
À quoi servent l'API de SmartChat pour les entreprises ?
Un loueur de voitures crée des contacts depuis son logiciel de réservation, un revendeur d'électronique depuis son système de caisse, et un promoteur immobilier planifie des newsletters directement depuis son logiciel de projets. Tu trouves d'autres exemples sous Marketing WhatsApp pour loueurs de voitures, Marketing WhatsApp pour revendeurs d'électronique et Marketing WhatsApp pour promoteurs immobiliers et constructeurs.
Combien coûte l'API de SmartChat ?
L'API est incluse dans chaque tarif, même dans le Free gratuit. Les appels normaux ne coûtent aucun crédit. Les crédits ne comptent que pour les tâches où SmartChat AI travaille pour toi, exactement comme dans le chat IA.
Combien coûte WhatsApp chez Meta si j'envoie via l'API ?
Meta facture les frais pour les messages WhatsApp directement auprès de toi, que tu envoies depuis l'application ou via l'API. Pour cela, tu enregistres un moyen de paiement dans ton compte Meta. Chez SmartChat, tu paies en plus ton tarif. Tu trouves les prix exacts sous frais Meta.
L'API peut-elle envoyer des messages WhatsApp à n'importe quel numéro ?
SmartChat n'envoie les newsletters et les relances (follow-ups) qu'après la confirmation du contact.
Un nouveau contact venant de l'API reçoit-il tout de suite un message ?
Non, un contact venant de l'API est d'abord sur Non confirmé. Il ne reçoit les newsletters et les relances (follow-ups) qu'après avoir donné son accord, par exemple via ton popup du site web, ta landing page ou ton QR code.
Que se passe-t-il si un contact venant de l'API écrit STOP ?
Le contact écrit STOP dans le chat. SmartChat ne lui envoie ensuite plus rien, pas même via l'API. Ton logiciel l'apprend par les événements de l'API.
Qui peut créer des clés API ?
Uniquement les admins. L'API se trouve dans les paramètres sous Intégrations. Les collaborateurs ne voient pas cette section.
Que faire si une clé tombe entre de mauvaises mains ?
Tu la régénères ou tu la supprimes en un clic. L'ancienne clé ne fonctionne alors plus immédiatement.
Combien de clés API puis-je créer ?
Le mieux est que chaque logiciel ait la sienne, ainsi tu vois pour chacune quand elle a été utilisée pour la dernière fois.
Comment mon programme est-il informé des nouveaux contacts ou messages ?
Via un abonnement webhook. SmartChat contacte alors ton logiciel, par exemple pour un nouveau contact ou un nouveau message. Si SmartChat ne parvient pas à joindre ton logiciel, il réessaie plusieurs fois plus tard.
Quelle est la différence entre l'API et MCP ?
L'API est destinée à tes propres logiciels et fonctionne avec une clé. Avec MCP tu connectes une application d'IA comme Claude ou ChatGPT, dans laquelle tu te connectes avec ton compte SmartChat.
Où trouver le mode d'emploi technique ?
Dans le démarrage rapide de l'API. Tu y trouves toutes les étapes, de la première clé au premier contact, avec des exemples à copier.
Connecte ton système à SmartChat.
Saisis l'adresse de ton site web. En 60 secondes, ton système de marketing WhatsApp est prêt, et tu crées ta première clé API juste après, dans les paramètres.