# Crear o editar una audiencia

`save_audience`

Crea una audiencia del perfil de marca, o edita una existente por su id (de get_brand_profile). Para crear, name es obligatorio. Solo cambia los campos enviados. Sin confirm devuelve la vista previa.

**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.

Qué va en cada campo y cuáles son clave: [Perfil de marca](https://docs.bisonagents.com/mcp/perfil-de-marca/).

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `audience_id` | texto | No | id de la audiencia a editar; omítelo para crear una. |
| `name` | texto (hasta 200 caracteres) | No | Nombre del segmento, por ejemplo «Jefes de RR. HH. en pymes». Obligatorio al crear. |
| `role` | texto (hasta 200 caracteres) | No | Cargo o rol de quien decide la compra. |
| `proof_type` | una de `CERTIFICATIONS`, `TESTIMONIALS`, `DATA`, `GUARANTEES`, `NONE` | No | Qué prueba necesita para creer en la promesa. Una de: CERTIFICATIONS (Certificaciones técnicas), TESTIMONIALS (Testimonios de pares), DATA (Datos científicos), GUARANTEES (Garantías de satisfacción), NONE (No necesita pruebas). Clave: sin este dato Bison no puede dar algunas recomendaciones. |
| `knowledge_level` | entero (1 a 5) | No | Cuánto sabe de la categoría: 1 Inicial, 2 Básico, 3 Intermedio, 4 Avanzado, 5 Experto; 3 si no se indica. |
| `pains` | texto (hasta 2000 caracteres) | No | Problemas o dolores que tiene. |
| `desire` | texto (hasta 2000 caracteres) | No | Qué quiere lograr. |
| `trigger` | una de `PRICE`, `QUALITY`, `INNOVATION`, `TRUST`, `SPEED`, `CONVENIENCE`, `ROI`, `SUPPORT`, `STATUS`, `ECO`, `SECURITY`, `CUSTOMIZATION` | No | Por qué te elige en lugar de otras alternativas. Una de: PRICE (Precio), QUALITY (Calidad / Durabilidad), INNOVATION (Innovación), TRUST (Confianza / Reputación), SPEED (Rapidez), CONVENIENCE (Comodidad / Facilidad de uso), ROI (Retorno de Inversión / Rentabilidad), SUPPORT (Soporte / Atención al cliente), STATUS (Exclusividad / Estatus), ECO (Sostenibilidad / Impacto social), SECURITY (Seguridad / Privacidad), CUSTOMIZATION (Personalización / Flexibilidad). |
| `barriers` | texto (hasta 2000 caracteres) | No | Qué lo frena para comprar. |
| `objections` | texto (hasta 2000 caracteres) | No | Objeciones típicas. |
| `alternatives` | texto (hasta 2000 caracteres) | No | Qué usa hoy en lugar de la marca. |
| `tone` | una de `EMPATHETIC`, `PROFESSIONAL`, `INSPIRATIONAL`, `DIRECT` | No | Tono con el que conviene hablarle. Uno de: EMPATHETIC (Empático), PROFESSIONAL (Profesional), INSPIRATIONAL (Inspiracional), DIRECT (Directo). |
| `cta` | texto (hasta 500 caracteres) | No | Llamado a la acción: el siguiente paso concreto que quieres que dé esta audiencia, escrito como lo dirías en un botón o enlace, por ejemplo «Agendar demo». |
| `confirm` | booleano | No | false u omitido: solo devuelve la vista previa (antes y 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": "save_audience",
    "arguments": {
      "name": "<name>"
    }
  }
}
```

## Ejemplo de vista previa

Sin `confirm`, con `{"name":"Familias con dos autos","tone":"EMPATHETIC","proof_type":"GUARANTEES","cta":"Cotizar en 2 minutos"}`, no guarda nada y devuelve esto, para una marca ficticia («Altavista Seguros»). Para guardar, repite la llamada con `confirm: true`.

```json
{
  "saved": false,
  "changed": true,
  "id": null,
  "created": true,
  "changes": {
    "name": {
      "before": null,
      "after": "Familias con dos autos"
    },
    "proof_type": {
      "before": null,
      "after": "GUARANTEES"
    },
    "tone": {
      "before": null,
      "after": "EMPATHETIC"
    },
    "cta": {
      "before": null,
      "after": "Cotizar en 2 minutos"
    }
  },
  "notes": "Vista previa: no se guardó nada. Muéstrale el cambio al usuario y repite la llamada con confirm: true para guardarlo."
}
```