API Automatizaciones (beta) (1.0)

Download OpenAPI specification:Download

INTRODUCCION

Una automatización es un recorrido que usted dibuja en su panel con bloques unidos por flechas: enviar un mensaje, esperar, decidir según lo que haya pasado, avisar a su equipo. Las automatizaciones que empiezan con el bloque ENTRADA API tienen una dirección propia en internet, su dirección de entrada. Cada vez que su programa hace una petición a esa dirección se pone en marcha una ejecución: el recorrido de una persona por la automatización, con los datos que usted envía en la petición (su móvil, su nombre, la fecha de su cita…).



Sirve para que su programa de citas, su tienda o su sistema de gestión avisen de que ha pasado algo (una cita nueva, un pedido, un recibo sin pagar) y, desde ahí, todo ocurra solo.



Con esta API su programa puede:
- Poner en marcha una ejecución: automatizacion/{TOKEN}.
- Saber cómo acaba: recibir un aviso cuando termina (apartado Aviso al terminar) o preguntarlo con AutomatizacionEjecucion y AutomatizacionEjecuciones.
- Parar una ejecución que sigue en marcha: AutomatizacionCancelar.
- Ver qué automatizaciones tiene, con la dirección de entrada y los datos que pide cada una: AutomatizacionListar.



Lo que la automatización hace (qué envía, cuánto espera, por dónde sigue) se decide en el dibujo, en su panel. Allí se sigue también cada ejecución, en Ver ejecuciones.



Automatizaciones está en fase beta. Mientras dure, cada cuenta tiene un tope de ejecuciones al día: está en el apartado Límites.

ANTES DE EMPEZAR


1. En su panel, en Automatizaciones, cree una automatización que empiece con el bloque ENTRADA API. En ese bloque se declaran los datos que va a enviar su programa: el nombre de cada uno, su tipo y si es obligatorio.
2. Publíquela. Mientras no esté publicada y activa, su dirección contesta -6 y no arranca nada.
3. Copie su dirección con el botón URL de entrada, que está en el editor y en la lista de automatizaciones. Tiene esta forma: https://api.mensatek.com/automatizacion/k7Tq2mXw9LbR4zP. Cada automatización tiene la suya, y no cambia aunque cambie el dibujo.
4. Su programa hace una petición POST a esa dirección cada vez que quiera poner en marcha una ejecución.

LOS DATOS DE CADA EJECUCION

Los datos viajan en el parámetro VARIABLES: un objeto JSON con un valor por cada dato declarado en el bloque ENTRADA API.

{"movil":"34600000001","nombre":"Lucía","fecha_cita":"2026-11-24 17:00"}

Si su programa envía el cuerpo de la petición en JSON, VARIABLES es ese objeto, tal cual. Si lo envía como formulario, es el mismo objeto escrito como texto.



Cada dato se comprueba según el tipo que tenga en el bloque:

TipoQué se admite
MóvilEl número con el prefijo del país: 34600000001. Tiene que tener entre 9 y 15 cifras; los espacios, los guiones y el signo + no cuentan.
EmailUna dirección de correo bien escrita.
NúmeroUn número. Los decimales, con punto: 12.5.
FechaUna fecha, con hora o sin ella: 2026-11-24 17:00. Se entiende en hora peninsular española.
TextoCualquier texto.


- Si falta un dato obligatorio, o uno no vale para su tipo (un móvil con letras), la ejecución no arranca: la respuesta es -3 y Error dice qué dato es.
- Los datos que envíe y no estén declarados en el bloque se ignoran.
- Los nombres de los datos no distinguen mayúsculas de minúsculas.
- Cada valor es un texto o un número. Un objeto o una lista como valor se ignora.
- Cada valor admite hasta 2.000 bytes; lo que pase de ahí se corta. Enviado como texto, el parámetro entero admite hasta 65.000.

REINTENTOS SIN DUPLICADOS

Si su programa no recibe la respuesta (un corte de red, un tiempo de espera agotado) no sabe si la automatización arrancó. Si repite la llamada sin más, la persona puede recibir el mensaje dos veces. Con el parámetro REFERENCIA puede repetirla sin miedo.



- Envíe con cada petición un identificador suyo: cita-88213, PED-2026/0412. De 1 a 50 letras y números; también valen . _ - : @ / + = #. Sin espacios ni acentos.
- Si la misma referencia vuelve a llegar para la misma automatización en 24 horas, no se crea otra ejecución. La respuesta trae la que ya se creó y lo avisa con "Repetida":1.
- Cuenta la referencia, no los datos. Si repite la referencia con otras variables, se sigue contestando con la primera ejecución. Para una petición distinta, otra referencia.
- Distingue mayúsculas: Cita-1 y cita-1 son dos referencias.
- Si la primera llamada no llegó a arrancar (contestó -3, -6 o -7), la referencia sigue libre: corrija y repita con la misma.
- Si dos peticiones con la misma referencia llegan a la vez, solo arranca una. La otra recibe la ejecución de la primera o, si todavía no existe, un -7 para que lo intente de nuevo a los pocos segundos.
- En su panel, la ejecución enseña su referencia en «Origen», y el buscador de Ver ejecuciones la encuentra escribiéndola entera.
- Pasadas las 24 horas, la misma referencia arranca una ejecución nueva. Para que una persona no pase dos veces por la automatización en varios días, use en el dibujo el bloque SOLO UNA VEZ.

SABER COMO ACABA UNA EJECUCION

Poner en marcha una ejecución devuelve su número (idEjecucion) y nada más: el recorrido puede durar minutos o días. Para saber cómo acaba hay dos caminos, y se pueden usar los dos.



- Que se lo digamos nosotros. En su panel, en Automatizaciones → Avisar a tu sistema, escriba una dirección de su servidor. Cuando termina cada ejecución la llamamos con el resultado y los datos. Es lo recomendable: su programa no tiene que preguntar. Está en el apartado siguiente.
- Preguntarlo. AutomatizacionEjecucion devuelve una ejecución, por su número o por la REFERENCIA con la que la arrancó; AutomatizacionEjecuciones, las de un periodo. Sirve para comprobar una en concreto, para ponerse al día después de una parada de su servidor o si no puede recibir llamadas.



Los dos caminos dan los mismos datos, con los mismos nombres. Lo que llega en el aviso es lo que devuelve AutomatizacionEjecucion.



Cada ejecución tiene un estado:

estadoQué quiere decir
activaEstá dando pasos ahora mismo.
esperandoSigue en marcha, parada en una espera. espera dice en cuál: tiempo (un plazo), estado (el resultado de un envío), respuesta (que la persona conteste), llamada o agente (que la atienda una persona de su equipo).
completadaHa llegado a un bloque FIN. resultado es el nombre que usted le puso a ese FIN: «cita confirmada».
errorHa terminado por un fallo. resultado trae el motivo.
canceladaSe paró: desde su panel, con AutomatizacionCancelar, o porque pasó a atenderla una persona de su equipo.
expiradaSe cortó al publicar una versión nueva de la automatización, o llevaba 35 días parada.

AVISO AL TERMINAR

Se activa en su panel, en Automatizaciones → Avisar a tu sistema: la dirección de su servidor (https y pública) y de qué avisar, de todas las ejecuciones que terminan o solo de las que terminan con error. Vale para todas las automatizaciones de la cuenta. El botón Enviar una prueba le manda un aviso de ejemplo.



Su servidor recibe una petición POST con este JSON:

{
  "evento": "automatizacion.terminada",
  "fecha": "2026-11-24T17:05:12+01:00",
  "automatizacion": { "id": 412, "nombre": "Recordatorio de cita", "version": 3 },
  "ejecucion": {
    "id": 2539,
    "estado": "completada",
    "resultado": "cita confirmada",
    "inicio": "2026-11-23T17:00:03+01:00",
    "fin": "2026-11-24T17:05:12+01:00",
    "origen": "api",
    "referencia": "cita-88213",
    "contacto": "34600000001",
    "prueba": false
  },
  "variables": { "movil": "34600000001", "nombre": "Lucía", "fecha_cita": "2026-11-24 17:00", "respuesta": "SI" },
  "envios": [ { "bloque": 2, "canal": "sms", "id": "88120045", "estado": "entregado" } ]
}


- ejecucion.referencia es la REFERENCIA con la que usted arrancó la ejecución: con ella la reconoce su programa.
- ejecucion.origen dice cómo empezó: api, envio, mensaje, llamada, programada, evento, chat, flujo (la lanzó otra automatización) o prueba.
- ejecucion.prueba es true en las pruebas reales lanzadas desde el editor y en «Enviar una prueba».
- variables son las de la ejecución al terminar, como texto: las que envió al arrancar y las que han dejado los bloques (lo que contestó la persona, por ejemplo). Hasta 100, de 2.000 caracteres cada una como mucho.
- envios son los envíos que ha hecho, con el número del bloque, el canal, su identificador y su último estado conocido: entregado, leido, error o transitorio (todavía en camino).



Compruebe que el aviso es nuestro. Cada aviso va firmado con la clave de firma de su cuenta, que está en esa misma ventana del panel, en Ver la clave de firma. Llegan dos cabeceras:



- X-Firma, por ejemplo t=1795536312,v1=5f2c…. t es la hora del aviso, en segundos. v1 es la firma: el HMAC-SHA256, en hexadecimal, del texto formado por t, un punto y el cuerpo de la petición tal como llega, con su clave. Calcúlela usted y compárela. Rechace los avisos con una hora de hace más de 5 minutos.
- X-Aviso, el número del aviso. Es el mismo en los reintentos: si ya lo tiene apuntado, conteste que bien y no lo repita.



Qué tiene que contestar su servidor. Cualquier respuesta 2xx en menos de 8 segundos; lo que traiga la respuesta no se mira. Si contesta otra cosa, o no contesta, lo volvemos a intentar: tras 1 minuto, tras 10 minutos más y tras 1 hora más. Cuatro intentos en total. Las redirecciones no se siguen. Los avisos pueden llegar desordenados y, alguna vez, repetidos.



Avisar no tiene coste.

LIMITES

LímiteCuánto
Arranques por la dirección de entrada60 por minuto y cuenta. Para cargas grandes, reparta los arranques.
Ejecuciones al día1.000 por cuenta mientras Automatizaciones esté en fase beta. Cuentan todas las que empiezan ese día, por cualquier vía. Al llegar, no arrancan más hasta el día siguiente; las que ya estaban en marcha siguen. Si necesita más, pídalo a soporte.
Ejecuciones en marcha a la vezHay un máximo por cuenta. Si se alcanza, espere a que terminen algunas.
Consultas (AutomatizacionListar, AutomatizacionEjecucion, AutomatizacionEjecuciones y AutomatizacionCancelar)120 por minuto y cuenta, entre las cuatro.
Lista de ejecucionesComo mucho 31 días por consulta y 200 ejecuciones por respuesta.
Aviso al terminarEsperamos a su servidor 8 segundos. Cuatro intentos por aviso.


Al llegar a cualquiera de ellos la respuesta es -7 y Error dice cuál. Espere y repita la llamada.



La petición contesta cuando la ejecución llega a su primera espera o a su final, no antes. Puede tardar unos segundos: no ponga a su programa un tiempo de espera corto y, por si se agota, envíe siempre REFERENCIA.

AUTENTICACION

Igual que el resto de nuestras APIs: autenticación Basic con su usuario y su API Token, que encontrará en su panel en Sus datos → Configurar → Seguridad. Recuerde autorizar ahí también la IP pública desde la que llamará.



El usuario con el que se identifica tiene que ser de la misma cuenta que la automatización. Si no, la respuesta es -2.

Poner en marcha una automatización

/automatizacion/{TOKEN}

Pone en marcha una ejecución de la automatización a la que pertenece la dirección, con los datos de VARIABLES. La automatización tiene que empezar con el bloque ENTRADA API y estar publicada y activa.



Los tres parámetros son opcionales y van en el cuerpo de la petición. Lo habitual es enviar VARIABLES y REFERENCIA:

curl -u "UsuarioAPI:APIToken" \
  --data-urlencode 'VARIABLES={"movil":"34600000001","nombre":"Lucía","fecha_cita":"2026-11-24 17:00"}' \
  --data-urlencode 'REFERENCIA=cita-88213' \
  https://api.mensatek.com/automatizacion/k7Tq2mXw9LbR4zP

Si su programa envía el cuerpo en JSON, VARIABLES va como objeto:

curl -u "UsuarioAPI:APIToken" \
  -H 'Content-Type: application/json' \
  -d '{"VARIABLES":{"movil":"34600000001","nombre":"Lucía","fecha_cita":"2026-11-24 17:00"},"REFERENCIA":"cita-88213"}' \
  https://api.mensatek.com/automatizacion/k7Tq2mXw9LbR4zP

La respuesta, en JSON:

{"Res":1,"idEjecucion":2539}

Si esa REFERENCIA ya había puesto en marcha la ejecución en las últimas 24 horas, no se crea otra y la respuesta lo dice:

{"Res":1,"idEjecucion":2539,"Repetida":1}

Si no ha podido arrancar, Res es negativo y Error trae el motivo, en inglés:

{"Res":-3,"Error":"Missing required variable: movil"}

Los códigos de Res están en la respuesta, más abajo.

Authorizations:
basicAuth
path Parameters
TOKEN
required
string
Example: k7Tq2mXw9LbR4zP

La parte final de la dirección de entrada de su automatización. No hay que escribirla ni enviarla aparte: copie la dirección completa con el botón URL de entrada de su panel.

query Parameters
Variables
object
Example: Variables={"movil":"34600000001","nombre":"Lucía","fecha_cita":"2026-11-24 17:00"}

Los datos de esta ejecución: un objeto JSON con un valor por cada dato declarado en el bloque ENTRADA API de la automatización. Los obligatorios tienen que venir todos; los que no estén declarados se ignoran.

Cómo se envía. Si el cuerpo de la petición va en JSON, el objeto tal cual: "VARIABLES":{"movil":"34600000001"}. Si va como formulario, el mismo objeto escrito como texto. Escrito como texto vale también dentro de un cuerpo JSON.

También se admite como lista de pares Nombre y Valor: [{"Nombre":"movil","Valor":"34600000001"},{"Nombre":"nombre","Valor":"Lucía"}].

Las fechas, en hora peninsular española. Los móviles, con el prefijo del país.

Referencia
string
Example: Referencia=cita-88213

Un identificador suyo de esta petición, como el número de la cita o del pedido. Opcional. Sirve para que un reintento no arranque dos veces: la misma referencia para la misma automatización en 24 horas no crea otra ejecución, y la respuesta trae la que ya se creó con "Repetida":1.

De 1 a 50 letras y números; también valen . _ - : @ / + = #. Sin espacios ni acentos. Distingue mayúsculas de minúsculas. Si no vale, la respuesta es -3.

Resp
string
Enum: "TXT" "JSON" "XML"
Example: Resp=JSON

Formato de la respuesta.
JSON - La respuesta la obtendrá en JSON
XML - La respuesta la obtendrá en XML
TXT - La respuesta la obtendrá en formato Texto

Request Body schema:

Los parámetros se envían en el cuerpo de la petición POST, como objeto JSON (Content-Type application/json, RECOMENDADO) o como formulario application/x-www-form-urlencoded. En el formato formulario, los parámetros de tipo array u objeto se envían como string JSON-codificado. Los nombres de los parámetros no distinguen mayúsculas de minúsculas. La descripción detallada de cada parámetro está en la sección de parámetros de esta operación.

Variables
object
Referencia
string
Resp
string

Responses

Response Schema:
Res
required
integer <int32>

Resultado de la llamada.

ResQué quiere decir
1Ejecución creada. idEjecucion es su número. Si llega además "Repetida":1, esa REFERENCIA ya había puesto en marcha esa ejecución y no se ha creado otra.
-1Usuario o token incorrectos, o la petición viene de una dirección no autorizada en la seguridad de su cuenta.
-2La dirección no es de una automatización de esa cuenta.
-3Falta una variable obligatoria o no vale para su tipo, o la REFERENCIA lleva algo que no admite. Error dice cuál.
-6La automatización no está activa o no se ha publicado.
-7Ha llegado a un límite: más de 60 arranques por minuto, demasiadas ejecuciones en marcha o el tope diario de la fase beta. También si en ese mismo instante hay otra petición con la misma REFERENCIA arrancando. Error dice cuál. Espere y repita la llamada.
idEjecucion
integer

Número de la ejecución. Llega cuando Res es 1.

Repetida
integer

Llega, con valor 1, solo cuando esa REFERENCIA ya había puesto en marcha la ejecución en las últimas 24 horas: no se ha creado otra e idEjecucion es la de entonces.

Error
string

El motivo, en inglés, cuando Res es negativo.

Request samples

Content type
Example
{
  • "Variables": {
    },
  • "Referencia": "cita-88213"
}

Response samples

Content type
Example
{
  • "Res": 1,
  • "idEjecucion": 2539
}

Automatizaciones de la cuenta

/v7/AutomatizacionListar

Devuelve las automatizaciones de su cuenta, de la más nueva a la más vieja. De las que empiezan con el bloque ENTRADA API y están publicadas trae además su dirección de entrada y los datos que piden: lo que su programa necesita para ponerlas en marcha.



Los parámetros pueden ir en la dirección o en el cuerpo de la petición:

curl -u "UsuarioAPI:APIToken" "https://api.mensatek.com/v7/AutomatizacionListar?ESTADO=activo"

De cada automatización llega:

idSu número. Es el que pide IDAUTOMATIZACION en las otras funciones.
nombreEl nombre que tiene en su panel.
estadoactivo, pausado (no arranca ejecuciones nuevas; las que estaban en marcha siguen) o borrador.
empiezaCómo se pone en marcha: api (desde su programa), envio, mensaje, llamada, programada, evento o chat.
versionLa versión publicada. 0 si todavía no se ha publicado.
modificada, publicadaCuándo se cambió y cuándo se publicó por última vez.
urlSu dirección de entrada. Solo en las que empiezan por api y están publicadas.
variablesLos datos que pide, en las mismas: de cada uno, nombre, tipo (movil, email, numero, fecha o texto) y obligatoria.
Authorizations:
basicAuth
query Parameters
Estado
string
Example: Estado=activo

Opcional. Solo las de ese estado: activo, pausado o borrador. Sin él, todas.

Resp
string
Enum: "TXT" "JSON" "XML"
Example: Resp=JSON

Formato de la respuesta. Por defecto, JSON.
JSON - La respuesta la obtendrá en JSON
XML - La respuesta la obtendrá en XML. Las listas salen como item0, item1… y los sí/no como 1 y 0
TXT - La respuesta la obtendrá en formato Texto

Request Body schema:

Los parámetros se envían en el cuerpo de la petición POST, como objeto JSON (Content-Type application/json, RECOMENDADO) o como formulario application/x-www-form-urlencoded. En el formato formulario, los parámetros de tipo array u objeto se envían como string JSON-codificado. Los nombres de los parámetros no distinguen mayúsculas de minúsculas. La descripción detallada de cada parámetro está en la sección de parámetros de esta operación.

Estado
string
Resp
string

Responses

Response Schema: application/json
Res
required
integer <int32>

Resultado de la llamada.

ResQué quiere decir
1Correcto.
-1Usuario o token incorrectos, o la petición viene de una dirección no autorizada en la seguridad de su cuenta.
-2Esa ejecución no existe o no es de su cuenta.
-3Un parámetro no vale. Error dice cuál.
-6Al cancelar: la ejecución ya había terminado.
-7Más de 120 consultas en un minuto. Error dice cuántos segundos faltan.
total
integer

Cuántas automatizaciones trae la respuesta.

automatizaciones
Array of arrays

Las automatizaciones. Lo que llega de cada una está en la descripción de la función.

Error
string

El motivo, en inglés, cuando Res es negativo.

Request samples

Content type
{
  • "Estado": "activo"
}

Response samples

Content type
application/json
Example
{
  • "Res": 1,
  • "total": 2,
  • "automatizaciones": [
    ]
}

Consultar una ejecución

/v7/AutomatizacionEjecucion

Devuelve cómo va, o cómo acabó, una ejecución. Se busca de una de estas dos formas:



- Por su número, con IDEJECUCION: el idEjecucion que devolvió la dirección de entrada.
- Por la REFERENCIA con la que la arrancó. Si su programa no llegó a recibir el número (un corte de red), así la encuentra. Si varias ejecuciones llevan esa referencia, llega la más reciente; con IDAUTOMATIZACION se busca solo en esa automatización.

curl -u "UsuarioAPI:APIToken" "https://api.mensatek.com/v7/AutomatizacionEjecucion?IDEJECUCION=2539"
curl -u "UsuarioAPI:APIToken" "https://api.mensatek.com/v7/AutomatizacionEjecucion?REFERENCIA=cita-88213"

La respuesta trae lo mismo que el aviso al terminar, con los mismos nombres (automatizacion, ejecucion, variables y envios), y dos datos más en ejecucion para las que siguen en marcha: bloque, el número del bloque en el que está, y espera, en qué está parada. Los estados están en el apartado Saber cómo acaba una ejecución.



Con PASOS=1 llega además pasos, el camino que ha seguido: de cada paso, el número del bloque, su tipo, la salida por la que siguió (ok, entregado, respuesta, timeout…; espera o esperando cuando se quedó parada, fin en un bloque FIN) y su fecha.

Authorizations:
basicAuth
query Parameters
Idejecucion
integer
Example: Idejecucion=2539

El número de la ejecución. Hay que enviar este parámetro o REFERENCIA.

Referencia
string
Example: Referencia=cita-88213

La REFERENCIA con la que su programa arrancó la ejecución. Distingue mayúsculas de minúsculas. Si se envía IDEJECUCION, no se usa.

Idautomatizacion
integer
Example: Idautomatizacion=412

Opcional, con REFERENCIA: el número de la automatización en la que buscar.

Pasos
integer
Example: Pasos=1

Opcional. Con 1, la respuesta trae también el camino que ha seguido la ejecución.

Resp
string
Enum: "TXT" "JSON" "XML"
Example: Resp=JSON

Formato de la respuesta. Por defecto, JSON.
JSON - La respuesta la obtendrá en JSON
XML - La respuesta la obtendrá en XML. Las listas salen como item0, item1… y los sí/no como 1 y 0
TXT - La respuesta la obtendrá en formato Texto

Request Body schema:

Los parámetros se envían en el cuerpo de la petición POST, como objeto JSON (Content-Type application/json, RECOMENDADO) o como formulario application/x-www-form-urlencoded. En el formato formulario, los parámetros de tipo array u objeto se envían como string JSON-codificado. Los nombres de los parámetros no distinguen mayúsculas de minúsculas. La descripción detallada de cada parámetro está en la sección de parámetros de esta operación.

Idejecucion
integer
Referencia
string
Idautomatizacion
integer
Pasos
integer
Resp
string

Responses

Response Schema: application/json
Res
required
integer <int32>

Resultado de la llamada.

ResQué quiere decir
1Correcto.
-1Usuario o token incorrectos, o la petición viene de una dirección no autorizada en la seguridad de su cuenta.
-2Esa ejecución no existe o no es de su cuenta.
-3Un parámetro no vale. Error dice cuál.
-6Al cancelar: la ejecución ya había terminado.
-7Más de 120 consultas en un minuto. Error dice cuántos segundos faltan.
automatizacion
object

La automatización: su número, su nombre y la versión con la que se hizo esta ejecución.

ejecucion
object

La ejecución: id, estado, resultado, inicio y fin (con su zona horaria; fin vacío si sigue en marcha), origen, referencia, contacto (el móvil o el correo de la persona), prueba, bloque y espera.

variables
object

Las variables de la ejecución, como texto: las que envió al arrancar y las que han ido dejando los bloques. Hasta 100, de 2.000 caracteres cada una como mucho.

envios
Array of arrays

Los envíos que ha hecho: el número del bloque, el canal, su id y su último estado conocido (entregado, leido, error o transitorio).

pasos
Array of arrays

Solo con PASOS=1: el camino que ha seguido.

Error
string

El motivo, en inglés, cuando Res es negativo.

Request samples

Content type
Example
{
  • "idEjecucion": 2539
}

Response samples

Content type
application/json
Example
{
  • "Res": 1,
  • "automatizacion": {
    },
  • "ejecucion": {
    },
  • "variables": {
    },
  • "envios": [
    ]
}

Listar ejecuciones

/v7/AutomatizacionEjecuciones

Devuelve las ejecuciones de su cuenta que empezaron en un periodo, de la más nueva a la más vieja. Sirve para ponerse al día: qué ha terminado desde ayer, cuáles siguen en marcha, cuáles han fallado.

curl -u "UsuarioAPI:APIToken" "https://api.mensatek.com/v7/AutomatizacionEjecuciones?IDAUTOMATIZACION=412&ESTADO=en_marcha"


- Sin DESDE ni HASTA, mira los últimos 7 días. El periodo puede abarcar 31 días como mucho.
- Cada respuesta trae hasta 50 ejecuciones (LIMITE para pedir otra cantidad, 200 como mucho). Si quedan más, mas es true: repita la llamada con ANTESDE igual al siguiente de la respuesta, hasta que mas sea false.
- De cada ejecución llega lo justo: su id, la automatizacion (su número), version, estado, resultado, inicio, fin, origen, referencia, contacto y prueba. Sus variables y sus envíos, con AutomatizacionEjecucion.

Authorizations:
basicAuth
query Parameters
Idautomatizacion
integer
Example: Idautomatizacion=412

Opcional. Solo las ejecuciones de esa automatización.

Estado
string
Example: Estado=en_marcha

Opcional. Solo las de ese estado: activa, esperando, completada, error, cancelada o expirada. Con en_marcha, las que no han terminado (activas y esperando).

Desde
string
Example: Desde=2026-11-17

Opcional. Desde cuándo, en hora peninsular española: 2026-11-17 o 2026-11-17 09:00. Sin él, 7 días antes de HASTA.

Hasta
string
Example: Hasta=2026-11-24

Opcional. Hasta cuándo: 2026-11-24 (el día entero) o 2026-11-24 17:00. Sin él, ahora.

Limite
integer
Example: Limite=50

Opcional. Cuántas ejecuciones por respuesta: de 1 a 200. Sin él, 50.

Antesde
integer
Example: Antesde=2540

Opcional. Para seguir una lista que no ha cabido en una respuesta: el siguiente de la respuesta anterior.

Resp
string
Enum: "TXT" "JSON" "XML"
Example: Resp=JSON

Formato de la respuesta. Por defecto, JSON.
JSON - La respuesta la obtendrá en JSON
XML - La respuesta la obtendrá en XML. Las listas salen como item0, item1… y los sí/no como 1 y 0
TXT - La respuesta la obtendrá en formato Texto

Request Body schema:

Los parámetros se envían en el cuerpo de la petición POST, como objeto JSON (Content-Type application/json, RECOMENDADO) o como formulario application/x-www-form-urlencoded. En el formato formulario, los parámetros de tipo array u objeto se envían como string JSON-codificado. Los nombres de los parámetros no distinguen mayúsculas de minúsculas. La descripción detallada de cada parámetro está en la sección de parámetros de esta operación.

Idautomatizacion
integer
Estado
string
Desde
string
Hasta
string
Limite
integer
Antesde
integer
Resp
string

Responses

Response Schema: application/json
Res
required
integer <int32>

Resultado de la llamada.

ResQué quiere decir
1Correcto.
-1Usuario o token incorrectos, o la petición viene de una dirección no autorizada en la seguridad de su cuenta.
-2Esa ejecución no existe o no es de su cuenta.
-3Un parámetro no vale. Error dice cuál.
-6Al cancelar: la ejecución ya había terminado.
-7Más de 120 consultas en un minuto. Error dice cuántos segundos faltan.
desde
string

El periodo que se ha mirado: desde cuándo.

hasta
string

El periodo que se ha mirado: hasta cuándo.

total
integer

Cuántas ejecuciones trae esta respuesta.

ejecuciones
Array of arrays

Las ejecuciones, de la más nueva a la más vieja.

mas
boolean

true si quedan más ejecuciones del periodo sin enviar.

siguiente
integer

Con mas a true: el valor que hay que enviar en ANTESDE para seguir. Si no quedan más, 0.

Error
string

El motivo, en inglés, cuando Res es negativo.

Request samples

Content type
Example
{
  • "idAutomatizacion": 412,
  • "Desde": "2026-11-17",
  • "Hasta": "2026-11-24"
}

Response samples

Content type
application/json
Example
{
  • "Res": 1,
  • "desde": "2026-11-17T00:00:00+01:00",
  • "hasta": "2026-11-24T23:59:59+01:00",
  • "total": 2,
  • "ejecuciones": [
    ],
  • "mas": false,
  • "siguiente": 0
}

Cancelar una ejecución

/v7/AutomatizacionCancelar

Para una ejecución que sigue en marcha. Hace lo mismo que Cancelar en Ver ejecuciones, en su panel: la ejecución termina como cancelada y no da más pasos. Lo que ya hubiera enviado, enviado está.



Como cambia algo, el parámetro va en el cuerpo de la petición, no en la dirección:

curl -u "UsuarioAPI:APIToken" -d "IDEJECUCION=2540" https://api.mensatek.com/v7/AutomatizacionCancelar


- Si la ejecución ya había terminado, la respuesta es -6 y ejecucion.estado dice cómo acabó. No se toca.
- Si tiene activado el aviso al terminar, el aviso de esa ejecución llega igual, con estado cancelada.

Authorizations:
basicAuth
query Parameters
Idejecucion
required
integer
Example: Idejecucion=2540

El número de la ejecución que hay que parar.

Resp
string
Enum: "TXT" "JSON" "XML"
Example: Resp=JSON

Formato de la respuesta. Por defecto, JSON.
JSON - La respuesta la obtendrá en JSON
XML - La respuesta la obtendrá en XML. Las listas salen como item0, item1… y los sí/no como 1 y 0
TXT - La respuesta la obtendrá en formato Texto

Request Body schema:

Los parámetros se envían en el cuerpo de la petición POST, como objeto JSON (Content-Type application/json, RECOMENDADO) o como formulario application/x-www-form-urlencoded. En el formato formulario, los parámetros de tipo array u objeto se envían como string JSON-codificado. Los nombres de los parámetros no distinguen mayúsculas de minúsculas. La descripción detallada de cada parámetro está en la sección de parámetros de esta operación.

Idejecucion
required
integer
Resp
string

Responses

Response Schema: application/json
Res
required
integer <int32>

Resultado de la llamada.

ResQué quiere decir
1Correcto.
-1Usuario o token incorrectos, o la petición viene de una dirección no autorizada en la seguridad de su cuenta.
-2Esa ejecución no existe o no es de su cuenta.
-3Un parámetro no vale. Error dice cuál.
-6Al cancelar: la ejecución ya había terminado.
-7Más de 120 consultas en un minuto. Error dice cuántos segundos faltan.
ejecucion
object

La ejecución: su id, su estado y, si se ha cancelado ahora, su resultado.

Error
string

El motivo, en inglés, cuando Res es negativo.

Request samples

Content type
{
  • "idEjecucion": 2540
}

Response samples

Content type
application/json
Example
{
  • "Res": 1,
  • "ejecucion": {
    }
}