Asociar audiencias a un producto

Edición

link_product_audiences

Asocia o desasocia audiencias de un producto, que es el paso 3 de la carga de una tarjeta de oferta. Envía en add los ids de las audiencias que se suman y en remove los que se quitan; las demás audiencias del producto quedan igual y un id ya asociado no se repite. Los ids salen de list_audiences y list_products. Sin confirm devuelve la vista previa con las audiencias antes y después.

Permiso: Edición. Requiere un token de «Lectura y edición».

Cambia datos

Modifica información de tu empresa en Bison. Tu agente debería pedirte confirmación antes de usarla.

Parámetros

NombreTipoObligatorioDescripción
product_idtextoSíid del producto.
addlista de hasta 50 elementosNoids de las audiencias que se asocian al producto.
removelista de hasta 50 elementosNoids de las audiencias que se desasocian del producto.
confirmbooleanoNofalse u omitido: solo devuelve la vista previa, con el antes y el después, sin guardar. true: guarda.

Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "link_product_audiences",
    "arguments": {
      "product_id": "<product_id>"
    }
  }
}

Ejemplo de vista previa

Sin confirm, con {"product_id":"prd_auto","add":["aud_familias"]}, no guarda nada y devuelve esto, para la marca ficticia «Altavista Seguros». Para guardar, repite la llamada con confirm: true.

json
{
  "saved": false,
  "changed": true,
  "product": {
    "id": "prd_auto",
    "name": "Seguro de auto por kilómetro"
  },
  "audiences_before": [
    {
      "id": "aud_conductores",
      "name": "Conductores urbanos"
    }
  ],
  "audiences_after": [
    {
      "id": "aud_conductores",
      "name": "Conductores urbanos"
    },
    {
      "id": "aud_familias",
      "name": "Familias con un solo auto"
    }
  ],
  "added": [
    "aud_familias"
  ],
  "notes": "Vista previa: no se guardó nada. Muéstrale el cambio al usuario y repite la llamada con confirm: true para hacerlo."
}