Borrar una audiencia

Edición

delete_audience

Borra una audiencia del perfil de marca por su id de list_audiences y la quita de los productos que la tenían asociada. Los productos no se borran. Sin confirm devuelve la vista previa con los productos afectados; muéstrale esa vista previa al usuario antes de borrar.

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

Nombre	Tipo	Obligatorio	Descripción
`audience_id`	texto	Sí	id de la audiencia a borrar.
`confirm`	booleano	No	false 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": "delete_audience",
    "arguments": {
      "audience_id": "<audience_id>"
    }
  }
}

Ejemplo de vista previa

Sin confirm, con {"audience_id":"aud_conductores"}, 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,
  "audience": {
    "id": "aud_conductores",
    "name": "Conductores urbanos"
  },
  "affected": {
    "products": [
      {
        "id": "prd_auto",
        "name": "Seguro de auto por kilómetro"
      }
    ]
  },
  "notes": "Vista previa: no se guardó nada. Muéstrale el cambio al usuario y repite la llamada con confirm: true para hacerlo."
}