Automatizaciones

Una automatización vigila los comentarios de una cuenta y, cuando alguien escribe una palabra clave, le contesta por ti: con un mensaje privado (Instagram y Facebook), en público o las dos cosas. Quien comente “precio” recibe el enlace en segundos, aunque sea de madrugada.

Crear una

curl -X POST "https://api.marsial.dev/v1/automations" \
  -H "Authorization: Bearer $MARSIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_3k9x2m",
    "name": "Enlace de precios",
    "keywords": [
      "precio",
      "info"
    ],
    "matchMode": "word",
    "dmMessage": "¡Hola! Aquí tienes los precios 👇",
    "buttons": [
      {
        "type": "url",
        "title": "Ver precios",
        "url": "https://acme.com/precios"
      }
    ],
    "commentReply": "¡Te lo hemos mandado por privado!"
  }'

const res = await fetch('https://api.marsial.dev/v1/automations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "accountId": "acc_3k9x2m",
    "name": "Enlace de precios",
    "keywords": [
      "precio",
      "info"
    ],
    "matchMode": "word",
    "dmMessage": "¡Hola! Aquí tienes los precios 👇",
    "buttons": [
      {
        "type": "url",
        "title": "Ver precios",
        "url": "https://acme.com/precios"
      }
    ],
    "commentReply": "¡Te lo hemos mandado por privado!"
  }),
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.marsial.dev/v1/automations",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
    json={
        "accountId": "acc_3k9x2m",
        "name": "Enlace de precios",
        "keywords": [
            "precio",
            "info"
        ],
        "matchMode": "word",
        "dmMessage": "¡Hola! Aquí tienes los precios 👇",
        "buttons": [
            {
                "type": "url",
                "title": "Ver precios",
                "url": "https://acme.com/precios"
            }
        ],
        "commentReply": "¡Te lo hemos mandado por privado!"
    },
)
data = res.json()["data"]

Qué se puede hacer en cada red

Red	Mensaje privado	Respuesta pública
Instagram	Sí, y respuestas a historias	Sí
Facebook	Sí	Sí
TikTok, Threads, LinkedIn y YouTube	No	Sí (obligatoria)

keywords: las palabras que la activan. Vacío: cualquier comentario.
matchMode: contains (contiene la palabra, también dentro de otras), word (la palabra suelta) o exact (el comentario entero).
postId: solo en una publicación de Marsial. Para una publicada fuera de Marsial, inboxPostId (el id de la bandeja). Sin ninguno, vigila todas.
dmMessage y buttons: el mensaje privado y, opcionalmente, botones con enlace.
commentReply: la respuesta pública bajo el comentario.
repeat: once manda un mensaje por persona; every_comment, uno por comentario.
trigger: "story_reply" (Instagram): contesta por privado a quien responde a una historia, en vez de a comentarios.
likeComment y hideComment: además, dar me gusta al comentario u ocultarlo.

Ver qué ha hecho

Cada automatización trae sus contadores en stats (activaciones, mensajes enviados y fallidos, clics), y su historial dice qué comentario la activó y si el mensaje llegó:

curl "https://api.marsial.dev/v1/automations/aut_6r3e9w/logs" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

const res = await fetch('https://api.marsial.dev/v1/automations/aut_6r3e9w/logs', {
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.marsial.dev/v1/automations/aut_6r3e9w/logs",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Para pausarla, PATCH con active: false; para borrarla, DELETE.