API SmartChat

L'API REST de SmartChat donne accès à tout ce que tu fais dans l'app SmartChat. Elle est utilisée par Zapier, Make, n8n, ton propre code et le connector Claude.

Adresse et authentification

Toutes les requêtes vont à l'adresse ci-dessous. Envoie ta clé API comme jeton Bearer. Crée les clés dans SmartChat sous Paramètres > Clés API et donne à chaque clé seulement les droits nécessaires.

https://api.smartchat.marketing/v1

curl https://api.smartchat.marketing/v1/me \
  -H "Authorization: Bearer sk_live_..."

Référence complète

La description complète lisible par machine (OpenAPI 3) avec chaque endpoint, champ et erreur :

https://api.smartchat.marketing/v1/openapi.json
https://api.smartchat.marketing/v1/openapi.yaml

Les domaines

`/contacts`	Contacts, étiquettes, opt-in
`/messages, /sends`	Envoyer messages et modèles WhatsApp, vérifier la livraison
`/inbox`	Conversations et messages
`/templates`	Modèles WhatsApp, soumission à Meta
`/newsletters`	Newsletters, planifier, annuler, état
`/followups`	Séquences de relance et étapes
`/automations`	Automatisations, exécutions, déclenchement
`/media`	Médiathèque, téléversement (multipart, url ou base64)
`/tools`	Chaque outil de SmartChat AI directement, par exemple update_landing ou create_newsletter
`/app`	Autres fonctions de l'app : réponses, réglages IA, widgets, domaines, équipe, facturation (lecture)
`/webhook-subscriptions`	Recevoir des événements dans ton système
`/stats, /me, /settings`	Chiffres, compte et réglages

Règles

Limite : 120 requêtes par minute et par clé. Au-delà, tu reçois 429 avec retry-after.
Idempotence : envoie un en-tête Idempotency-Key lors des envois pour éviter les doublons (24 heures).
Les erreurs arrivent en JSON avec un code et un message en anglais.
Les messages vont seulement aux contacts qui ont confirmé leur inscription WhatsApp. Hors de la fenêtre de 24 heures, seuls les modèles approuvés partent.

Actions en deux étapes

Les outils qui envoient, planifient, soumettent ou suppriment renvoient d'abord un aperçu et un confirm_token. Rappelle le même outil avec confirm_token pour exécuter. Rien ne se passe au premier appel.

Des questions ?

Écris-nous à support@smartchat.marketing