Anuncios (Click-to-WhatsApp)

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

Base path: /organizations/:orgId/ad-campaigns·2 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

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"
}

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

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"
}