Saltar al contenido
AdSmartBotAyuda
EntrarPruébalo gratis

API de AdSmartBot

Conecta tu cuenta con tu tienda, tu formulario, Zapier, Make, n8n o cualquier sistema propio: que tu sistema cree clientes, les agregue etiquetas y les envíe plantillas, y que se entere al instante de lo que pasa en tus conversaciones.

  • En todos los planes, sin costo aparte
  • JSON y OpenAPI 3.1
  • Avisos firmados

Tres caminos

  • La API

    Tu sistema nos pide o nos cambia algo: «crea este contacto», «agrégale la etiqueta VIP», «envíale esta plantilla», «lanza este flujo».

    Ver la referencia
  • Avisos a otros sistemas

    Algo pasa aquí y le avisamos a tu sistema: llegó un mensaje, se agendó una cita, pidió hablar con una persona. Firmados, con reintentos y con registro.

    Ver los avisos
  • Entrada por aviso

    Un flujo con su propia dirección: tu formulario o tu tienda le envía los datos y el flujo arranca para ese cliente, sin clave de acceso.

    Llega pronto

¿Cuál elijo?

Quiero… Usa
Que mi tienda confirme cada pedido por WhatsApp La API: POST /messages con una plantilla, o POST /flows/{id}/runs para lanzar un flujo
Que mi formulario cree al cliente y le escriba La API: POST /contacts con actions, o POST /flows/{id}/runs con contact
Copiar mis contactos a otro CRM La API: GET /contacts?updated_since=… y el aviso contact.deleted
Enterarme en Zapier o Make de cada mensaje, etiqueta o cita Los avisos: suscríbete a message.received, contact.tag_added, appointment.booked…
Enviar a mi sistema los datos que junta un flujo La acción «Enviar a un webhook» del flujo (llega como el aviso flow.webhook)

Lo básico

  • Dirección: todas las operaciones cuelgan de https://panel.adsmartbot.com/api/v1.
  • Clave de acceso: créala en Configuración → Integraciones → API y avisos y envíala en cada petición en la cabecera Authorization. Se ve una sola vez. Crea una por sistema: así sabes quién hizo qué y puedes cortar uno sin afectar a los demás.
  • Permisos: cada clave lleva solo lo que necesita. Al crearla eliges para qué es: «Tienda: confirmar pedidos», «Formulario», «Zapier, Make o n8n», «Solo leer», «Acceso total» o «A la medida».
  • Formato: JSON; fechas en ISO 8601 con zona horaria; teléfonos con el indicativo del país.
  • Límites: 120 peticiones por minuto por clave y 300 por cuenta. Ver todos los límites.
  • Errores claros: cada error trae un código estable, un mensaje en español y un enlace a qué hacer. Ver los errores.
Prueba tu clave
curl https://panel.adsmartbot.com/api/v1/me \
  -H "Authorization: Bearer $CLAVE_API"

Con Zapier, Make o n8n

  • Para escribir (crear contactos, enviar plantillas, lanzar flujos): usa su módulo de peticiones HTTP («Webhooks by Zapier», el módulo HTTP de Make o el nodo HTTP Request de n8n) con tu clave en la cabecera Authorization.
  • Para reaccionar a lo que pasa aquí: crea en tu escenario una dirección que reciba avisos («Catch Hook» en Zapier, «Custom webhook» en Make, el nodo Webhook de n8n) y agrégala en Configuración → Integraciones → API y avisos → Avisos a otros sistemas.
  • Importa la especificación en Postman o n8n desde https://panel.adsmartbot.com/api/v1/openapi.json, o la colección lista para Postman desde https://panel.adsmartbot.com/api/v1/postman.json (tu clave va en la variable clave_api).

Sigue por aquí