API di SmartChat

L'API REST di SmartChat ti dà accesso a tutto ciò che fai nell'app SmartChat. La usano Zapier, Make, n8n, il tuo codice e il connector di Claude.

Indirizzo e autenticazione

Tutte le richieste vanno all'indirizzo qui sotto. Invia la tua chiave API come token Bearer. Crea le chiavi in SmartChat sotto Impostazioni > Chiavi API e dai a ogni chiave solo i permessi necessari.

https://api.smartchat.marketing/v1

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

Riferimento completo

La descrizione completa leggibile dalle macchine (OpenAPI 3) con ogni endpoint, campo ed errore:

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

Le aree

`/contacts`	Contatti, etichette, opt-in
`/messages, /sends`	Inviare messaggi e modelli WhatsApp, controllare la consegna
`/inbox`	Conversazioni e messaggi
`/templates`	Modelli WhatsApp, invio a Meta
`/newsletters`	Newsletter, programmare, annullare, stato
`/followups`	Sequenze di follow-up e passi
`/automations`	Automazioni, esecuzioni, avvio
`/media`	Libreria media, caricamento (multipart, url o base64)
`/tools`	Ogni strumento di SmartChat AI direttamente, per esempio update_landing o create_newsletter
`/app`	Altre funzioni dell'app: risposte in posta, impostazioni AI, widget, domini, team, fatturazione (lettura)
`/webhook-subscriptions`	Ricevere eventi nel tuo sistema
`/stats, /me, /settings`	Numeri, account e impostazioni

Regole

Limite: 120 richieste al minuto per chiave. Oltre ricevi 429 con retry-after.
Idempotenza: invia un header Idempotency-Key negli invii per evitare doppioni (vale 24 ore).
Gli errori arrivano in JSON con un codice e un messaggio in inglese.
I messaggi vanno solo ai contatti che hanno confermato l'iscrizione WhatsApp. Fuori dalla finestra di 24 ore solo modelli approvati.

Azioni in due passi

Gli strumenti che inviano, programmano, sottomettono o eliminano restituiscono prima un'anteprima e un confirm_token. Richiama lo stesso strumento con confirm_token per eseguire. Alla prima chiamata non succede nulla.

Domande?

Scrivici a support@smartchat.marketing