Conecta SmartChat con tus programas.
Con la API de SmartChat conectas tus propios programas con tu marketing por WhatsApp.
Tu sistema envía una solicitud, y el contacto está creado.
Tu sistema envía solicitudes sencillas a SmartChat. Cada solicitud lleva tu clave de API, así SmartChat sabe que viene de ti. La respuesta vuelve al instante. Todos los pasos con ejemplos están en la guía de inicio rápido de la 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"}' # Antwort 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"]}' # Tag wieder entfernen curl -X DELETE https://api.smartchat.marketing/v1/contacts/KONTAKT_ID/tags/Umzug \ -H "Authorization: Bearer DEIN_API_SCHLUESSEL"# 1. Entwurf anlegen 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. Termin setzen 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" # Nachrichten eines Gesprächs curl https://api.smartchat.marketing/v1/inbox/conversations/GESPRAECH_ID/messages \ -H "Authorization: Bearer DEIN_API_SCHLUESSEL"Tú decides qué puede hacer una clave.
Cada programa tiene su propia clave con su propio nombre. Tú eliges si la clave solo puede leer o también escribir.
Solo para administradores
Solo los administradores crean y eliminan claves. Los empleados no ven esta sección.
Último uso
En cada clave aparece cuándo la usó un programa por última vez.
Volver a generar o borrar
La clave antigua deja de funcionar al instante. Los programas que la usan pierden el acceso hasta que introduzcas la nueva.
Conectado en cuatro pasos.
Creas la clave y la introduces en tu sistema. Después los contactos nuevos llegan automáticamente.
- 1
Creas la clave
En SmartChat abres Ajustes, Integraciones y haces clic en API en Crear clave nueva.
- 2
Introduces la clave en tu sistema
Tu sistema envía la clave con cada solicitud. Para iniciar sesión no hace falta nada más.
Authorization: Bearer DEIN_API_SCHLUESSEL - 3
Tu sistema prueba la conexión
La primera solicitud muestra a qué cuenta pertenece la clave y qué puede hacer.
GET https://api.smartchat.marketing/v1/me { "account": { "name": "Technikhaus Zeller" }, "key": { "name": "Kassensystem" }, "auth_type": "api_key" } - 4
Llega el primer contacto
Si una clienta compra un smartphone y da su número de móvil en caja, poco después aparece en tus contactos, con etiqueta y el estado Sin confirmar.
Se acabó pasar contactos a mano
Sin conexión, tu equipo mantiene dos listas. Con la API, la segunda se mantiene sola.
Sin API
- Los clientes nuevos de tu programa se pasan a mano a la lista de contactos por la tarde.
- Quién ha comprado o reservado qué lo añade alguien como etiqueta cuando se acuerda.
- Para cada oferta nueva, alguien monta de cero la fecha del newsletter en la app.
- Las cifras de WhatsApp y las de tu programa están en dos ventanas distintas.
Con la API de SmartChat
- Cada cliente nuevo acaba en el mismo momento como contacto a SmartChat.
- Tu programa asigna los tags por sí mismo, según la compra o la reserva.
- Una oferta nueva en el programa se convierte en un newsletter programado con fecha.
- Tu propio dashboard obtiene las estadísticas de SmartChat.
Tu lista de contactos siempre está al día.
Los contactos que crea tu programa aparecen junto a todos los demás en SmartChat. Con etiqueta, origen y el estado de su consentimiento.
Ningún contacto duplicado
Si el número ya existe, SmartChat devuelve el contacto existente. Si quieres, tu programa lo modifica en su lugar.
El consentimiento sigue protegido
Si tu programa cambia el número de móvil, el contacto tiene que confirmar de nuevo. Un consentimiento nunca pasa a otro número.
Etiquetas desde fuera
Tu programa pone y quita tags. Después diriges los newsletters justo a ese grupo.
Tu sistema planifica el newsletter.
Con la API tu programa crea un newsletter de WhatsApp como borrador, lo modifica y lo programa para una fecha. Hasta que empieza el envío, también puede cancelar la planificación.
Fecha del plan del proyecto
Si hay una fecha nueva en el programa, por ejemplo la apertura del piso piloto, el programa planifica también el newsletter.
Consultar el estado
Tu programa pregunta si un newsletter está programado, en envío o enviado.
Aprobación de Meta
Con la API tu programa también crea plantillas y las envía a Meta para su aprobación.
SmartChat avisa a tu sistema.
Con una suscripción de webhook, tu programa se entera automáticamente de varios eventos, por ejemplo un contacto nuevo o un mensaje nuevo. Cada aviso va firmado, para que tu programa pueda comprobar que de verdad viene 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"}' # Antwort 201: Abo plus Geheimnis für die Signatur { "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"] } }# Puedes suscribirte a varios eventosTu programa envía, WhatsApp entrega.
Con la API tu programa envía un mensaje de WhatsApp a un contacto concreto, por ejemplo un recordatorio la tarde antes de una cita.
Solo con consentimiento
Quien ha escrito STOP no recibe nada.
Plantilla aprobada
Tu programa envía una plantilla aprobada por Meta, si quieres con botón.
Respuestas en la bandeja de entrada
Si tu contacto responde, el mensaje llega a la bandeja de entrada. Allí responde SmartChat AI o tu equipo.
La API de SmartChat está incluida en cada plan.
Por la API no pagas nada extra. Valen los límites de tu tarifa, por ejemplo el número de mensajes al mes. Todos los precios más IVA.
| Free | Starter | Basic | Pro | |
|---|---|---|---|---|
| Precio por mes | 0 € | 299 € | 499 € | 999 € |
| clave API | sí | sí | sí | sí |
| Suscripciones de webhook | sí | sí | sí | sí |
| Mensajes | 100 una sola vez | 3.000 al mes | 6.000 al mes | ilimitado |
| Contactos | ilimitado | ilimitado | ilimitado | ilimitado |
Preguntas frecuentes sobre API.
¿Necesito conocimientos técnicos para la API?
Sí, la API conecta tu sistema con SmartChat, y para eso hacen falta unas líneas de código. Sin código usas el AI Chat o conectas una app de AI como Claude o ChatGPT por MCP.
¿Para qué usan las empresas la API de SmartChat?
Una empresa de alquiler de coches crea contactos desde su programa de reservas, una tienda de electrónica desde su sistema de caja, y una promotora planifica newsletters directamente desde su programa de proyectos. Más ejemplos los encuentras en Marketing por WhatsApp para alquiler de coches, Marketing por WhatsApp para tiendas de electrónica y Marketing por WhatsApp para promotores inmobiliarios y constructoras.
¿Cuánto cuesta la API de SmartChat?
La API está incluida en todas las tarifas, también en la gratuita Free. Las llamadas normales no cuestan créditos. Los créditos solo cuentan en tareas en las que SmartChat AI trabaja para ti, igual que en el AI Chat.
¿Cuánto cuesta WhatsApp en Meta si envío por la API?
Meta cobra las tarifas por los mensajes de WhatsApp directamente a ti, da igual si envías desde la app o por la API. Para ello guardas un método de pago en tu cuenta de Meta. A SmartChat le pagas además tu tarifa. Los precios exactos los encuentras en Tarifas de Meta.
¿Puede la API enviar mensajes de WhatsApp a cualquier número?
SmartChat envía newsletters y seguimientos (follow-ups) solo después de la confirmación del contacto.
¿Un contacto nuevo de la API recibe un mensaje al instante?
No, un contacto de la API aparece primero como Sin confirmar. Recibe newsletters y seguimientos (follow-ups) solo cuando ha dado su consentimiento, por ejemplo a través de tu popup de la web, tu landing page o tu código QR.
¿Qué pasa si un contacto de la API escribe STOP?
El contacto escribe STOP en el chat. Después SmartChat ya no le envía nada, tampoco por la API. Tu programa se entera a través de los eventos de la API.
¿Quién puede crear claves de API?
Solo los administradores. La API está en Ajustes, en Integraciones. Los empleados no ven esta sección.
¿Qué hago si una clave cae en manos equivocadas?
La generas de nuevo o la eliminas con un clic. La clave antigua deja de funcionar al instante.
¿Cuántas claves de API puedo crear?
Lo mejor es que cada programa tenga la suya, así ves en cada una cuándo se usó por última vez.
¿Cómo se entera mi programa de contactos o mensajes nuevos?
Con una suscripción de webhook. SmartChat avisa entonces a tu programa, por ejemplo cuando hay un contacto nuevo o un mensaje nuevo. Si SmartChat no llega a tu programa, lo intenta de nuevo varias veces más tarde.
¿Cuál es la diferencia entre API y MCP?
La API es para tus propios programas y funciona con una clave. Con MCP conectas una app de AI como Claude o ChatGPT, con la que inicias sesión con tu cuenta de SmartChat.
¿Dónde encuentro la guía técnica?
En la guía de inicio rápido de la API. Allí están todos los pasos, desde la primera clave hasta el primer contacto, con ejemplos para copiar.
Conecta tu sistema con SmartChat.
Escribe tu página web. En 60 segundos tienes listo tu sistema de marketing por WhatsApp, y tu primera clave de API la creas justo después en Ajustes.