Mosend
MosendDeveloper

Anuncios (Click-to-WhatsApp)

Referencia de 3 endpoints generados desde mosend-wb-backend/src/modules/ad-campaigns/ad-campaigns.controller.ts.

Base path: /organizations/:orgId/ad-campaigns·3 endpoints·Source: mosend-wb-backend/src/modules/ad-campaigns/ad-campaigns.controller.ts
GET/organizations/:orgId/ad-campaigns
bearer

No se crean a mano: aparecen solos cuando llega el primer mensaje de ese anuncio, con el titular, el texto y la media que manda Meta.

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/ad-campaigns' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/ad-campaigns/:id/por-seguir
bearer

La ventana gratis es la de Meta: si se le responde en las primeras 24 h, ningún mensaje se cobra durante 72 h desde esa respuesta, o hasta 7 días en las cuentas a las que Meta ya les activó la ventana nueva (se detecta por cuenta en sus propios mensajes). Las ventas de cada anuncio están en el reporte de Ventas (`reports/ventas?anuncioId=`).

Path params

  • orgIdstringrequerido
  • idstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/ad-campaigns/00000000-0000-0000-0000-000000000000/por-seguir' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
PATCH/organizations/:orgId/ad-campaigns/:id
bearer

Dice qué significa un anuncio: qué vende, quién atiende, qué etiqueta.

Path params

  • orgIdstringrequerido
  • idstringrequerido

Body (JSON)

  • queOfrecestring

    En una línea: qué se vende en ese anuncio. Lo lee el bot.

  • productIdsstring[]

    Productos del catálogo que corresponden a este anuncio.

  • botAgentIdstring

    Agente del bot que atiende a quien llega por aquí. Vacío = el de siempre.

  • tagIdstring

    Etiqueta para el contacto: con ella entran el ruteo y la lista de precios.

  • mensajeInicialstring

    Primer mensaje exacto, si se prefiere abrir con uno propio.

  • activoboolean

    false = el bot deja de recibir el contexto de este anuncio.

Respuestas

  • 200
curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/ad-campaigns/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"queOfrece": "<queOfrece>","productIds": [],"botAgentId": "00000000-0000-0000-0000-000000000000","tagId": "00000000-0000-0000-0000-000000000000","mensajeInicial": "<mensajeInicial>","activo": true}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}