API de SmartChat

La API REST de SmartChat te da acceso a todo lo que haces en la app de SmartChat. La usan Zapier, Make, n8n, tu propio código y el connector de Claude.

Dirección y autenticación

Todas las peticiones van a la dirección de abajo. Envía tu clave API como token Bearer. Crea las claves en SmartChat en Ajustes > Claves API y da a cada clave solo los permisos que necesita.

https://api.smartchat.marketing/v1

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

Referencia completa

La descripción completa legible por máquinas (OpenAPI 3) con cada endpoint, campo y error:

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

Las áreas

`/contacts`	Contactos, etiquetas, opt-in
`/messages, /sends`	Enviar mensajes y plantillas de WhatsApp, comprobar la entrega
`/inbox`	Conversaciones y mensajes
`/templates`	Plantillas de WhatsApp, envío a Meta
`/newsletters`	Newsletters, programar, cancelar, estado
`/followups`	Secuencias de seguimiento y pasos
`/automations`	Automatizaciones, ejecuciones, disparar
`/media`	Biblioteca de medios, subida (multipart, url o base64)
`/tools`	Cada herramienta de SmartChat AI directamente, por ejemplo update_landing o create_newsletter
`/app`	Más funciones de la app: respuestas, ajustes de IA, widgets, dominios, equipo, facturación (lectura)
`/webhook-subscriptions`	Recibir eventos en tu sistema
`/stats, /me, /settings`	Cifras, cuenta y ajustes

Reglas

Límite: 120 peticiones por minuto y clave. Por encima recibes 429 con retry-after.
Idempotencia: envía una cabecera Idempotency-Key en los envíos para evitar duplicados (24 horas).
Los errores llegan en JSON con un código y un mensaje en inglés.
Los mensajes solo van a contactos que confirmaron su alta en WhatsApp. Fuera de la ventana de 24 horas solo se envían plantillas aprobadas.

Acciones en dos pasos

Las herramientas que envían, programan, someten o borran devuelven primero una vista previa y un confirm_token. Vuelve a llamar a la misma herramienta con confirm_token para ejecutar. En la primera llamada no pasa nada.

¿Preguntas?

Escríbenos a support@smartchat.marketing